tdd-spec - Design Machine-Readable TDD Specifications
Generates or updates detailed technical specifications with API contracts, data models, test seams, and ADRs in /spec/ and docs/adr/.
Tags
Updated: 2026-10-01Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Analyze PRDs and user briefs
- Inspect codebase technical facts
- Define API contracts
- Model data structures
- Specify public test seams
- Record architectural decisions
- Generate specification documents
- Ask targeted clarification questions
Inputs
- Approved PRD documents
- Comprehensive user briefs
- Application codebase
- AGENTS.md
- Context maps and glossaries
- Existing specifications
- Architecture decision records
- Specification standards
Outputs
- Markdown specification files
- Architecture decision records
- Clarification questions
- Specification handoff instructions
Requirements
- Access to repository search tools
- Permission to write /spec/
- Permission to write docs/adr/
- Project language policy
- Approved PRD or comprehensive user brief