Building Design

Setup

Item	Kind	Required	When	Done when	How
Node.js 22.12+ with npm	user	required	All	`node --version` reports 22.12 or later	https://nodejs.org
Root path and intention	ask	required	All	design-contract.md → Resolve design root finds a root for the request's intention	Ask for the folder (default per design-contract.md → Design roots) and the intention (one short phrase); missing or empty → use it, else ask for another path; recorded as the root's location and `index.md` → `intention`
Root marker	static	required	All	`<design-root>/index.md` carries design-contract.md → Author signature	Write `index.md` from `assets/index.md` with `intention`
Viewer app	static	required	All	Viewer files and `index.md` → Viewer keys match `assets/`	Copy everything in `assets/app/`, dotfiles included (`cp -R <skill>/assets/app/. <design-root>/`); replace `index.md` → Viewer keys from `assets/index.md`
Viewer install	auto	required	All	`<design-root>/node_modules/` exists	`npm install` in the design root

Setup — for each Setup row whose When covers the request, in order: Done when holds → skip; user → stop and print its How when required, continue without it when optional; ask → fill what the request answers, ask the rest together in one message, record each answer; auto and static → run.
Contract — read design-contract.md and preview-contract.md.
Recipe — match one Recipes row; open every doc in its Read column.