diff --git a/.claude/commands/spec-quick.md b/.claude/commands/spec-quick.md new file mode 100644 index 0000000..0b088f7 --- /dev/null +++ b/.claude/commands/spec-quick.md @@ -0,0 +1,162 @@ +--- +description: Author a lean behavior spec (the WHAT) — fast path with one review pass. Step 1 of spec → plan → execute. +argument-hint: "[feature description]" +--- +# Spec Quick (spec-quick) + +Write a **behavior specification** for the feature in $ARGUMENTS — the **WHAT**, never the HOW — +in a single pass. + +This is the fast path variant of `/spec-dc`: same artifact location, same section names, same +downstream contract with `/plan-dc`, but with **bounded research, conditional sections, and at +most one review pass**. + +- Use **`/spec-quick`** when the request is already clear, or the feature is small to medium. +- Use **`/spec-dc`** when the feature is large or risky, or the spec will be read by people who + weren't part of this conversation. + +## Rules + +1. **No code**, no pseudo-code, no implementation plan — the plan is `/plan-dc`'s job. +2. **Observable behavior only:** input → output → guarantee. If you're naming classes, tables, + or algorithms, you drifted into HOW — reframe it as WHAT. +3. **The spec file is the only artifact.** Change nothing else in the codebase. +4. **Do not evaluate ADR compliance** (ADR-020 §2 — that belongs to `/plan-dc`). You may + *reference* an ADR to explain an existing integration point. +5. **Never invent requirements to fill a section.** Omitting an optional section beats padding + it — padding is what makes a spec slow to write and slow to review. + +## Step 1 — Clarify (at most one batch) + +Run the clarity assessment: can you restate the goal in your own words, with no internal "wait, +there's a jump here" moment? + +- **Clear** → ask **zero questions**. Say so in one line so the user can interject, and continue. +- **Not clear** → **one** `AskUserQuestion` batch (3–4 questions) covering only what actually + blocks you. On non-Claude harnesses use the native structured-question tool per the + `{{ASK: |