Spec Manager

Spec Manager

Manages specification files in specs/{scope}/{work-name}.md for spec-driven development workflow.

Principles

1. One spec = one task (unless frontend + backend work together)
2. No "before" sections - Focus only on the final desired state
3. XML tag format - Use XML tags for structure (varies by scope)
4. Minimal code examples - Avoid code in specs; if necessary, keep it brief and illustrative
5. Check for duplicates - Always verify if similar specs exist before creating

Operations

Create

1. Analyze request and infer scope (feat/fix/docs/refactor/chore)
2. Search specs/{scope}/ for similar existing specs
3. If found, ask: "Create new", "Update existing", or "Cancel"
4. If ambiguous scope, ask user to confirm
5. Generate filename (lowercase-with-hyphens)
6. Use appropriate template based on scope
7. Fill in XML tags based on user request

Update

1. List existing specs in relevant scope
2. Let user select which to update
3. Verify update aligns with original purpose
4. If purpose changed significantly, suggest new spec
5. Apply changes while maintaining XML structure

Delete

1. List all specs organized by scope
2. Let user select spec(s) to delete
3. Confirm and remove

List

Display all specs organized by scope directory structure.

Templates

See templates directory for scope-specific XML tag structures:

• feat → templates/feat-template.md
• fix → templates/fix-template.md
• docs → templates/docs-template.md
• refactor → templates/refactor-template.md
• chore → templates/chore-template.md

Each template uses different XML tags appropriate to its scope.