sdd-mcp-server 3.5.0 → 3.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
A Model Context Protocol (MCP) server implementing Spec-Driven Development (SDD) workflows for AI-agent CLIs and IDEs like Claude Code, Cursor, and others.
|
|
8
8
|
|
|
9
|
-
> **v3.5.
|
|
9
|
+
> **v3.5.1** - Target-aware native Codex and Claude Code installation with Sol/xhigh high-level routing and Sol/medium implementation routing. See [CHANGELOG.md](CHANGELOG.md) for full version history.
|
|
10
10
|
|
|
11
11
|
## Why sdd-mcp?
|
|
12
12
|
|
|
@@ -35,7 +35,7 @@ Use `sdd-mcp` when you want the AI assistant to follow a governed lifecycle, not
|
|
|
35
35
|
npx -y sdd-mcp-server@latest
|
|
36
36
|
|
|
37
37
|
# Pin exact version (optional)
|
|
38
|
-
npx -y sdd-mcp-server@3.5.
|
|
38
|
+
npx -y sdd-mcp-server@3.5.1
|
|
39
39
|
|
|
40
40
|
# For Claude Code MCP integration, add to your configuration:
|
|
41
41
|
# "sdd-mcp-server": {
|
|
@@ -50,7 +50,7 @@ npx -y sdd-mcp-server@3.5.0
|
|
|
50
50
|
npm install -g sdd-mcp-server@latest
|
|
51
51
|
|
|
52
52
|
# Pin exact version (optional)
|
|
53
|
-
npm install -g sdd-mcp-server@3.5.
|
|
53
|
+
npm install -g sdd-mcp-server@3.5.1
|
|
54
54
|
|
|
55
55
|
# Start the server
|
|
56
56
|
sdd-mcp-server
|
|
@@ -159,14 +159,14 @@ npm install -g sdd-mcp-server@latest
|
|
|
159
159
|
sdd-mcp-server
|
|
160
160
|
```
|
|
161
161
|
|
|
162
|
-
## 🎯 Agent Skills & Components (v3.5.
|
|
162
|
+
## 🎯 Agent Skills & Components (v3.5.1)
|
|
163
163
|
|
|
164
164
|
SDD now uses a **hybrid architecture** for better token efficiency:
|
|
165
165
|
|
|
166
166
|
- **MCP Tools**: Action-oriented operations (init, status, approve, quality-check, validate, spec-impl)
|
|
167
167
|
- **Agent Skills**: Template/guidance-heavy operations (requirements, design, tasks, steering, implement, commit)
|
|
168
168
|
|
|
169
|
-
### Installing Components (v3.5.
|
|
169
|
+
### Installing Components (v3.5.1)
|
|
170
170
|
|
|
171
171
|
```bash
|
|
172
172
|
# Lean compatibility install (defaults to Claude Code when non-interactive)
|
|
@@ -217,9 +217,9 @@ The installer creates only the selected primary target's native artifacts, prese
|
|
|
217
217
|
| Work | Codex | Claude Code |
|
|
218
218
|
|------|-------|-------------|
|
|
219
219
|
| Planning, architecture, review, security | `gpt-5.6-sol` (`xhigh`) | `opus` |
|
|
220
|
-
| Implementation and TDD (default) | `gpt-5.6-
|
|
220
|
+
| Implementation and TDD (default) | `gpt-5.6-sol` (`medium`) | `sonnet` |
|
|
221
221
|
|
|
222
|
-
Codex uses `gpt-5.6-
|
|
222
|
+
Codex uses `gpt-5.6-sol` as the default model for routed work. High-level advisor roles use xhigh effort, while implementation and TDD roles use medium effort. `gpt-5.6-luna` and `gpt-5.6-terra` remain supported model identifiers but are not selected by a default SDD role.
|
|
223
223
|
For a detailed explanation of role selection, native agent metadata, delegation, and rerun behavior, see [Model Routing](docs/MODEL-ROUTING.md).
|
|
224
224
|
|
|
225
225
|
### Component Architecture & Relationships
|
|
@@ -278,7 +278,7 @@ The 6 component types work together in a **layered guidance model**:
|
|
|
278
278
|
│
|
|
279
279
|
▼
|
|
280
280
|
┌──────────────────────────────────────────────────────────────┐
|
|
281
|
-
│ STEERING (project-specific templates - v3.5.
|
|
281
|
+
│ STEERING (project-specific templates - v3.5.1) │
|
|
282
282
|
│ • product.md → Product description │
|
|
283
283
|
│ • tech.md → Technology stack │
|
|
284
284
|
│ • structure.md → Project structure │
|
|
@@ -544,7 +544,7 @@ claude mcp add sdd "sdd-mcp-server"
|
|
|
544
544
|
- **EARS-Formatted Requirements**: Generate acceptance criteria based on actual npm scripts and dependencies
|
|
545
545
|
- **Quality Enforcement**: Linus-style 5-layer code review system with security (OWASP Top 10) checks
|
|
546
546
|
|
|
547
|
-
### Plugin Architecture (v3.5.
|
|
547
|
+
### Plugin Architecture (v3.5.1)
|
|
548
548
|
- **6 Component Types**: Skills, Steering, Rules, Contexts, Agents, Hooks for comprehensive AI guidance
|
|
549
549
|
- **Specialized Agents**: Planner, Architect, Reviewer, Implementer, Security-Auditor, TDD-Guide personas
|
|
550
550
|
- **Always-Active Rules**: Coding-style, Testing, Security, Git-workflow, Error-handling enforcement
|
|
@@ -694,13 +694,13 @@ For detailed documentation on:
|
|
|
694
694
|
- **Plugin Development**: See [DEPLOYMENT.md](DEPLOYMENT.md)
|
|
695
695
|
- **Docker Deployment**: See [Dockerfile](Dockerfile) and [docker-compose.yml](docker-compose.yml)
|
|
696
696
|
|
|
697
|
-
**Component Documentation (v3.5.
|
|
697
|
+
**Component Documentation (v3.5.1)**:
|
|
698
698
|
- **Rules**: See `rules/*.md` for always-active coding guidelines
|
|
699
699
|
- **Contexts**: See `contexts/*.md` for mode-specific system prompts
|
|
700
700
|
- **Agents**: See `agents/*.md` for specialized AI personas
|
|
701
701
|
- **Hooks**: See `hooks/**/*.md` for event-driven automation
|
|
702
702
|
|
|
703
|
-
**Steering Documents (v3.5.
|
|
703
|
+
**Steering Documents (v3.5.1)**:
|
|
704
704
|
|
|
705
705
|
Static steering content has been consolidated into enhanced components:
|
|
706
706
|
- **Design Principles**: `rules/coding-style.md` (includes SOLID, DRY, KISS, YAGNI, SoC)
|
|
@@ -600,7 +600,7 @@ After installation, use skills in the selected agent:
|
|
|
600
600
|
/sdd-test-gen [file-path]
|
|
601
601
|
|
|
602
602
|
Model Routing:
|
|
603
|
-
Codex high-level roles: gpt-5.6-sol (xhigh); default implementation/TDD: gpt-5.6-
|
|
603
|
+
Codex high-level roles: gpt-5.6-sol (xhigh); default implementation/TDD: gpt-5.6-sol (medium)
|
|
604
604
|
Codex supported models: gpt-5.6-sol, gpt-5.6-luna, gpt-5.6-terra
|
|
605
605
|
Claude Code high-level roles: opus; implementation/TDD: sonnet
|
|
606
606
|
`;
|
|
@@ -57,13 +57,13 @@ export declare class InstallCancelledError extends Error {
|
|
|
57
57
|
constructor();
|
|
58
58
|
}
|
|
59
59
|
export declare const SUPPORTED_CODEX_MODELS: readonly ["gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna"];
|
|
60
|
-
export declare const DEFAULT_CODEX_MODEL: "gpt-5.6-
|
|
60
|
+
export declare const DEFAULT_CODEX_MODEL: "gpt-5.6-sol";
|
|
61
61
|
export declare const ROLE_MODEL_ROUTES: {
|
|
62
62
|
readonly planner: {
|
|
63
63
|
readonly taskClass: "high-level" | "implementation";
|
|
64
64
|
readonly codex: {
|
|
65
65
|
readonly model: "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna";
|
|
66
|
-
readonly reasoningEffort: "
|
|
66
|
+
readonly reasoningEffort: "medium" | "xhigh";
|
|
67
67
|
};
|
|
68
68
|
readonly claudeCode: {
|
|
69
69
|
readonly model: "opus" | "sonnet";
|
|
@@ -73,7 +73,7 @@ export declare const ROLE_MODEL_ROUTES: {
|
|
|
73
73
|
readonly taskClass: "high-level" | "implementation";
|
|
74
74
|
readonly codex: {
|
|
75
75
|
readonly model: "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna";
|
|
76
|
-
readonly reasoningEffort: "
|
|
76
|
+
readonly reasoningEffort: "medium" | "xhigh";
|
|
77
77
|
};
|
|
78
78
|
readonly claudeCode: {
|
|
79
79
|
readonly model: "opus" | "sonnet";
|
|
@@ -83,7 +83,7 @@ export declare const ROLE_MODEL_ROUTES: {
|
|
|
83
83
|
readonly taskClass: "high-level" | "implementation";
|
|
84
84
|
readonly codex: {
|
|
85
85
|
readonly model: "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna";
|
|
86
|
-
readonly reasoningEffort: "
|
|
86
|
+
readonly reasoningEffort: "medium" | "xhigh";
|
|
87
87
|
};
|
|
88
88
|
readonly claudeCode: {
|
|
89
89
|
readonly model: "opus" | "sonnet";
|
|
@@ -93,7 +93,7 @@ export declare const ROLE_MODEL_ROUTES: {
|
|
|
93
93
|
readonly taskClass: "high-level" | "implementation";
|
|
94
94
|
readonly codex: {
|
|
95
95
|
readonly model: "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna";
|
|
96
|
-
readonly reasoningEffort: "
|
|
96
|
+
readonly reasoningEffort: "medium" | "xhigh";
|
|
97
97
|
};
|
|
98
98
|
readonly claudeCode: {
|
|
99
99
|
readonly model: "opus" | "sonnet";
|
|
@@ -103,7 +103,7 @@ export declare const ROLE_MODEL_ROUTES: {
|
|
|
103
103
|
readonly taskClass: "high-level" | "implementation";
|
|
104
104
|
readonly codex: {
|
|
105
105
|
readonly model: "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna";
|
|
106
|
-
readonly reasoningEffort: "
|
|
106
|
+
readonly reasoningEffort: "medium" | "xhigh";
|
|
107
107
|
};
|
|
108
108
|
readonly claudeCode: {
|
|
109
109
|
readonly model: "opus" | "sonnet";
|
|
@@ -113,7 +113,7 @@ export declare const ROLE_MODEL_ROUTES: {
|
|
|
113
113
|
readonly taskClass: "high-level" | "implementation";
|
|
114
114
|
readonly codex: {
|
|
115
115
|
readonly model: "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna";
|
|
116
|
-
readonly reasoningEffort: "
|
|
116
|
+
readonly reasoningEffort: "medium" | "xhigh";
|
|
117
117
|
};
|
|
118
118
|
readonly claudeCode: {
|
|
119
119
|
readonly model: "opus" | "sonnet";
|
|
@@ -16,14 +16,14 @@ export const SUPPORTED_CODEX_MODELS = [
|
|
|
16
16
|
'gpt-5.6-terra',
|
|
17
17
|
'gpt-5.6-luna',
|
|
18
18
|
];
|
|
19
|
-
export const DEFAULT_CODEX_MODEL = 'gpt-5.6-
|
|
19
|
+
export const DEFAULT_CODEX_MODEL = 'gpt-5.6-sol';
|
|
20
20
|
export const ROLE_MODEL_ROUTES = {
|
|
21
21
|
planner: route('high-level', 'gpt-5.6-sol', 'xhigh', 'opus'),
|
|
22
22
|
architect: route('high-level', 'gpt-5.6-sol', 'xhigh', 'opus'),
|
|
23
23
|
reviewer: route('high-level', 'gpt-5.6-sol', 'xhigh', 'opus'),
|
|
24
24
|
'security-auditor': route('high-level', 'gpt-5.6-sol', 'xhigh', 'opus'),
|
|
25
|
-
implementer: route('implementation', DEFAULT_CODEX_MODEL, '
|
|
26
|
-
'tdd-guide': route('implementation', DEFAULT_CODEX_MODEL, '
|
|
25
|
+
implementer: route('implementation', DEFAULT_CODEX_MODEL, 'medium', 'sonnet'),
|
|
26
|
+
'tdd-guide': route('implementation', DEFAULT_CODEX_MODEL, 'medium', 'sonnet'),
|
|
27
27
|
};
|
|
28
28
|
function route(taskClass, model, reasoningEffort, claudeModel) {
|
|
29
29
|
return {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"install-target.js","sourceRoot":"","sources":["../../src/cli/install-target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAqE7B,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C;QACE,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,aAAa;IACb,eAAe;IACf,cAAc;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG,
|
|
1
|
+
{"version":3,"file":"install-target.js","sourceRoot":"","sources":["../../src/cli/install-target.ts"],"names":[],"mappings":"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"}
|