Skip to content

Commit 49efa41

Browse files
committed
docs: unify terminology in core documentation
- README.md: Update all SDS command descriptions - 'protocol' → 'specification' - 'protocol principles' → 'specification design principles' - CHANGELOG.md: Update v0.5.0 and historical versions - Recursive tree structure description - New SDS commands description - v0.4.1 and v0.1.3 feature descriptions
1 parent bc97ddf commit 49efa41

File tree

2 files changed

+35
-35
lines changed

2 files changed

+35
-35
lines changed

CHANGELOG.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -13,17 +13,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1313

1414
### ✨ Features
1515

16-
**Recursive Tree Structure for SDS Protocols**
16+
**Recursive Tree Structure for SDS Specifications**
1717

18-
SDS now supports hierarchical protocol specifications with unlimited depth:
18+
SDS now supports hierarchical domain specifications with unlimited depth:
1919

2020
- **Physical Structure**: Flat directory layout under `specs/protocol/`
21-
- All protocols are sibling directories (e.g., `001-root/`, `002-child/`, `013-grandchild/`)
21+
- All specifications are sibling directories (e.g., `001-root/`, `002-child/`, `013-grandchild/`)
2222
- Simple paths, FEATURE independence, Git branch friendly
2323

2424
- **Logical Structure**: Tree hierarchy via YAML frontmatter
2525
- Parent-child relationships declared in `spec.md` frontmatter
26-
- Context tracking: `protocol_id`, `parent`, `root`, `type` (leaf/parent/root)
26+
- Context tracking: `spec_id`, `parent`, `root`, `type` (leaf/parent/root)
2727
- Parent → Child: Listed in "Sub-Specifications" table
2828
- Child → Parent: Shown in "Parent chain" breadcrumb
2929

@@ -36,22 +36,22 @@ SDS now supports hierarchical protocol specifications with unlimited depth:
3636

3737
**New SDS Commands** (8 total, up from 5)
3838

39-
Added 3 new commands for complex protocol specification:
39+
Added 3 new commands for complex specification definition:
4040

41-
1. `/metaspec.sds.plan` - Plan protocol architecture and sub-specifications
41+
1. `/metaspec.sds.plan` - Plan specification architecture and sub-specifications
4242
- Assess complexity score (line count, entities, operations)
43-
- Decide: Keep single specification vs Split into sub-protocols
43+
- Decide: Keep single specification vs Split into sub-specifications
4444
- Design sub-specification structure if complex
4545

46-
2. `/metaspec.sds.tasks` - Break down protocol specification work
46+
2. `/metaspec.sds.tasks` - Break down specification work
4747
- Generate actionable task list organized by sub-specification
48-
- Track dependencies between sub-protocols
48+
- Track dependencies between sub-specifications
4949
- Include parent/root context for recursive structure
5050

51-
3. `/metaspec.sds.implement` - Write protocol specification documents
52-
- Create new protocol FEATUREs (independent `00X-` directories)
51+
3. `/metaspec.sds.implement` - Write specification documents
52+
- Create new specification FEATUREs (independent `00X-` directories)
5353
- Call `/metaspec.sds.specify` internally with context
54-
- Update parent protocol's "Sub-Specifications" section
54+
- Update parent specification's "Sub-Specifications" section
5555
- Support recursive splitting at any depth
5656

5757
**Command Total**: 19 commands (8 SDS + 8 SDD + 3 Evolution)
@@ -750,15 +750,15 @@ examples/
750750
- Generic templates (init, validate, generate)
751751

752752
**New Understanding** ✅:
753-
- Slash Commands = "Spec-driven execution guides with embedded protocol knowledge"
754-
- AI reads Slash Command (with protocol knowledge) → produces spec-compliant output
755-
- Commands derived from protocol specification
753+
- Slash Commands = "Spec-driven execution guides with embedded specification knowledge"
754+
- AI reads Slash Command (with specification knowledge) → produces spec-compliant output
755+
- Commands derived from domain specification
756756

757757
#### Key Improvements
758758

759-
1. **Protocol-Driven Command Derivation**
760-
- Added STEP 1: Analyze protocol specification
761-
- Added STEP 2: Derive commands from protocol content
759+
1. **Specification-Driven Command Derivation**
760+
- Added STEP 1: Analyze domain specification
761+
- Added STEP 2: Derive commands from specification content
762762
- Mapping rules: entities → get-template, validation_rules → validate, workflows → commands
763763

764764
2. **Workflow-Aware Command Generation**
@@ -958,8 +958,8 @@ CLI Commands (from toolkit purpose):
958958
## [0.1.3] - 2025-11-05
959959

960960
### ✨ New Features
961-
- **SDS Commands**: Added `/metaspec.sds.checklist` command for protocol quality validation
962-
- Generates systematic quality checklists for protocol specifications
961+
- **SDS Commands**: Added `/metaspec.sds.checklist` command for specification quality validation
962+
- Generates systematic quality checklists for domain specifications
963963
- Validates entity definitions, operations, validation rules, error handling
964964
- Complements `/metaspec.sds.analyze` with human review framework
965965
- Aligns with GitHub spec-kit best practices

README.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -256,15 +256,15 @@ metaspec init my-spec-kit
256256
# 2️⃣ DEVELOP: Use built-in MetaSpec slash commands (no installation needed)
257257
cd my-spec-kit
258258

259-
# SDS Commands (8) - Define protocol specification
260-
# /metaspec.sds.constitution - Define protocol principles
261-
# /metaspec.sds.specify - Define protocol entities and operations
262-
# /metaspec.sds.clarify - Resolve protocol ambiguities
263-
# /metaspec.sds.plan - Plan protocol architecture and sub-specifications
264-
# /metaspec.sds.tasks - Break down protocol specification work
265-
# /metaspec.sds.implement - Write protocol specification documents
266-
# /metaspec.sds.checklist - Generate quality checklist for protocol
267-
# /metaspec.sds.analyze - Check protocol consistency
259+
# SDS Commands (8) - Define domain specification
260+
# /metaspec.sds.constitution - Define specification design principles
261+
# /metaspec.sds.specify - Define specification entities and operations
262+
# /metaspec.sds.clarify - Resolve specification ambiguities
263+
# /metaspec.sds.plan - Plan specification architecture and sub-specifications
264+
# /metaspec.sds.tasks - Break down specification work
265+
# /metaspec.sds.implement - Write specification documents
266+
# /metaspec.sds.checklist - Generate quality checklist for specification
267+
# /metaspec.sds.analyze - Check specification consistency
268268

269269
# SDD Commands (8) - Develop spec-driven toolkit
270270
# /metaspec.sdd.constitution - Define toolkit principles
@@ -352,13 +352,13 @@ cd api-spec-kit
352352
pip install -e .
353353

354354
# Step 4: Define and implement using MetaSpec commands (in Cursor/AI editor)
355-
# Phase 1: Define protocol (SDS)
356-
# /metaspec.sds.constitution - Define protocol principles
357-
# /metaspec.sds.specify - Define protocol entities and operations
358-
# /metaspec.sds.plan - Plan protocol architecture (if complex)
355+
# Phase 1: Define specification (SDS)
356+
# /metaspec.sds.constitution - Define specification design principles
357+
# /metaspec.sds.specify - Define specification entities and operations
358+
# /metaspec.sds.plan - Plan specification architecture (if complex)
359359
# /metaspec.sds.tasks - Break down specification work
360-
# /metaspec.sds.implement - Write protocol specification documents
361-
# /metaspec.sds.analyze - Check protocol consistency
360+
# /metaspec.sds.implement - Write specification documents
361+
# /metaspec.sds.analyze - Check specification consistency
362362

363363
# Phase 2: Develop toolkit (SDD)
364364
# /metaspec.sdd.constitution - Define toolkit principles

0 commit comments

Comments
 (0)