← ClaudeAtlas

spec-itlisted

Use when you have a goal or feature and need the detailed requirements before design — what it must do, how each is verified, and the assumptions and risks involved. Produces a requirements spec (SRS) under .augments/specs/. Grill unknowns with interview-me; this captures the WHAT, never the HOW.
NjoyimPeguy/augments · ★ 1 · Testing & QA · score 74
Install: claude install-skill NjoyimPeguy/augments
# Spec It Turn an intent into a requirements spec (SRS): gather and analyze what the software must do, how each requirement is verified, and the assumptions, dependencies, and risks involved. Requirements are the *what* — keep the *how* (architecture, schemas, code) for design. ## When to use - You have a goal, brief, or feature request and need its detailed requirements before designing or building. - **Skip** for a trivial change whose single requirement is obvious — just state it and go. - If the intent itself is unclear, grill it first with `interview-me`; this skill assumes you roughly know what you want. ## Procedure 1. **Gather the inputs.** Pull the goal or brief (from planning), read the relevant existing code to see what's already there, and grill any genuine gap with `interview-me`. Don't invent what you could have found. 2. **State the problem** in a line or two, and link the goal it serves. 3. **Write functional requirements as testable behaviours.** Each is something a user or caller can observe — "rejects an expired token with a 401", not "good auth". If you can't phrase it as checkable, it's a wish, not a requirement. 4. **Add only the non-functional requirements that matter** — performance, security, accessibility, compatibility. An unbounded NFR list is noise. 5. **Give each requirement an acceptance criterion** — the concrete check that proves it. These become the plan's **Evaluator** and **Acceptance**, so make them runnable where you can. 6. **List t