Skip to content

Commit bc97ddf

Browse files
committed
Fix terminology inconsistencies
- AGENTS.md: Change Example 1 from MCP-specific to generic - templates/meta/README.md: Unify all 'protocol' → 'specification' - Update SDS command descriptions - Update command table - Update workflow examples - Update MCP speckit example
1 parent 1d9d355 commit bc97ddf

File tree

2 files changed

+27
-27
lines changed

2 files changed

+27
-27
lines changed

AGENTS.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -572,13 +572,13 @@ examples/
572572
cd my-speckit
573573
# Phase 1: Define specification
574574
/metaspec.sds.constitution # Define specification design principles
575-
/metaspec.sds.specify "Define MCP specification" # Specification entities
575+
/metaspec.sds.specify "Define domain specification" # Specification entities
576576
/metaspec.sds.checklist # Generate quality checklist
577577
/metaspec.sds.analyze # Check specification consistency
578578

579579
# Phase 2: Design toolkit
580580
/metaspec.sdd.constitution # Define toolkit principles
581-
/metaspec.sdd.specify "Define MCP parser and validator" # Toolkit spec
581+
/metaspec.sdd.specify "Define parser and validator" # Toolkit spec
582582
/metaspec.sdd.plan # Architecture design
583583
```
584584

src/metaspec/templates/meta/README.md

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -52,10 +52,10 @@ meta/
5252

5353
### Why Three Layers?
5454

55-
1. **SDS (Spec-Driven Specification)** - Define protocol specifications
56-
- Goal: Define WHAT (what the protocol is)
55+
1. **SDS (Spec-Driven Specification)** - Define domain specifications
56+
- Goal: Define WHAT (what the specification is)
5757
- Output: `specs/protocol/` directory
58-
- Examples: Define MCP protocol, OpenAPI specification
58+
- Examples: Define MCP specification, OpenAPI specification
5959
- **Status**: Primary, core asset
6060

6161
2. **SDD (Spec-Driven Development)** - Develop toolkits
@@ -109,7 +109,7 @@ MetaSpec realizes toolkit value through a three-stage process:
109109

110110
**Actual Usage**:
111111
```bash
112-
/metaspec.sds.specify "MCP protocol" # Protocol
112+
/metaspec.sds.specify "MCP specification" # Specification
113113
/metaspec.sdd.specify "TS toolkit" # Toolkit (select language, components)
114114
/metaspec.sdd.plan # Design architecture
115115
/metaspec.sdd.implement # Generate code
@@ -120,24 +120,24 @@ See: `/metaspec.sdd.specify`, `/metaspec.sdd.plan`, `/metaspec.sdd.implement`
120120

121121
## Command List
122122

123-
### SDS Commands (8) - Protocol Specification
123+
### SDS Commands (8) - Domain Specification
124124

125125
Generated command prefix: `/metaspec.sds.*`
126126

127127
| Command | Purpose | Output |
128128
|------|------|------|
129-
| `constitution` | Define protocol design principles | memory/constitution.md |
130-
| `specify` | Define protocol entities and rules | specs/protocol/00X-name/spec.md |
131-
| `clarify` | Resolve protocol ambiguities | Update spec.md |
132-
| `plan` | Plan protocol architecture and sub-specifications | specs/protocol/00X-name/plan.md |
133-
| `tasks` | Break down protocol specification work | specs/protocol/00X-name/tasks.md |
134-
| `implement` | Write protocol specification documents | Create/update spec files |
135-
| `checklist` | Generate quality checklist for protocol | specs/protocol/00X-name/checklists/ |
136-
| `analyze` | Check protocol consistency | Analysis report |
129+
| `constitution` | Define specification design principles | memory/constitution.md |
130+
| `specify` | Define specification entities and rules | specs/protocol/00X-name/spec.md |
131+
| `clarify` | Resolve specification ambiguities | Update spec.md |
132+
| `plan` | Plan specification architecture and sub-specifications | specs/protocol/00X-name/plan.md |
133+
| `tasks` | Break down specification work | specs/protocol/00X-name/tasks.md |
134+
| `implement` | Write specification documents | Create/update spec files |
135+
| `checklist` | Generate quality checklist for specification | specs/protocol/00X-name/checklists/ |
136+
| `analyze` | Check specification consistency | Analysis report |
137137

138138
**Use Cases**:
139-
- Define domain protocols (e.g., MCP, GraphQL)
140-
- Plan and implement complex protocol hierarchies
139+
- Define domain specifications (e.g., MCP, GraphQL)
140+
- Plan and implement complex specification hierarchies
141141
- Define validation rules and constraints
142142
- Implementation-independent specifications
143143

@@ -377,15 +377,15 @@ target: protocol/001-mcp-core # Change target (relative to specs/)
377377
378378
### Recommended Practice: SDS + SDD Separation
379379
380-
#### Phase 1: Protocol Specification (SDS)
380+
#### Phase 1: Domain Specification (SDS)
381381
382382
```bash
383-
# Define protocol principles
383+
# Define specification design principles
384384
/metaspec.sds.constitution
385385

386-
# Create protocol specification
387-
/metaspec.sds.specify "MCP Server Protocol"
388-
# Output: specs/protocol/001-mcp-server-protocol/spec.md
386+
# Create domain specification
387+
/metaspec.sds.specify "MCP Server Specification"
388+
# Output: specs/protocol/001-mcp-server-specification/spec.md
389389

390390
# Clarify details
391391
/metaspec.sds.clarify
@@ -490,15 +490,15 @@ Because Evolution is a **shared** mechanism for SDS and SDD:
490490
## Example: Using MetaSpec to Develop MCP Speckit
491491

492492
```bash
493-
# Phase 1: Define MCP protocol (SDS)
494-
/metaspec.sds.constitution # Define protocol principles
495-
/metaspec.sds.specify "MCP Protocol Core"
496-
# → specs/protocol/001-mcp-protocol-core/spec.md
493+
# Phase 1: Define MCP specification (SDS)
494+
/metaspec.sds.constitution # Define specification design principles
495+
/metaspec.sds.specify "MCP Specification Core"
496+
# → specs/protocol/001-mcp-specification-core/spec.md
497497

498498
# Phase 2: Develop MCP Parser (SDD)
499499
/metaspec.sdd.specify "MCP Request Parser"
500500
# → specs/toolkit/001-mcp-request-parser/spec.md
501-
# → Explicit reference: depends on protocol/001-mcp-protocol-core
501+
# → Explicit reference: depends on protocol/001-mcp-specification-core
502502

503503
/metaspec.sdd.plan # Plan implementation
504504
/metaspec.sdd.tasks # Break down tasks

0 commit comments

Comments
 (0)