design
Installation
SKILL.md
Design
Interview the user relentlessly until the design is settled, then write it down and wait for approval.
Process
- Read the request,
PROJECT.md, projectAGENTS.md, relevant code, and prior understand output. - Run the Interview method below until the frontier is empty.
- Write the design —
docs/<feature-slug>/design.mdby default, chat-only for a small change if the user prefers. Put every settled choice in Decisions, and every unsettled one in Open questions. - Tailor sections to the task. Include only what matters.
- Stop and ask: "Please review the design. Reply approved or request changes."
Interview method
Interview the user relentlessly until you reach a shared understanding. Map this as a design tree: every decision branches into the decisions that hang off it.
Work the tree in rounds. The frontier is every decision whose prerequisites are already settled: the questions you can ask now without guessing at answers you haven't heard yet. Ask the whole frontier in one round: number each question and give your recommended answer. Then wait for the user's answers before the next round.
Format a round like so: