speckit-author

What problem does it solve?

This Skill streamlines the time-consuming and often inconsistent process of creating detailed technical specifications and implementation plans. It ensures that development starts with clear guidance, reduces ambiguity, and automatically integrates tasks into your TODO file, saving significant manual effort.

Core Features & Use Cases

• Interactive Spec Generation: Guides you through a Q&A to create spec.md (detailed technical specification) and plan.md (implementation task breakdown) tailored to your feature.
• BMAD Integration: Automatically detects and leverages existing BMAD planning documents (requirements.md, architecture.md, epics.md) to streamline Q&A and ensure consistency between planning and implementation.
• Automated TODO Updates: Parses tasks from plan.md and automatically updates your TODO_*.md file, keeping your project tracking current without manual entry.
• As-Built Documentation: Provides a mechanism to update original planning documents with "as-built" details, creating a valuable feedback loop for future projects.
• Use Case: After creating a feature worktree, run create_specifications.py. The tool will ask targeted questions, generate a comprehensive spec.md and a detailed plan.md with tasks, and update your TODO file, allowing you to immediately start coding with a clear roadmap.

Quick Start

Example: Create specifications for a feature

(Run from within your feature worktree)

python .claude/skills/speckit-author/scripts/create_specifications.py
feature my-feature stharrold
--todo-file ../TODO_feature_20251024T143000Z_my-feature.md