Skip to content

Commit 6291d91

Browse files
committed
docs: fix SDS/SDD command count documentation bug
Fixed incorrect command counts across all documentation: Core Issue: - SDS commands: 5 → 8 (was missing: plan, tasks, implement) - Total commands: 16 → 19 (correct: 8 SDS + 8 SDD + 3 Evolution) Files Fixed: 1. README.md - Quick start example: Added all 8 SDS and 8 SDD commands 2. src/metaspec/templates/base/.metaspec/README.md.j2 - Header: 16 → 19 commands - SDS section: 5 → 8 commands, added plan/tasks/implement - Project structure: 16 → 19 commands 3. src/metaspec/templates/base/AGENTS.md.j2 - For Developers section: 16 → 19 commands with breakdown 4. docs/quickstart.md - Command usage comment: 16 → 19 commands 5. docs/architecture.md - Template structure: SDS 5 → 8 commands Impact: - All generated speckits will now show correct command counts - Documentation consistency across project - Bug reported in v0.5.5 resolved Verification: ✅ File system has 8 SDS + 8 SDD + 3 Evolution = 19 commands ✅ Documentation now matches implementation
1 parent ecb58d0 commit 6291d91

File tree

5 files changed

+19
-8
lines changed

5 files changed

+19
-8
lines changed

README.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -372,17 +372,25 @@ cd my-spec-kit
372372
pip install -e .
373373

374374
# Step 4: Use built-in MetaSpec commands for AI-assisted development
375-
# Phase 1: Define domain specification (SDS)
375+
# Phase 1: Define domain specification (SDS - 8 commands)
376376
# /metaspec.sds.constitution - Define specification design principles
377377
# /metaspec.sds.specify - Define specification entities
378+
# /metaspec.sds.clarify - Resolve specification ambiguities
378379
# /metaspec.sds.plan - Plan specification architecture
380+
# /metaspec.sds.tasks - Break down specification work
379381
# /metaspec.sds.implement - Write specification documents
382+
# /metaspec.sds.checklist - Generate quality checklist
383+
# /metaspec.sds.analyze - Check specification consistency
380384

381-
# Phase 2: Develop toolkit (SDD)
385+
# Phase 2: Develop toolkit (SDD - 8 commands)
382386
# /metaspec.sdd.constitution - Define toolkit principles
383387
# /metaspec.sdd.specify - Define toolkit specifications
388+
# /metaspec.sdd.clarify - Resolve toolkit ambiguities
384389
# /metaspec.sdd.plan - Plan implementation architecture
390+
# /metaspec.sdd.tasks - Break down implementation work
385391
# /metaspec.sdd.implement - Build your speckit
392+
# /metaspec.sdd.checklist - Validate quality
393+
# /metaspec.sdd.analyze - Check consistency
386394

387395
# Step 5: Share with community
388396
metaspec contribute my-spec-kit

docs/architecture.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ src/metaspec/templates/
4141
4242
└── meta/ # Third layer: MetaSpec self-development (SDS + SDD)
4343
├── sds/ # Domain specification commands
44-
│ └── commands/ # /metaspec.sds.* (5 commands)
44+
│ └── commands/ # /metaspec.sds.* (8 commands)
4545
└── sdd/ # Speckit development commands
4646
└── commands/ # /metaspec.sdd.* (8 commands)
4747
```

docs/quickstart.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -103,7 +103,7 @@ cd my-spec-kit
103103
# Install
104104
uv pip install -e .
105105

106-
# Use 16 built-in MetaSpec commands (in AI editor)
106+
# Use 19 built-in MetaSpec commands (in AI editor)
107107
# SDS: /metaspec.sds.* (8 commands) - Define specification
108108
# SDD: /metaspec.sdd.* (8 commands) - Develop toolkit
109109
# Evolution: /metaspec.* (3 commands) - Manage changes

src/metaspec/templates/base/.metaspec/README.md.j2

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,15 +18,18 @@ If you just want to **use** {{ name }}, see the root `AGENTS.md` and `README.md`
1818

1919
## 🏗️ MetaSpec Architecture
2020

21-
This speckit includes 16 AI-assisted development commands organized in three layers:
21+
This speckit includes 19 AI-assisted development commands organized in three layers:
2222

23-
### Layer 1: SDS (Spec-Driven Specification) - 5 Commands
23+
### Layer 1: SDS (Spec-Driven Specification) - 8 Commands
2424

2525
Define domain domain specifications:
2626

2727
- `/metaspec.sds.constitution` - Define specification design principles
2828
- `/metaspec.sds.specify` - Define specification entities, operations, validation rules
2929
- `/metaspec.sds.clarify` - Resolve ambiguities in domain specification
30+
- `/metaspec.sds.plan` - Plan specification architecture and sub-specifications
31+
- `/metaspec.sds.tasks` - Break down specification work
32+
- `/metaspec.sds.implement` - Write specification documents
3033
- `/metaspec.sds.checklist` - Generate quality checklist for specification
3134
- `/metaspec.sds.analyze` - Check specification consistency
3235

@@ -168,7 +171,7 @@ MetaSpec commands support iteration modes to track progress:
168171
│ └── {{ package_name }}/
169172
└── .metaspec/
170173
├── README.md ← You are here
171-
├── commands/ ← 16 MetaSpec commands
174+
├── commands/ ← 19 MetaSpec commands
172175
└── templates/ ← Output format templates
173176
```
174177

src/metaspec/templates/base/AGENTS.md.j2

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -268,7 +268,7 @@ See `examples/` directory for:
268268
If you want to **develop or maintain** {{ name }} itself (not just use it), see:
269269

270270
- **`.metaspec/README.md`** - Complete development guide
271-
- **`.metaspec/commands/`** - 16 AI-assisted MetaSpec commands
271+
- **`.metaspec/commands/`** - 19 AI-assisted MetaSpec commands (8 SDS + 8 SDD + 3 Evolution)
272272

273273
This includes specifications for defining specifications (SDS), developing toolkit features (SDD), and managing changes (Evolution).
274274

0 commit comments

Comments
 (0)