automate

/automate — brand-faithful marketing-page factory

Author or propagate brand/visual work across every surface a project defines in .automate/config.json, verify in a real browser, and ship via a safe git flow. On-brand by construction (uses .automate/brand.json); high fidelity is measured.

Routing (first token picks the verb)

• init → onboarding (brand kit + scaffold). See Init below.
• new "<brief>" [+ reference] → author a page. See New (page factory).
• anything else (image / repo-ref / URL / text) → propagate one change. See Propagate.
• --dry-run (any verb) → plan only, no edits.

Routing is literal on the first token. A propagate request whose change involves the word "new" must not START with new (phrase it add new X across surfaces / update …) or it routes to the page factory.

Prerequisite

.automate/config.json must exist (see configs/config.example.json). For new, a brand kit (.automate/brand.json) should exist — if missing, run init first. Never guess surfaces or brand values.

Init (/automate init)

1. Detect stack (static HTML vs React/Tailwind) from the repo + any existing config.
2. Extract a brand kit: node scripts/extract-brand.mjs <repo> > .automate/brand.json. Read references/brand-kit.md. SHOW the result; let the user edit. Never invent values.
3. Scaffold .automate/config.json from configs/config.example.json if absent; confirm surfaces with discovery: node scripts/discover.mjs <repo>.

New — page factory (/automate new "<brief>" [+ reference])

1. Brief→spec — read references/input-modes.md. Parse brief + optional reference (image / URL / repo element) into a page spec (type, goal, audience, ordered sections, CTA, tone). Load the brand kit. Confirm the outline in one message.
2. Generate — read references/generate.md. Produce generate.variants on-brand candidates in the detected stack (static HTML default). Delegate to installed design skills if present.
3. Fidelity gate — read references/fidelity-gate.md. Shoot 3 viewports, score the rubric, visual-diff vs reference if any, check a11y + page weight; decide via scripts/rubric.mjs. Refine until pass or fidelity.maxPasses; report residuals.
4. Propagate — read references/surface-map.md + gate-safe-edits.md. Write the page into pageSurface (+ mirror twin), gate-safe tokens, plus OG/email/social assets where configured; assert parity; run gate.cmd.
5. Ship — read references/ship-flow.md. Branch off ship.baseBranch, explicit paths, PR, merge gate, live verify + cache-bust.

Propagate (bare reference/text — v0.1.x behavior, unchanged)

1. Resolve input (references/input-modes.md). 2. Discover surfaces (scripts/discover.mjs; references/surface-map.md). 3. Propagate (references/gate-safe-edits.md). 4. Verify (browser-screenshot routes). 5. Ship (references/ship-flow.md).

Hard rules (non-negotiable)

• Never git add -A; stage explicit paths.
• Never introduce raw hex into tokenized files; run the gate before pushing.
• Branch off origin/main, never a stale working branch.
• Assert mirror parity before committing.
• Confirm the PR is still OPEN before relying on it; re-PR stranded commits.
• Never bypass branch protection (no --admin). Pause at the merge gate if blocked.
• Fidelity is measured: READ screenshots, never assume; never ship a gate-failing page silently.