archlisted

# arch: Architecture & solution plan via JSON → HTML injection Take a system or project the user has in mind and turn it into a **working architecture & solution plan**. You generate structured JSON; a deterministic script (`arch-inject.js`) injects it into the HTML template — you never rewrite the template. The user edits each section in the browser, then clicks **Copy plan as text** and pastes the result back so the AI can implement or refine. **Prime directive:** every section gets a real, grounded draft pulled from the actual code or requirements — not vague filler. If a section truly has nothing to seed (e.g. no compliance scope yet), leave it empty rather than fabricate. --- ## Operating modes **Mode A — First draft.** No `arch-<slug>.html` in the working directory. 1. Research the repo (see below). Draft each section with real content from the actual code: actors touching this system, existing/needed containers and stack choices, integrations, data model, ADRs grounded in the codebase, quality attributes with measurable targets, security stance, deployment topolography, known risks, phased roadmap. 2. Assemble JSON, save to `arch-<slug>.json` (temporary). 3. Run `node ~/.agents/skills/arch/arch-inject.js arch-<slug>.json arch-<slug>.html`. 4. Delete the temporary JSON. **Mode B — Refinement pass.** `arch-<slug>.html` exists and the user pastes the doc's **"Copy plan as text"** block. The block contains the full exported document — project metadata, each section's