---
name: brand-documents
description: Use when generating a PDF, letter, invoice, report, booklet, slide deck, letterhead, delivery note, or HTML portal/handoff for In Motion Automation or a client of agentsinmotion.ai.
---

# Brand documents

Client-facing paper and HTML for In Motion Automation. **Subtle. Client first. Geist. Navy bar.**

Three vibes, same templates. **Warm** default (`ima-doc`). **Cool** is `ima-cool` — steel, cyan, sharper, no navy chrome. **Fresh** is `ima-fresh` — white everywhere, orbit stripe and a cyan tick, no cream and no navy fill. Preview/portals: `?vibe=warm|cool|fresh`. Ask which vibe if the user did not say. Do not mix them in one delivery.

Read [`brand/GUIDE.md`](../../brand/GUIDE.md) before writing a page. Tokens and CSS live there and in `brand/css/`. Do not invent a palette, a typeface, or a new header.

Public site photographs are a separate lane. Read GUIDE → **Public site and photography** before generating or placing a still on www. Night, elevated camera, one still subject, long-exposure streaks. Paper and wood stills stay on stationery.

## Do this

1. Pick the template in `brand/templates/` that matches the job.

   | Job | File |
   |---|---|
   | Letter / email-as-PDF | `letterhead.html` |
   | Invoice / receipt | `invoice.html` |
   | Delivery, report, proposal | `report.html` |
   | Bound / printed booklet | `booklet.html` |
   | Client presentation | `presentation.html` |
   | Linkable handoff, review room, living doc | `portal.html` |
   | Working guidelines | `brand/terms/working-guidelines.html` |
   | Services agreement | `brand/terms/services-agreement.html` |
   | Statement of work | `statement-of-work.html` |

2. Copy the template next to the client work (not inside `brand/templates/`). Keep the CSS/asset paths working, or copy `brand/css/` + `brand/assets/` beside it.
3. Replace every `data-ima` field and all sample Harbor & Co. copy with the real client. No lorem. No leftover sample names.
4. Hierarchy on inner pages: **client name largest**. IMA is the wordmark plus a 9mm textless orbit (`.ima-stone--whisper`). Full glow logo is **cover only**. Empty orbit never larger than a whisper on a letter.
5. Export PDF:

   ```bash
   "01 Projects/In Motion Automation/brand/export.sh" path/to/doc.html
   ```

   A4 is default. Add `--landscape` for decks. Add `--letter` only if the client asked for US Letter.

6. Open the PDF and check: 3mm navy bar present, client name leads, footer whisper, no halo, no Inter, no magenta fill.

Invoices follow the Apple Store receipt rhythm (not Apple marks): billed-to / from, line codes, an indented options list under each line, right-stacked totals, hairline grey rules only, one typeface and no mono. Paid invoices keep “Do not pay” and amount due `$0.00`.

## Hard rules

- Warm: paper `#FAFAF8`. Cool: `#F2F5F8`. Fresh: `#FFFFFF`. Orbit colors on the logo and as ticks, never as a page fill.
- Type is Geist + Geist Mono. Warm 22/10px · Cool 8/4px · Fresh 14/8px.
- Public name **In Motion Automation**. Legal **Agents in Motion LLC** only in the tiny footer. Contact `mr.roboto@agentsinmotion.ai`. Site `agentsinmotion.ai`.
- Software Agents in Motion LLC creates stays its property, including software the client asked for. The client gets permission to run what they paid for. Do not write that our software is theirs at handoff, or theirs when they say stop. Client data, accounts, and marks stay the client's.
- Portals: client in the header, IMA in the rail + footer. Load `ima-docs.css` then `ima-portal.css`.

## Stop

If you are about to put a giant logo on page 2, a purple gradient, “POWERED BY AGENTS IN MOTION”, or Inter, stop. Use the template. If you are about to put a paper still-life, a blank phone, or a suburban house on www, stop. Use the lock stills in `brand/assets/imagery/`.

Preview the whole system: `brand/preview/index.html`.


## Client brand (paid option)

When a client pays for full branding, the document carries their wordmark, colours and type from cover to last page and no In Motion mark. Keep the same build (HTML, headless Chrome PDF) and the same writing standard. Gold: `brand/examples/BVRNRATE-SBA-PROJECTIONS-THAT-PASS.pdf`; style book `#client-brand`.

## Research papers and decision decks

This skill is **client stationery only** (Geist, warm/cool/fresh, client name leads).

For Jake-facing **research letter papers** (US Letter LaTeX, TeX Gyre Termes) and **true 16:9 IMA cool decision / evidence decks**, use the sibling skill **`ima-research-documents`**. Do not invent a third look.

Read `brand/GUIDE.md` → section **Research papers and decision decks (Chief house standard, locked 2026-09-25)**. Gold: `/workspace/outputs/bytestream-creator-metrics/2026-09-25/`. Prose: `jake-house-writing`.