Create New Specification
When creating a new spec:
- •
Find the next number: List files in
specs/directory and find the highest existing number prefix (e.g., if002-foo.mdexists, the next is003). Use three digits with leading zeros. - •
Create the file: Name it
specs/<NNN>-<name>.mdwhere<name>comes from$ARGUMENTSor ask the user if not provided. - •
Use this template:
markdown
# <Title> ## Overview <Brief summary of what this spec covers> ## <Main Sections> <Detailed content organized into logical sections> ## Dependencies <External requirements, if any> ## Future Considerations <Known limitations and potential future work>
- •Fill in content: Work with the user to populate the spec based on their requirements.
Guidelines
- •Specs document product, design, and technical decisions
- •Include enough detail for implementation, but avoid raw code dumps
- •Document the "why" behind decisions, not just the "what"
- •Keep specs human-readable for review