@@ -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
61612 . ** 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
125125Generated 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