create-spec

Write BDD-style test scenarios in Gherkin before implementation.

Steps

1. Determine the feature — the argument can be:

   • A GitHub issue number or URL → fetch with gh issue view for context (do NOT embed the issue number in the spec)
   • A feature description → use as the feature name
   • Nothing → ask the user what feature to specify

2. Explore the codebase for related context:

   • Read CLAUDE.md for project conventions
   • Check existing code and tests related to the feature
   • Check doc/adr/ and doc/ for relevant decisions and documentation

3. Check doc/spec/ for an existing spec that covers this feature:

   • If found → add new scenarios to the existing file
   • If not found → create a new file: doc/spec/<kebab-case-feature-name>.feature

4. Write scenarios using this template: