Orientation
Reference
The whole engine is four things — rules, workers, work, and a scoreboard — plus the hard rules that never bend. Read live from the repo.
01The four buckets
Rules
What we may say and how things look. Set once, rarely changes.
brand/
Workers
Six agents that make copy, images, and print, and read results.
agents/
Work
One folder per station. Everything produced lands in two ledgers.
campaigns/
Scoreboard
Actual station usage vs Tesla’s expected ramp. The number that matters.
campaigns/…/performance/ramp-curve.md
02Canon — read the source
Brand voice and visual identity, rendered from the repo
03Workers — the agents
7 agents
Image
Produces the canonical HiON pillar imagery for social, paid, print, and landing pages via the Higgsfield recipe (`../recipes/`).
agents/image.md
Long-form copy
LinkedIn articles, blog posts, and the **franchisee-facing proof stream** — the content that shows fence-sitting prospects the first site exceeding Tesla's ramp baseline.
agents/long-form-copy.md
Orchestrator / strategy
Owns the campaign brief, the audience map, and the channel plan. Routes work to the other five agents and decides what to make next. For v1, paid-strategy oversight is folded into this agent — split it into a dedicated agent only when data volume justifies it.
agents/orchestrator.md
Performance synthesis
The entire "agents that learn" loop — realistically scoped. Reads `performance-ledger.jsonl`, curates a `winning-examples` bank that agents 2–5 few-shot from, and refreshes the per-channel strategy docs. **No model fine-tuning** — just curated examples plus living strategy docs refreshed from real results.
agents/performance-synthesis.md
Print / collateral
Physical-world assets: signage, banners, yard signs, and swag specs — with print-production constraints built in.
agents/print-collateral.md
Review board (the draft → approved gate)
The convergence gate. The six producing agents *make*; this agent *judges* — the maker never grades its own homework. It convenes a room of six lenses, decides, and dissolves: nothing here is a standing fleet of persona agents. It sits at exactly one lifecycle seam — `draft → [review board] → approved` — the review gate the rest of the repo already references (`../lib/ledger-schema.md` §3; `../lib/creative-intake.md` "status draft, pending legal review"). Its companion at the *front* of the pipeline is the rich divergence layer in `../lib/ideation-panel.md`; this file is the disciplined gate at the *back*.
agents/review-board.md
Short-form copy
Driver-facing headlines, captions, and ad copy for social and paid channels. Short, warm, useful.
agents/short-form-copy.md
04Registers
Tone by audience
Boardroom
investors and franchisor-level capital
Site & Sales
prospective franchisees
Field
property hosts and operations
Consumer-Driver
local EV drivers (new for the Content Engine)
05Hard rules
Never bend these — brand/never-list.md
- —No exclamation points. Anywhere. Ever. Social, captions, signage, internal-that-may-go-external. No exceptions.
- —HiON is always `HiON` — capital H, lowercase i, capital O, capital N — even inside all-caps display type.
- —Sentence case for all headlines and section names. Never Title Case (except inside the design system's monospace UI labels).
- —Numerals over spelled-out numbers. `4,000 ports`, not "four thousand."
- —`kWh` — lowercase k, uppercase W, lowercase h. Never `KwH`, `kwh`, or `KWH`.
- —En-dashes for ranges, no spaces: `1905–2026`, `20–30 minutes`, `0–1 employees`.
- —No Tesla logo in any image, signage, deck, or graphic. Verbal Tesla references are allowed (see `brand-guidelines.md` §Tesla).