sdd-mcp-server 3.2.0 → 3.4.0
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 +63 -27
- package/dist/adapters/cli/SDDToolAdapter.d.ts +5 -1
- package/dist/adapters/cli/SDDToolAdapter.js +108 -15
- package/dist/adapters/cli/SDDToolAdapter.js.map +1 -1
- package/dist/application/services/ContextCompactionService.d.ts +39 -0
- package/dist/application/services/ContextCompactionService.js +253 -0
- package/dist/application/services/ContextCompactionService.js.map +1 -0
- package/dist/application/services/ProjectService.d.ts +7 -1
- package/dist/application/services/ProjectService.js +56 -1
- package/dist/application/services/ProjectService.js.map +1 -1
- package/dist/application/services/TemplateService.js +27 -5
- package/dist/application/services/TemplateService.js.map +1 -1
- package/dist/application/services/WorkflowEngineService.d.ts +3 -1
- package/dist/application/services/WorkflowEngineService.js +20 -5
- package/dist/application/services/WorkflowEngineService.js.map +1 -1
- package/dist/application/services/WorkflowService.js +8 -0
- package/dist/application/services/WorkflowService.js.map +1 -1
- package/dist/application/services/staticSteering.js +10 -9
- package/dist/application/services/staticSteering.js.map +1 -1
- package/dist/cli/install-skills.d.ts +10 -0
- package/dist/cli/install-skills.js +79 -64
- package/dist/cli/install-skills.js.map +1 -1
- package/dist/cli/sdd-mcp-cli.js +7 -0
- package/dist/cli/sdd-mcp-cli.js.map +1 -1
- package/dist/cli/tool-support/antigravity.d.ts +18 -0
- package/dist/cli/tool-support/antigravity.js +79 -0
- package/dist/cli/tool-support/antigravity.js.map +1 -0
- package/dist/cli/tool-support/codex.d.ts +43 -0
- package/dist/cli/tool-support/codex.js +91 -0
- package/dist/cli/tool-support/codex.js.map +1 -0
- package/dist/cli/tool-support/index.d.ts +4 -0
- package/dist/cli/tool-support/index.js +3 -0
- package/dist/cli/tool-support/index.js.map +1 -0
- package/dist/cli/utils/find-package-root.d.ts +23 -0
- package/dist/cli/utils/find-package-root.js +87 -0
- package/dist/cli/utils/find-package-root.js.map +1 -0
- package/dist/domain/services/DomainService.d.ts +1 -0
- package/dist/domain/services/DomainService.js +12 -2
- package/dist/domain/services/DomainService.js.map +1 -1
- package/dist/domain/types.d.ts +13 -0
- package/dist/domain/types.js.map +1 -1
- package/dist/domain/workflow/WorkflowStateMachine.js +7 -2
- package/dist/domain/workflow/WorkflowStateMachine.js.map +1 -1
- package/dist/index.js +341 -20
- package/dist/index.js.map +1 -1
- package/dist/infrastructure/di/container.js +4 -0
- package/dist/infrastructure/di/container.js.map +1 -1
- package/dist/infrastructure/di/types.d.ts +1 -0
- package/dist/infrastructure/di/types.js +1 -0
- package/dist/infrastructure/di/types.js.map +1 -1
- package/dist/infrastructure/mcp/ResourceManager.js +21 -1
- package/dist/infrastructure/mcp/ResourceManager.js.map +1 -1
- package/dist/infrastructure/mcp/ToolRegistry.js +34 -2
- package/dist/infrastructure/mcp/ToolRegistry.js.map +1 -1
- package/dist/infrastructure/schemas/project.schema.d.ts +47 -4
- package/dist/infrastructure/schemas/project.schema.js +39 -2
- package/dist/infrastructure/schemas/project.schema.js.map +1 -1
- package/dist/utils/sddPaths.d.ts +69 -0
- package/dist/utils/sddPaths.js +138 -0
- package/dist/utils/sddPaths.js.map +1 -0
- package/package.json +2 -2
- package/skills/sdd-implement/SKILL.md +6 -4
- package/skills/sdd-tasks/SKILL.md +20 -7
- package/templates/codex-AGENTS.md +22 -0
|
@@ -52,7 +52,17 @@ For each task, follow the Red-Green-Refactor cycle:
|
|
|
52
52
|
└─────────────────────────────────────────────────────────────┘
|
|
53
53
|
```
|
|
54
54
|
|
|
55
|
-
### Step 4:
|
|
55
|
+
### Step 4: Choose Test Case Review Checkpoint
|
|
56
|
+
|
|
57
|
+
Ask the user whether they want to review TDD test cases before implementation:
|
|
58
|
+
|
|
59
|
+
- If yes, enable the checkpoint when generating tasks by setting `reviewTestCases: true` where the MCP tool supports it, or record the choice in `spec.json` under `workflow_options.review_test_cases`.
|
|
60
|
+
- Generate a concise **Test Case Review Checklist** in `tasks.md` listing the behavior, edge, and error scenarios that need approval.
|
|
61
|
+
- Before approving tasks, the user or agent should run `sdd-review-test-cases` after reviewing the test cases.
|
|
62
|
+
|
|
63
|
+
Keep this checkpoint optional. If the user declines, continue with normal task approval.
|
|
64
|
+
|
|
65
|
+
### Step 5: Apply Test Pyramid
|
|
56
66
|
|
|
57
67
|
Structure tests following the 70/20/10 ratio:
|
|
58
68
|
|
|
@@ -75,7 +85,7 @@ Structure tests following the 70/20/10 ratio:
|
|
|
75
85
|
| **Integration** | 20% | Component interactions | Medium (s) |
|
|
76
86
|
| **E2E** | 10% | Full user journeys | Slow (min) |
|
|
77
87
|
|
|
78
|
-
### Step
|
|
88
|
+
### Step 6: Generate Task Breakdown
|
|
79
89
|
|
|
80
90
|
Structure tasks hierarchically:
|
|
81
91
|
|
|
@@ -131,11 +141,12 @@ Structure tasks hierarchically:
|
|
|
131
141
|
- [ ] All tests pass
|
|
132
142
|
- [ ] Code coverage >= 80%
|
|
133
143
|
- [ ] No lint/type errors
|
|
144
|
+
- [ ] TDD test cases reviewed (if checkpoint enabled)
|
|
134
145
|
- [ ] Code reviewed
|
|
135
146
|
- [ ] Documentation updated
|
|
136
147
|
```
|
|
137
148
|
|
|
138
|
-
### Step
|
|
149
|
+
### Step 7: Task Sizing Guidelines
|
|
139
150
|
|
|
140
151
|
| Size | Description | Test Count | Time |
|
|
141
152
|
|------|-------------|------------|------|
|
|
@@ -144,7 +155,7 @@ Structure tasks hierarchically:
|
|
|
144
155
|
| **L** | Component with integration | 5-10 | 4-8 hours |
|
|
145
156
|
| **XL** | Complex component, many edge cases | 10+ | 1-2 days |
|
|
146
157
|
|
|
147
|
-
### Step
|
|
158
|
+
### Step 8: Test-First Task Template
|
|
148
159
|
|
|
149
160
|
For each implementation task:
|
|
150
161
|
|
|
@@ -196,17 +207,19 @@ describe('{Component}', () => {
|
|
|
196
207
|
- Apply {specific pattern}
|
|
197
208
|
```
|
|
198
209
|
|
|
199
|
-
### Step
|
|
210
|
+
### Step 9: Save and Execute
|
|
200
211
|
|
|
201
212
|
1. Save tasks to `.spec/specs/{feature}/tasks.md`
|
|
202
|
-
2.
|
|
203
|
-
3. Use `sdd-
|
|
213
|
+
2. If test-case review is enabled, review the Test Case Review Checklist and run `sdd-review-test-cases`
|
|
214
|
+
3. Use `sdd-approve tasks` MCP tool to mark phase complete
|
|
215
|
+
4. Use `sdd-spec-impl` MCP tool to execute tasks with TDD
|
|
204
216
|
|
|
205
217
|
## MCP Tool Integration
|
|
206
218
|
|
|
207
219
|
| Tool | When to Use |
|
|
208
220
|
|------|-------------|
|
|
209
221
|
| `sdd-status` | Verify design phase complete |
|
|
222
|
+
| `sdd-review-test-cases` | Mark optional TDD test-case review complete |
|
|
210
223
|
| `sdd-approve` | Mark tasks phase as approved |
|
|
211
224
|
| `sdd-spec-impl` | Execute tasks using TDD methodology |
|
|
212
225
|
| `sdd-quality-check` | Validate code quality during implementation |
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# AGENTS.md — Spec-Driven Development (SDD)
|
|
2
|
+
|
|
3
|
+
This project uses the SDD workflow powered by `sdd-mcp-server`.
|
|
4
|
+
|
|
5
|
+
## Development Paths
|
|
6
|
+
|
|
7
|
+
### Simple Tasks
|
|
8
|
+
For small features, bug fixes, and quick enhancements — just start coding with best practices.
|
|
9
|
+
|
|
10
|
+
### Full SDD Workflow
|
|
11
|
+
For complex features requiring formal specification:
|
|
12
|
+
|
|
13
|
+
```
|
|
14
|
+
Initialize → Requirements → Design → Tasks → Implement
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Each phase builds on the previous and requires review before proceeding.
|
|
18
|
+
|
|
19
|
+
## Installed Components
|
|
20
|
+
|
|
21
|
+
The SDD components are stored in `.claude/` directories. Read the referenced files for full details.
|
|
22
|
+
|