# Imperium Brand — Agent Operating Guide

> You are reading the machine entry point of the Imperium brand kit. If a human handed you
> this file or the link https://brand.imperiumos.ai and asked "what can I do with
> this", this file IS the answer. Everything referenced is fetchable relative to this file
> (or absolutely at https://brand.imperiumos.ai/<path>), and the entire kit is one
> download: [downloads/imperium-brand-kit.zip](downloads/imperium-brand-kit.zip).

## 1. Who Imperium is (say this correctly or not at all)

- **Imperium** — an AI consultancy and AI software company. It builds AND runs AI operating
  systems for SMEs, Palantir-style. Internal shorthand: "the Palantir for SMEs".
- Thesis: **AI runs systems, we run meaning.** Serves SMEs (£3-50M revenue), never "enterprise".
- NEVER say: "Imperium Growth" (retired name), "AI agency", "automation agency". Never
  reference the founder's age. Never fabricate numbers.
- The brand soul is one intersection: **classical authority x modern technology**. Every asset
  carries a little of each. Voice: short sentences, serious, warm, no em dashes, no emojis.

## 2. The visual contract (non-negotiable tokens)

- **Colour: greens only** + a neutral spine + one Ember accent maximum per view.
  Primary `#11462C` Racing Green · Mint `#4CB782` / `#D8EBDD` · Bali `#3FA085` ·
  Deep `#0A1F14` · Paper `#F7F6F1` · Sage `#EDF2E8` · Bone `#F4F1EA` · Ink `#15130E` ·
  Console `#0C1712` · Ember `#E23A28` (alerts only). No pure white fills, no warm browns,
  no blue-teal, no neon. Machine copy: [tokens.json](tokens.json) / [imperium-tokens.css](imperium-tokens.css).
- **Type**: Emilio (display; Light is primary, SemiBold max emphasis) + Switzer (body/UI/numbers).
  Per-weight woff2 presets in [fonts/](fonts/) — call the preset, never synthetic bold.
  Wordmark: IMPERIUM in Emilio, tracked caps 0.14em. Console UIs use Switzer only.
- **Shape**: radius 40px for cards/media/panels at every size, 10px for inputs/chips,
  pill for tags/CTAs, 12px for app-window/browser chrome in software mockups only
  (BRAND-BOOK §5 exception). Nothing else exists.
- **Icons**: one source only — Microsoft's open-source VS Code codicons (github.com/microsoft/vscode-codicons, CC BY 4.0). 16x16 filled paths, fill="currentColor" (mint on dark, Racing Green on light). Need an icon beyond the 22 in `icons/`? Fetch `https://raw.githubusercontent.com/microsoft/vscode-codicons/main/src/icons/<name>.svg` and recolour to currentColor — never hand-draw or AI-generate UI glyphs. Third-party company/app logos are NOT icons: use the app-icons process.
  22 ready SVGs in [icons/](icons/). Never introduce a second icon language.
- **Logos**: 48 logo master files (vector masters + raster exports) in [logos/](logos/) — marks (green/paper/ink/mint, transparent),
  IMPERIUM wordmarks (Emilio Light outlines, 0.14em tracked caps), horizontal + stacked lockups,
  and R40 tiles with favicons. Use these files verbatim; NEVER regenerate, redraw, or let an image
  model render the logo, and never use the retired blue-teal squircle set.
- **Card anatomy** (spec: [card-anatomy.svg](card-anatomy.svg)): R40 corners · 1u padding unit ·
  Emilio display top-left · CTA bottom-left with icon and text in the SAME colour (mint on
  dark, `#11462C` on light, bare icon, no circle behind it) · porcelain prop at 70-85% card
  width crossing 1-2 edges · conic rim (2px, brightest 45°/315°) + top-right glint · grain
  7-12% over a brand gradient ground · one light source, upper-left.
- **Generated environments** (BRAND-BOOK §5b, binding): real-world scenes with natural light
  (offices, classical facades, interiors, studio product light) or calm brand-solid grounds.
  Banned: sci-fi effects, laser lines, glowing particles, floating dust, aurora atmospheres.
  One light source, upper-left.
- Full rules and per-surface table: [BRAND-BOOK.md](BRAND-BOOK.md). If anything contradicts
  the book, the book wins. Precedence: BRAND-BOOK → tokens → this file → process docs.

## 3. What you can produce with this kit (capability -> exact process)

> Folder links below (downloads/cards/, downloads/components/, ...) resolve in the unzipped
> kit; the live site serves no directory index — enumerate files via
> [manifest.json](manifest.json) when working from the URL.

| You want | Process file | Method in one line |
|---|---|---|
| Marketing / hero / article cards with 3D props | [downloads/skills/card-studio.md](downloads/skills/card-studio.md) + [portable prompt](downloads/skills/card-studio-portable-prompt.md) | Code owns the card chrome; generate the prop as an isolated porcelain object (locked style block), cut out, composite, screenshot-verify. Copy any card in [downloads/cards/](downloads/cards/) as your style anchor. |
| Premium interactive console/dashboard components | [downloads/skills/imperium-ui-replicate.md](downloads/skills/imperium-ui-replicate.md) | Pixel-loop a reference, transfer to brand tokens, calibrated motion (odometer rolls, sprung gauges). Working examples: [downloads/console/](downloads/console/). |
| Site-ready feature components (bento, charts, docks, post cards) | copy one from [downloads/components/](downloads/components/) | Eleven component families (2026-07-29): glass-bento, budget-chart, integrations-card, legal-docs, hiring-trio, inbox-funnel, app-dock, glow-cards (4 individual cards), launch-cover, integrations-catalog, icon-styles — 14 standalone specimens in total. Each is self-contained, page-transparent, dual-theme (`?theme=light`), brand motion included — restyle content, keep structure. |
| Real third-party app icons / company logos | [downloads/skills/app-icons.md](downloads/skills/app-icons.md) | NEVER let a model draw a third-party logo. Extract installed macOS icons, fetch official marks (Wikimedia Commons, watch redirects for newer versions), or use a client's own SVG; then apply one of the three sanctioned finishes (raw / glass / imperium porcelain — see the Icon treatment styles section of the master sheet). |
| Glassmorphic icons/objects in pure code | [downloads/skills/glass-icon-studio.md](downloads/skills/glass-icon-studio.md) | Measure-first SVG glass; working example: [downloads/folder/folder.html](downloads/folder/folder.html). |
| Full UI mockups / finished renders | [downloads/skills/mockup-studio.md](downloads/skills/mockup-studio.md) | Exact code replica first, generative finishing second. |
| Imperium OS software mockups (product marketing renders) | [downloads/mockups/MOCKUPS.md](downloads/mockups/MOCKUPS.md) | Edit the mockups-v5 source tree (repo: Alex OS/assets/imperium/mockups-v5/; full mirror in [downloads/mockups/src/](downloads/mockups/src/) + mockups-src.zip), apply the premium v4 finish layer from MOCKUPS.md (gradient surface, ink shadows, glint + grain, Emilio display, mint accents, transparent object only), render via _scripts/render-alpha.sh; GPT Image 2 finish, then optional Higgsfield glass/light pass on the finished hero only. |
| Finished heroes (generative pass on a code render) | [downloads/mockups/MOCKUPS.md](downloads/mockups/MOCKUPS.md) + [downloads/skills/higgsfield.md](downloads/skills/higgsfield.md) | Composite the transparent render onto a brand ground, GPT Image 2 edit with a brand prompt + layout guard (protect blurred windows, lock table positions), then Higgsfield 4K upscale. Worked examples with exact prompts: downloads/mockups/heroes/. |
| **Imperium deck / presentation (DEFAULT for anything outward-facing)** | [downloads/documents/deck-cinematic.html](downloads/documents/deck-cinematic.html) (the shipped engine + demo world) → [continuous-world-technique.md](downloads/skills/continuous-world-technique.md) (generation method) → [mission template](downloads/skills/continuous-world-mission-template.md) (fill and run) → [presentation-pipeline.md](downloads/skills/presentation-pipeline.md) (overview) | **Deck tier rule (Alex, 2026-08-01): the continuous-world method IS the Imperium presentation.** One generated world, one light grade, stills chained by reference; every forward transition a Seedance start/end-frame film; HTML type on top, matched to reserved negative space. deck-cinematic.html implements the full engine in one file (crossfade fallback, skip protection, ambient loop) with a working demo world in `downloads/documents/world/` — swap the world, keep the engine. Client, stage, investor, partner decks all start here. |
| Static presentation slides (middle tier, no films) | [downloads/skills/imperium-presentation.md](downloads/skills/imperium-presentation.md) | Generated world backgrounds + code-composited brand-exact text; crossfades instead of films. Use when video spend isn't budgeted or a flat PDF is required. Never let a model draw text or logos. |
| Utility deck (internal ONLY, zero AI spend) | [downloads/documents/deck-template.html](downloads/documents/deck-template.html) | Six token-pure slide layouts, arrow-key nav, both themes, print-to-PDF. Internal working sessions and print handouts only — it is NOT the Imperium presentation look; never send it outward. |
| Websites, landing pages, flyers, one-pagers | [DESIGN.md](DESIGN.md) + [BRAND-BOOK.md](BRAND-BOOK.md) §8 per-surface table + [tokens.json](tokens.json) | Copy [DESIGN.md](DESIGN.md) (the brand in the standard DESIGN.md spec) into your project root so DESIGN.md-aware design tools — Impeccable, Stitch, any spec-compliant agent — stay on brand automatically. Then apply tokens (never hardcode hex), R40 panels, card anatomy for feature blocks, [logos/](logos/) lockups verbatim. If you have the Impeccable skill, use it as the craft engine; this kit is the identity layer. |
| Invoices, letterheads, email signatures | [downloads/documents/DOCUMENTS.md](downloads/documents/DOCUMENTS.md) + templates ([invoice](downloads/documents/invoice.html) · [letterhead](downloads/documents/letterhead.html) · [signature](downloads/documents/email-signature.html)) | Fill-in A4 templates on kit fonts + tokens: entity block public, payment rails as placeholders, tabular-nums, horizontal lockup, one green accent. Text stays text — never rasterise a document. |
| Contracts, proposals, other documents | [BRAND-BOOK.md](BRAND-BOOK.md) §8 + [downloads/documents/DOCUMENTS.md](downloads/documents/DOCUMENTS.md) conventions + [logos/](logos/) | Same document system: Paper/Bone ground, Switzer body + Emilio Light headings, print shape rules (no R40 in print). |
| UI primitives (buttons, inputs, tables, tags, nav) | master sheet "UI primitives" section + [imperium-tokens.css](imperium-tokens.css) | Pure-token specimens in both themes: 3 button styles x 2 sizes with hover/focus/disabled, 10px-radius inputs, console table, tags, nav bar. Copy the CSS, keep the tokens. |
| LinkedIn / social graphics, stat cards | [BRAND-BOOK.md](BRAND-BOOK.md) §8 Social row + card method above | 4:5 and 9:16 first, Emilio Light headline, stat-jewelry, one Ember max; build like a card (code chrome + optional porcelain prop). |
| Dashboards and product UI | [downloads/skills/imperium-ui-replicate.md](downloads/skills/imperium-ui-replicate.md) + `data-theme="console"` tokens | Console Ground surfaces, Switzer only, mint labels, calibrated motion. |
| Email styling | [BRAND-BOOK.md](BRAND-BOOK.md) §8 Email row | Paper ground, Switzer, one green CTA, no image-heavy templates. |
| Colour-grade footage or log stills to the Imperium film look | [downloads/luts/README.md](downloads/luts/README.md) | Apply [downloads/luts/bailey-mylook-2026-07.cube](downloads/luts/bailey-mylook-2026-07.cube) (33-point 3D LUT, DaVinci Resolve) to LOG sources only; never to delivered Rec709 images. Log stills get the README's measured exposure lift first, then the LUT, then a small saturation trim. |

### Generative model routing (as of 2026-07 — the single source for "which model")

| Job | Model / endpoint | Notes |
|---|---|---|
| Porcelain props, palette-consistent graphics | Higgsfield `nano_banana_2` | Default. Step up to `nano_banana_pro` on hard cases (fine text on the prop, complex multi-object scenes). |
| UI / hero finishing (environment, lighting, glass) | GPT Image 2 **edit endpoint**, direct OpenAI API | Never through Higgsfield. Layout guard in the prompt; verify `response.model === "gpt_image_2"` on every call. |
| 4K upscale | Higgsfield `upscale_image`, provider `bytedance` | Final step on finished heroes only. |
| Slide transitions / motion between frames | Higgsfield `seedance_2_0` | Always explicit 1080p (defaults to 720p), ~5s, start/end frames. Previz on `seedance_2_0_mini`; Kling 3.0 fallback after 2 filter rejections. |
| Images of the founders | Never generated | Real photos only — §6 photo library. |

Any model name in a process file that disagrees with this table is stale; this table wins.

## 3b. Portability (you are probably NOT on the author's machine — that is fine)

Everything in this kit is self-contained: specimens are standalone HTML with bundled fonts
and props, links are relative (they work on this site and inside the unzipped folder on any
OS). Process docs carry a PORTABILITY NOTE: internal paths (`~/.claude/...`, `<repo-root>/...`),
Drive/Telegram distribution steps, and Vercel team scopes are the author's conveniences —
substitute your own tooling; the methods, prompts, model parameters, and QA gates are the
portable substance. If you have no tooling at all, the
[card-studio portable prompt](downloads/skills/card-studio-portable-prompt.md) reproduces the
card method in any plain chat session.

## 4. The quality gate + where outputs go (the shipping contract)

**The loop (every visual deliverable):** render → screenshot → score five dimensions 1-10,
harshly — (1) token accuracy (colours/type/radius vs §2), (2) composition & card anatomy,
(3) physics (light direction, rim, shadow coherence — one source, upper-left), (4) typography
(weights, tracking, hierarchy), (5) brief fit — → fix the worst dimension → repeat.
**Ship at avg ≥9.5 with no dimension <8, max 3 iterations.** If a process doc elsewhere in
this kit says "≥9 / no dimension <7", this section supersedes it. Pixel-replica work keeps its
objective bars instead: ≥85% of pixels within 12/255 (imperium-ui-replicate), SSIM ≥0.90 pass /
<0.75 fail (continuous-world).

**Output location:** deliverables go to the caller's working directory, one folder per
deliverable, containing the standalone HTML, a rendered PNG, and a transparent PNG where
applicable. Any Drive/Telegram/`file://` distribution steps you see in process docs are
author-machine conveniences (see the PORTABILITY NOTE pattern) — not part of the method.

## 4b. How to maximise this kit (the answer to "what can I do with it")

1. Read this file + [BRAND-BOOK.md](BRAND-BOOK.md); load [tokens.json](tokens.json).
2. Pick the capability row above that matches the ask; read its process file.
3. Anchor on a working specimen, don't start blank: any card HTML in
   [downloads/cards/](downloads/cards/) (each is standalone with fonts + props), the console
   components, or the glass folder. They are the proven house style — restyle content, keep
   the physics (rims, glints, shadows, light direction).
4. Generate props/imagery per the locked style blocks in the process files; keep ALL text,
   numbers, and logos in code, never in generated pixels.
5. Verify before shipping: render, screenshot, check against the visual contract in §2 and
   the card anatomy. A deliverable that drifts off `#11462C`, uses a second radius, mixes
   icon styles, or says "Imperium Growth" is wrong by definition.

## 5. Index

- Human-readable master sheet (live specimens of everything): [imperium-master-sheet.html](imperium-master-sheet.html) / https://brand.imperiumos.ai
- Machine manifest of every canonical file (300 entries; per-component font copies are not double-indexed): [manifest.json](manifest.json)
- AI-crawler index: [llms.txt](llms.txt)
- Everything as one archive: [downloads/imperium-brand-kit.zip](downloads/imperium-brand-kit.zip) — built from the kit root, so unzipping reproduces this site's tree and every relative link works offline
- Kit integrity checkers: `node scripts/verify-kit.mjs [--live]` (manifest ↔ disk ↔ zip ↔ live URLs) · `node scripts/check-links.mjs` (every relative markdown link resolves) · `node scripts/check-contrast.mjs` (WCAG table in tokens.json recomputed). Deploy ritual: rebuild the zip after content changes → run all three checkers → update [CHANGELOG.md](CHANGELOG.md) → deploy → verify-kit --live.
- Version history: [CHANGELOG.md](CHANGELOG.md)

## 6. Photo library (real photography, never AI-generate the founders)

Real photos of Alex and Archie live in a public Google Drive, organised per event, final graded versions only: https://drive.google.com/drive/folders/12Dj0BJDEW5-Dqttc7Vb0bac410o0xrR6

When a page, post, or deck needs a photo of the founders, pull from this Drive (start with `00-primary-best-of-best`) instead of generating one. Anyone with the link can browse, search inside the folder, and download; it is read-only. Folder names describe the event/venue; per-photo quality scores live in the repo at `assets/imperium/alex-archie-photos/INDEX.md`.

Headless selection: fetch https://brand.imperiumos.ai/photos.json — it lists all 262 photos with direct view/download links, subject (alex/archie/duo), orientation, dimensions, quality score (8+ = publish-grade), best-use hints (hero, thumbnail, ig-story...), and per-folder scene descriptions. Choose from `00-primary-best-of-best` for "best photo" requests; use the scene descriptions to match context (e.g. "Alex showing the operating system" -> oxo-bali dashboard-demo or villa TV/laptop shots). For production pages, download the chosen file and serve it from the site; never hotlink the Drive download URL in an <img> tag.
