Spec

The spec is the living product document. It defines what to build and why. It does not define how -- that belongs in CLAUDE.md, skills, and the code itself.

The spec lives at docs/spec.md. Create the docs/ directory if it doesn't exist.

When to use this skill

• The user explicitly asks to create or update a spec.
• A product decision comes up in conversation that should be captured. In this case, nudge: "This sounds like it belongs in the spec. Want me to add it to docs/spec.md?" If the user says no, move on.

Creating a new spec

Follow the brainstorm pattern: one question at a time, multiple choice where possible.

Flow

1. Walk through the spec sections one at a time. For each section, ask focused questions to draw out what the user actually wants. Don't assume -- even for projects that sound straightforward, the interesting constraints are the ones the user hasn't said yet.