The project knows what it is before the first commit.
From the scope and the mockups, the skill writes everything a person or an agent needs to start right: what the project is and is not, the roadmap, the decisions still open, the real design tokens. It never picks the stack and never writes code.
npx skills add c0le0ni/skills --skill coleoni-init
From the scope to a project anyone can open.
The bakery from /coleoni-briefing continues here: its scope and brand notes become the docs of the project, and the docs become one page.
# Juniper Bakery: scope (from /coleoni-briefing) ## 3. First release Order page (customers, on the phone) - Today's menu: name, photo, price, "available today" - Cakes: flavor, size, message, pickup date (48h+) - Checkout without an account, payment at pickup Day board (counter, on a tablet) - One list per day, grouped by pickup time - States: new, ready, picked up WhatsApp confirmation · One-page site ## 4. Out of scope (and why) Card payments ......... Square Photos and promotions . Instagram Wholesale orders ...... Google Sheet Loyalty ............... paper stamp card Delivery, online payment, reviews ... roadmap ## 9. Open questions 1. Who owns juniperbakery.com 2. Menu photos (not received) 3. Product list with prices 4. Cake rules 5. WhatsApp sender number 6. Budget range + brand notes: cream #F6F0E6, sage #2F4A3A, terracotta #C8643B, Fraunces + Inter
Documentation first. Decisions with the team.
Whatever is heavy and hard to undo (framework, database, hosting, payments) becomes a decision record to fill in, never a choice made behind the scenes.
-
Reads what was decided
The scope, the mockups or brand, and whatever already exists in the repo, which it merges instead of overwriting.
-
Picks the files
Ten documents, each with a reason to exist. A privacy note only when there is personal data.
-
Writes the agent guide
AGENTS.mdin eight fixed sections, read by Codex, Cursor and others;CLAUDE.mdpoints to it. -
Takes the real tokens
Colors, type, spacing and radius from the material the client approved. A guess is marked “to confirm”.
-
Leaves decisions open
Stack is always ADR-0001, marked “to record”. The skill lists the decisions; the team makes them.
-
Shows it on one page
The overview reads the docs and shows phases, palette, decisions and blockers, so the project fits on one screen.
What every project gets.
Same names and the same structure in every project, so moving between them costs nothing.
| File | What it holds |
|---|---|
AGENTS.md | What it is, what it is not, stack (pending), identity, state, workflow, rules, index |
CLAUDE.md | One line pointing to AGENTS.md |
README.md | What it is and how to run it, once the stack exists |
docs/ROADMAP.md | Phases marked done, now or next; phase 1 is always the blocking decisions |
docs/STATUS.md | Client blockers on top, then what shipped and how to test it |
docs/design-system.md | Color tokens, type, spacing and rules, from the approved material |
docs/glossary.md | The client’s words, one line each |
docs/adr/ | Index of decisions and the template to record them |
docs/privacy.md | What personal data, why, where, who sees it and for how long |
docs/overview.html | The one-page view of all of the above |
One command, any agent.
Nothing else to install. The overview page needs only Node.js, no packages and no browser.
npx skills add c0le0ni/skills --skill coleoni-init
/coleoni-init ./my-project --write --overview
-g-a claude-code-a codexnpx skills add c0le0ni/skillsRun it where the scope is.
Without flags it only shows the plan. Nothing is written until you ask.
See the plan first: files, decisions and blockers.
/coleoni-init
Write the docs and the overview page.
/coleoni-init ./bakery --write --overview
Use the mockups for the tokens.
/coleoni-init --write, tokens from mockups/home.png and mockups/board.png
The overview, from the terminal.
Run scripts/overview.mjs again whenever the docs change; the page is always rebuilt from them.
| Option | What it does |
|---|---|
<project folder> | Where the docs live |
--accent "#hex" | Accent color. Default: --accent from the design tokens |
--out file.html | Output file. Default: docs/overview.html |
The first commit already knows where it is going.
npx skills add c0le0ni/skills --skill coleoni-init