/speckit-checklist

description: Generate a custom checklist for the current feature based on user requirements.
argument-hint: "Feature name or path to spec"

Before proceeding, load the `speckit-orchestrator` skill for workflow coordination. Consider loading complementary skills like `superpowers:verification-before-completion` for enhanced checklist validation.

Checklist Purpose: "Unit Tests for English"

A checklist is a unit test suite for the spec: it checks that the requirements are complete, clear, consistent, and measurable. It never checks whether an implementation works. Read `skills/spec-writing/modules/checklist-dimensions.md` before writing items. It holds the quality dimensions, the item structure, the traceability rule, the prohibited and required patterns, and wrong-versus-correct examples.

User Input

$ARGUMENTS

You **MUST** consider the user input before proceeding (if not empty).

Execution Steps

1. **Setup**: Run `.specify/scripts/bash/check-prerequisites.sh --json` from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS list.

• All file paths must be absolute.
• For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'\''m Groot' (or double-quote if possible: "I'm Groot").

2. **Clarify intent (dynamic)**: Derive up to THREE initial contextual clarifying questions (no pre-baked catalog). They MUST:

• Be generated from the user's phrasing + extracted signals from spec/plan/tasks
• Only ask about information that materially changes checklist content
• Be skipped individually if already unambiguous in `$ARGUMENTS`
• Prefer precision over breadth

Generation algorithm: 1. Extract signals: feature domain keywords (e.g., auth, latency, UX, API), risk indicators ("critical", "must", "compliance"), stakeholder hints ("QA", "review", "security team"), and explicit deliverables ("a11y", "rollback", "contracts"). 2. Cluster signals into candidate focus areas (max 4) ranked by relevance. 3. Identify probable audience & timing (author, reviewer, QA, release) if not explicit. 4. Detect missing dimensions: scope breadth, depth/rigor, risk emphasis, exclusion boundaries, measurable acceptance criteria. 5. Formulate questions chosen from these archetypes:

• Scope refinement (e.g., "Should this include integration touchpoints with X and Y or stay limited to local module correctness?")
• Risk prioritization (e.g., "Which of these potential risk areas should receive mandatory gating checks?")
• Depth calibration (e.g., "Is this a lightweight pre-commit sanity list or a formal release gate?")
• Audience framing (e.g., "Will this be used by the author only or peers during PR review?")
• Boundary exclusion (e.g., "Should we explicitly exclude performance tuning items this round?")
• Scenario class gap (e.g., "No recovery flows detected: are rollback / partial failure paths in scope?")

Question formatting rules:

• If presenting options, generate a compact table with columns: Option | Candidate | Why It Matters
• Limit to A–E options maximum; omit table if a free-form answer is clearer
• Never ask the user to restate what they already said
• Avoid speculative categories (no hallucination). If uncertain, ask explicitly: "Confirm whether X belongs in scope."

Defaults when interaction impossible:

• Depth: Standard
• Audience: Reviewer (PR) if code-related; Author otherwise
• Focus: Top 2 relevance clusters

Output the questions (label Q1/Q2/Q3). After answers: if ≥2 scenario classes (Alternate / Exception / Recovery / Non-Functional domain) remain unclear, you MAY ask up to TWO more targeted follow‑ups (Q4/Q5) with a one-line justification each (e.g., "Unresolved recovery path risk"). Do not exceed five total questions. Skip escalation if user explicitly declines more.

3. **Understand user request**: Combine `$ARGUMENTS` and clarifying answers:

• Derive checklist theme (e.g., security, review, deploy, ux)
• Consolidate explicit must-have items mentioned by user
• Map focus selections to category scaffolding
• Infer any missing context from spec/plan/tasks (do NOT hallucinate)

4. **Load feature context**: Read from FEATURE_DIR:

• spec.md: Feature requirements and scope
• plan.md (if exists): Technical details, dependencies
• tasks.md (if exists): Implementation tasks

**Context Loading Strategy**:

• Load only necessary portions relevant to active focus areas (avoid full-file dumping)
• Prefer summarizing long sections into concise scenario/requirement bullets
• Use progressive disclosure: add follow-on retrieval only if gaps detected
• If source docs are large, generate interim summary items instead of embedding raw text

5. **Generate checklist** - Create "Unit Tests for Requirements":

• Create `FEATURE_DIR/checklists/` directory if it doesn't exist
• Generate unique checklist filename:
• Use short, descriptive name based on domain (e.g., `ux.md`, `api.md`, `security.md`)
• Format: `[domain].md`
• If file exists, append to existing file
• Number items sequentially starting from CHK001
• Each `/speckit-checklist` run creates a NEW file (never overwrites existing checklists)

**Item rules**: follow `skills/spec-writing/modules/checklist-dimensions.md` for the quality dimensions, item structure, traceability (at least 80% of items carry a reference), and the prohibited and required patterns.

**Category Structure** - Group items by requirement quality dimensions:

• **Requirement Completeness** (Are all necessary requirements documented?)
• **Requirement Clarity** (Are requirements specific and unambiguous?)
• **Requirement Consistency** (Do requirements align without conflicts?)
• **Acceptance Criteria Quality** (Are success criteria measurable?)
• **Scenario Coverage** (Are all flows/cases addressed?)
• **Edge Case Coverage** (Are boundary conditions defined?)