specky-sdd 3.2.2 → 3.3.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/CHANGELOG.md +2 -2
- package/README.md +119 -158
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -36,7 +36,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
36
36
|
|
|
37
37
|
- **Server title**: MCP panel now shows "Specky" with description instead of raw binary name
|
|
38
38
|
- **Server icon**: SVG + PNG icons served from GitHub raw content, visible in VS Code MCP panel
|
|
39
|
-
- **Website URL**: Links to [
|
|
39
|
+
- **Website URL**: Links to [getspecky.ai](https://getspecky.ai) from server metadata
|
|
40
40
|
- **Instructions**: AI clients receive pipeline guidance during MCP handshake
|
|
41
41
|
- **Template path fix**: Templates now resolve from `dist/templates/` (self-contained npm package)
|
|
42
42
|
|
|
@@ -47,7 +47,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
47
47
|
- **Tool count**: Updated 56 → 57 across all documentation
|
|
48
48
|
- **EARS patterns**: Fixed 5 → 6 pattern count (includes Complex)
|
|
49
49
|
- **Broken links**: Fixed references to private files (CLAUDE.md, SYSTEM-DESIGN.md, ears-notation.md)
|
|
50
|
-
- **Site fixes**: Updated EARS count and footer links on [
|
|
50
|
+
- **Site fixes**: Updated EARS count and footer links on [getspecky.ai](https://getspecky.ai)
|
|
51
51
|
|
|
52
52
|
## [3.2.0] - 2026-04-12
|
|
53
53
|
|
package/README.md
CHANGED
|
@@ -2,14 +2,14 @@
|
|
|
2
2
|
<br>
|
|
3
3
|
<img src="media/specky-brand-logo.svg" alt="Specky" height="80">
|
|
4
4
|
<br><br>
|
|
5
|
-
<p><strong>57 MCP tools. 10-phase pipeline.
|
|
5
|
+
<p><strong>13 agents. 57 MCP tools. 10-phase pipeline. One plugin.</strong></p>
|
|
6
6
|
<p>Agentic Spec-Driven Development</p>
|
|
7
7
|
|
|
8
8
|
<p>
|
|
9
|
-
<img src="https://img.shields.io/badge/
|
|
10
|
-
<img src="https://img.shields.io/badge/
|
|
11
|
-
<img src="https://img.shields.io/badge/
|
|
12
|
-
<img src="https://img.shields.io/badge/
|
|
9
|
+
<img src="https://img.shields.io/badge/agents-13-7c3aed?style=flat-square" alt="13 Agents"/>
|
|
10
|
+
<img src="https://img.shields.io/badge/tools-57_MCP-6d28d9?style=flat-square" alt="57 Tools"/>
|
|
11
|
+
<img src="https://img.shields.io/badge/phases-10_enforced-5b21b6?style=flat-square" alt="10 Phases"/>
|
|
12
|
+
<img src="https://img.shields.io/badge/hooks-14-4c1d95?style=flat-square" alt="14 Hooks"/>
|
|
13
13
|
<img src="https://img.shields.io/badge/license-MIT-a78bfa?style=flat-square" alt="MIT"/>
|
|
14
14
|
</p>
|
|
15
15
|
|
|
@@ -21,9 +21,8 @@
|
|
|
21
21
|
</p>
|
|
22
22
|
|
|
23
23
|
<p>
|
|
24
|
-
<a href="https://
|
|
24
|
+
<a href="https://getspecky.ai">Website</a> ·
|
|
25
25
|
<a href="GETTING-STARTED.md">Getting Started</a> ·
|
|
26
|
-
<a href="plugins/specky-sdd/">Plugin</a> ·
|
|
27
26
|
<a href="https://www.npmjs.com/package/specky-sdd">npm</a> ·
|
|
28
27
|
<a href="SECURITY.md">Security</a>
|
|
29
28
|
</p>
|
|
@@ -35,12 +34,11 @@
|
|
|
35
34
|
| | Section | Description |
|
|
36
35
|
|---|---------|-------------|
|
|
37
36
|
| **Start** | [What is Specky?](#what-is-specky) | Overview and ecosystem |
|
|
37
|
+
| | [What is a Plugin?](#what-is-a-plugin) | Agents, prompts, skills, hooks, and APM |
|
|
38
38
|
| | [Why Specifications Matter](#why-specifications-matter-in-the-ai-era) | Vibe coding vs deterministic development |
|
|
39
39
|
| | [Getting Started](GETTING-STARTED.md) | Complete educational guide |
|
|
40
|
-
| **
|
|
41
|
-
| | [
|
|
42
|
-
| | [MCP Server Only](#install-mcp-server-only) | Lightweight: just the 57 MCP tools |
|
|
43
|
-
| **Use** | [Where Specifications Live](#where-specifications-live) | File structure and naming conventions |
|
|
40
|
+
| **Use** | [Quick Start](#quick-start) | Install the plugin via APM, curl, or npm |
|
|
41
|
+
| | [Where Specifications Live](#where-specifications-live) | File structure and naming conventions |
|
|
44
42
|
| | [Input Methods](#input-methods-6-ways-to-start) | 6 ways to feed Specky |
|
|
45
43
|
| | [Three Project Types](#three-project-types-one-pipeline) | Greenfield, Brownfield, Modernization |
|
|
46
44
|
| **Pipeline** | [Pipeline and LGTM Gates](#pipeline-and-lgtm-gates) | 10 phases with human review gates |
|
|
@@ -49,16 +47,46 @@
|
|
|
49
47
|
| **Enterprise** | [Compliance Frameworks](#compliance-frameworks) | HIPAA, SOC2, GDPR, PCI-DSS, ISO 27001 |
|
|
50
48
|
| | [Enterprise Ready](#enterprise-ready) | Security, audit trail, quality gates |
|
|
51
49
|
| **Platform** | [The SDD Platform](#the-spec-driven-development-platform) | Built on Spec-Kit, everything included |
|
|
52
|
-
| | [Roadmap](#roadmap) | v3.
|
|
50
|
+
| | [Roadmap](#roadmap) | v3.0 current, v3.1+ planned |
|
|
53
51
|
|
|
54
52
|
|
|
55
53
|
## What is Specky?
|
|
56
54
|
|
|
57
|
-
Specky is
|
|
55
|
+
Specky is a **complete Spec-Driven Development plugin** — 13 specialized agents, 57 MCP tools, 22 prompts, 8 skills, and 14 automation hooks — that enforces a deterministic 10-phase pipeline from **any input** (meeting transcripts, documents, Figma designs, or natural language prompts) through specifications, architecture, infrastructure as code, implementation, and deployment.
|
|
58
56
|
|
|
59
|
-
|
|
57
|
+
The plugin is powered by the [specky-sdd](https://www.npmjs.com/package/specky-sdd) MCP engine and the [Spec-Kit](https://github.com/paulasilvatech/spec-kit) methodology. Install Specky and you get **everything**: the agents orchestrate the pipeline, the tools enforce validation, the hooks guard every phase transition, and the skills provide domain knowledge.
|
|
60
58
|
|
|
61
|
-
|
|
59
|
+
|
|
60
|
+
## What is a Plugin?
|
|
61
|
+
|
|
62
|
+
A plugin is a **complete AI development package** — not just a tool server. It bundles everything your AI IDE needs into a single installable unit:
|
|
63
|
+
|
|
64
|
+
| Primitive | What it is | Specky includes |
|
|
65
|
+
|-----------|-----------|------------------|
|
|
66
|
+
| **Agents** | Specialized AI personas with defined roles, tools, and guardrails | 13 agents — @specky-orchestrator (full pipeline), @specky-onboarding (wizard), @spec-engineer, @design-architect, @task-planner, @quality-reviewer, and 7 more |
|
|
67
|
+
| **Prompts** | Slash commands that activate the right agent for a task | 22 prompts — `/specky-greenfield`, `/specky-specify`, `/specky-release`, `/specky-orchestrate`, etc. |
|
|
68
|
+
| **Skills** | Domain knowledge files loaded into agent context automatically | 8 skills — SDD pipeline rules, EARS patterns, implementation patterns, test criteria, release gate protocol |
|
|
69
|
+
| **Hooks** | Scripts that run before/after every tool call for validation | 14 hooks — artifact-validator, branch-validator, phase-gate, lgtm-gate, security-scan, etc. |
|
|
70
|
+
| **MCP Server** | The tool engine that validates, generates, and enforces | 57 tools via Model Context Protocol (the runtime underneath) |
|
|
71
|
+
|
|
72
|
+
### Why not just an MCP server?
|
|
73
|
+
|
|
74
|
+
An MCP server gives you **tools**. A plugin gives you the **experience**:
|
|
75
|
+
|
|
76
|
+
- **Tools alone**: You call `sdd_write_spec` and hope you're in the right phase, with the right prerequisites, on the right branch.
|
|
77
|
+
- **Plugin**: You type `@specky-orchestrator` and the agent validates your phase, checks your branch, loads the right skill, calls the right tool, runs pre/post hooks, and pauses for LGTM before advancing.
|
|
78
|
+
|
|
79
|
+
The MCP engine is the runtime. The plugin is the product.
|
|
80
|
+
|
|
81
|
+
### How to install
|
|
82
|
+
|
|
83
|
+
Specky is distributed via [APM](https://microsoft.github.io/apm/) (Agent Package Manager) — the `npm` for AI agent configuration, from Microsoft:
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
apm install paulasilvatech/specky
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
This single command installs all 13 agents, 22 prompts, 8 skills, 14 hooks, configures the MCP server, and generates a lock file (`apm.lock.yaml`) for version reproducibility. No manual setup, no configuration drift across your team. [Install APM](https://microsoft.github.io/apm/getting-started/installation/) if you don't have it yet.
|
|
62
90
|
|
|
63
91
|
|
|
64
92
|
## Why Specifications Matter in the AI Era
|
|
@@ -84,7 +112,8 @@ The result? Teams spend 40% of their time on rework because requirements were ne
|
|
|
84
112
|
| **Markdown** | The universal language that both humans and AI read fluently | All spec artifacts are `.md` files in your repo, versioned with Git |
|
|
85
113
|
| **MCP** | Model Context Protocol — an open standard that lets AI assistants call external tools | Specky is an MCP server; any AI IDE can connect to it |
|
|
86
114
|
| **EARS Notation** | A method for writing requirements that forces precision with 6 patterns | Eliminates vague statements like "the system should be fast" |
|
|
87
|
-
| **Agents and Skills** | Specialized AI roles that invoke Specky tools with domain expertise |
|
|
115
|
+
| **Agents and Skills** | Specialized AI roles that invoke Specky tools with domain expertise | 13 agents + 8 skills orchestrate the full pipeline |
|
|
116
|
+
| **Plugins** | A complete AI development package: agents + prompts + skills + hooks + MCP server | Installed via [APM](https://microsoft.github.io/apm/) — the `npm` for AI configuration |
|
|
88
117
|
|
|
89
118
|
### How Specky Enforces Determinism
|
|
90
119
|
|
|
@@ -101,18 +130,20 @@ Specky adds a **deterministic engine** between your intent and your code:
|
|
|
101
130
|
|
|
102
131
|
| Capability | Specky |
|
|
103
132
|
|---|---|
|
|
133
|
+
| Complete plugin experience | 13 agents, 22 prompts, 8 skills, 14 hooks + 57 MCP tools |
|
|
134
|
+
| Pipeline orchestrator | @specky-orchestrator coordinates all 10 phases end-to-end |
|
|
135
|
+
| Onboarding wizard | @specky-onboarding detects context and guides setup |
|
|
104
136
|
| Any input (PDF, DOCX, PPTX, transcript, Figma) to spec | 57 MCP tools handle all input formats |
|
|
105
137
|
| EARS validation (programmatic, not AI guessing) | 6 patterns enforced at schema level |
|
|
106
138
|
| Enforced pipeline (not suggestions) | 10 phases with actual gates that block advancement |
|
|
139
|
+
| Pre/post hooks on every phase | artifact-validator, branch-validator, phase-gate, lgtm-gate |
|
|
107
140
|
| 17 diagram types generated automatically | C4 (4 levels), sequence, ER, activity, use case, DFD, deployment, network |
|
|
108
141
|
| Infrastructure as Code | Terraform, Bicep, Dockerfile from DESIGN.md |
|
|
109
142
|
| Work item export | GitHub Issues, Azure Boards, Jira via MCP-to-MCP routing |
|
|
110
143
|
| 6 compliance frameworks | HIPAA, SOC2, GDPR, PCI-DSS, ISO 27001 built-in |
|
|
111
144
|
| Cross-artifact traceability | Requirement to design to task to test to code |
|
|
112
|
-
|
|
|
113
|
-
|
|
|
114
|
-
| Checkpoint/restore | Persistent snapshots of all spec artifacts |
|
|
115
|
-
| 10 automation hooks (2 blocking) | Security scan, release gate, spec sync, checkpoint, quality, EARS, task trace, drift, cognitive debt, metrics |
|
|
145
|
+
| Gitflow-SDD branching | spec/NNN → develop → stage → main |
|
|
146
|
+
| APM distribution | `apm install paulasilvatech/specky` — one command, everything works |
|
|
116
147
|
| Works in any MCP host | VS Code + Copilot, Claude Code, Cursor, Windsurf, or any MCP client |
|
|
117
148
|
| Zero outbound network calls | Fully air-gapped, code never leaves your machine |
|
|
118
149
|
| MIT open source | Fork it, extend it, audit it. No vendor lock, no seat pricing |
|
|
@@ -123,65 +154,33 @@ Specky adds a **deterministic engine** between your intent and your code:
|
|
|
123
154
|
### Prerequisites
|
|
124
155
|
|
|
125
156
|
- **Node.js 18+**: [Download here](https://nodejs.org/)
|
|
126
|
-
- **An AI IDE**: VS Code with Copilot, Claude Code,
|
|
127
|
-
|
|
128
|
-
### Install as Plugin (recommended)
|
|
157
|
+
- **An AI IDE**: VS Code with Copilot, Claude Code, Cursor, or Windsurf
|
|
129
158
|
|
|
130
|
-
|
|
159
|
+
### Install the Plugin
|
|
131
160
|
|
|
132
|
-
|
|
133
|
-
|-------------|:-:|:-:|
|
|
134
|
-
| 57 MCP tools | ✅ | ✅ |
|
|
135
|
-
| 7 specialized agents | — | ✅ |
|
|
136
|
-
| 19 reusable prompts | — | ✅ |
|
|
137
|
-
| 6 domain skills (SKILL.md) | — | ✅ |
|
|
138
|
-
| 10 automation hooks (2 blocking) | — | ✅ |
|
|
139
|
-
| EARS notation reference | — | ✅ |
|
|
140
|
-
| Model routing guidance | — | ✅ |
|
|
141
|
-
| Pipeline config (config.yml) | — | ✅ |
|
|
142
|
-
| `copilot plugin install` ready | — | ✅ |
|
|
143
|
-
|
|
144
|
-
#### Via Copilot CLI
|
|
161
|
+
#### Via APM (recommended)
|
|
145
162
|
|
|
146
163
|
```bash
|
|
147
|
-
|
|
148
|
-
copilot plugin install specky-sdd@specky
|
|
164
|
+
apm install paulasilvatech/specky
|
|
149
165
|
```
|
|
150
166
|
|
|
151
|
-
|
|
167
|
+
One command: installs 13 agents, 22 prompts, 8 skills, 14 hooks + configures the MCP server. [Install APM](https://microsoft.github.io/apm/getting-started/installation/) if you don't have it.
|
|
168
|
+
|
|
169
|
+
#### Via curl installer (no APM required)
|
|
152
170
|
|
|
153
171
|
```bash
|
|
154
172
|
cd your-project/
|
|
155
|
-
bash <(curl -sL https://raw.githubusercontent.com/paulasilvatech/specky/main/
|
|
173
|
+
bash <(curl -sL https://raw.githubusercontent.com/paulasilvatech/specky/main/install.sh)
|
|
156
174
|
```
|
|
157
175
|
|
|
158
|
-
|
|
176
|
+
#### Via Copilot CLI (skills only)
|
|
159
177
|
|
|
178
|
+
```bash
|
|
179
|
+
copilot plugin install paulasilvatech/specky
|
|
160
180
|
```
|
|
161
|
-
your-project/
|
|
162
|
-
├── .github/plugin/specky/ ← Full plugin (agents, skills, hooks, prompts)
|
|
163
|
-
│ ├── agents/ ← 7 specialized Copilot agents
|
|
164
|
-
│ ├── prompts/ ← 19 reusable prompts
|
|
165
|
-
│ ├── skills/ ← 6 domain skills
|
|
166
|
-
│ ├── hooks/scripts/ ← 10 automation hooks
|
|
167
|
-
│ ├── instructions/ ← Copilot instructions
|
|
168
|
-
│ └── config.yml ← Pipeline configuration
|
|
169
|
-
├── .vscode/
|
|
170
|
-
│ ├── mcp.json ← MCP server configuration
|
|
171
|
-
│ └── settings.json ← Hook integration
|
|
172
|
-
└── GETTING-STARTED.md
|
|
173
|
-
```
|
|
174
|
-
|
|
175
|
-
> **Tip:** Commit `.github/plugin/` and `.vscode/` to Git so every team member gets Specky automatically on clone.
|
|
176
|
-
|
|
177
|
-
See the full [plugin documentation](plugins/specky-sdd/README.md) for details.
|
|
178
|
-
|
|
179
|
-
### Install MCP Server Only
|
|
180
|
-
|
|
181
|
-
If you only need the 57 MCP tools without agents, skills, and hooks, install the MCP server directly.
|
|
182
181
|
|
|
183
182
|
<details>
|
|
184
|
-
<summary><strong>
|
|
183
|
+
<summary><strong>MCP server only (advanced — tools without agents/prompts/hooks)</strong></summary>
|
|
185
184
|
|
|
186
185
|
```bash
|
|
187
186
|
npm install -g specky-sdd
|
|
@@ -190,10 +189,10 @@ npm install -g specky-sdd
|
|
|
190
189
|
**VS Code** (`.vscode/mcp.json`):
|
|
191
190
|
```json
|
|
192
191
|
{
|
|
193
|
-
"
|
|
194
|
-
"specky
|
|
195
|
-
"
|
|
196
|
-
"
|
|
192
|
+
"servers": {
|
|
193
|
+
"specky": {
|
|
194
|
+
"command": "specky-sdd",
|
|
195
|
+
"env": { "SDD_WORKSPACE": "${workspaceFolder}" }
|
|
197
196
|
}
|
|
198
197
|
}
|
|
199
198
|
}
|
|
@@ -201,72 +200,33 @@ npm install -g specky-sdd
|
|
|
201
200
|
|
|
202
201
|
**Claude Code**:
|
|
203
202
|
```bash
|
|
204
|
-
claude mcp add specky
|
|
205
|
-
```
|
|
206
|
-
|
|
207
|
-
**Claude Desktop** (`claude_desktop_config.json`):
|
|
208
|
-
```json
|
|
209
|
-
{
|
|
210
|
-
"mcpServers": {
|
|
211
|
-
"specky-sdd": {
|
|
212
|
-
"command": "specky-sdd"
|
|
213
|
-
}
|
|
214
|
-
}
|
|
215
|
-
}
|
|
203
|
+
claude mcp add specky -- specky-sdd
|
|
216
204
|
```
|
|
217
205
|
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
<details>
|
|
221
|
-
<summary><strong>Per Workspace (npx)</strong></summary>
|
|
222
|
-
|
|
223
|
-
**VS Code** (`.vscode/mcp.json`):
|
|
224
|
-
```json
|
|
225
|
-
{
|
|
226
|
-
"mcpServers": {
|
|
227
|
-
"specky-sdd": {
|
|
228
|
-
"type": "stdio",
|
|
229
|
-
"command": "npx",
|
|
230
|
-
"args": ["-y", "specky-sdd@latest"]
|
|
231
|
-
}
|
|
232
|
-
}
|
|
233
|
-
}
|
|
234
|
-
```
|
|
235
|
-
|
|
236
|
-
> Commit `.vscode/mcp.json` to Git so every team member gets Specky automatically.
|
|
237
|
-
|
|
238
|
-
</details>
|
|
239
|
-
|
|
240
|
-
<details>
|
|
241
|
-
<summary><strong>Docker (HTTP mode, no Node.js required)</strong></summary>
|
|
242
|
-
|
|
206
|
+
**Docker** (HTTP mode, no Node.js):
|
|
243
207
|
```bash
|
|
244
208
|
docker run -d --name specky -p 3200:3200 -v $(pwd):/workspace ghcr.io/paulasilvatech/specky:latest
|
|
245
209
|
```
|
|
246
210
|
|
|
247
|
-
Point any MCP client that supports HTTP to `http://localhost:3200/mcp`
|
|
248
|
-
|
|
249
211
|
</details>
|
|
250
212
|
|
|
251
213
|
### Verify
|
|
252
214
|
|
|
253
|
-
Open
|
|
215
|
+
Open Copilot Chat and type:
|
|
254
216
|
|
|
255
217
|
```
|
|
256
|
-
|
|
218
|
+
@specky-onboarding
|
|
257
219
|
```
|
|
258
220
|
|
|
259
|
-
The
|
|
221
|
+
The onboarding wizard detects your project context (greenfield/brownfield/modernization) and guides you through setup.
|
|
260
222
|
|
|
261
223
|
### Try It Now
|
|
262
224
|
|
|
263
|
-
Once connected, type this in your AI chat:
|
|
264
|
-
|
|
265
225
|
```
|
|
266
|
-
|
|
226
|
+
@specky-orchestrator run the pipeline for a todo API
|
|
267
227
|
```
|
|
268
228
|
|
|
269
|
-
|
|
229
|
+
The orchestrator coordinates all 10 phases: Init → Research → Specify → Design → Tasks → Implement → Verify → Review → Release, with LGTM gates at Specify, Design, and Tasks.
|
|
270
230
|
|
|
271
231
|
| Your situation | Guide |
|
|
272
232
|
|---------------|-------|
|
|
@@ -737,7 +697,7 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
737
697
|
|
|
738
698
|
## All 57 Tools
|
|
739
699
|
|
|
740
|
-
### Input and Conversion (
|
|
700
|
+
### Input and Conversion (5)
|
|
741
701
|
|
|
742
702
|
| Tool | Description |
|
|
743
703
|
|------|-------------|
|
|
@@ -745,10 +705,9 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
745
705
|
| `sdd_import_transcript` | Parse meeting transcripts (Teams, Zoom, Google Meet) |
|
|
746
706
|
| `sdd_auto_pipeline` | Any input to complete spec pipeline (all documents) |
|
|
747
707
|
| `sdd_batch_import` | Process folder of mixed documents |
|
|
748
|
-
| `sdd_batch_transcripts` | Process folder of meeting transcripts |
|
|
749
708
|
| `sdd_figma_to_spec` | Figma design to requirements specification |
|
|
750
709
|
|
|
751
|
-
### Pipeline Core (
|
|
710
|
+
### Pipeline Core (8)
|
|
752
711
|
|
|
753
712
|
| Tool | Description |
|
|
754
713
|
|------|-------------|
|
|
@@ -758,7 +717,6 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
758
717
|
| `sdd_clarify` | Resolve ambiguities with decision tree |
|
|
759
718
|
| `sdd_write_design` | 12-section system design (C4 model) with sequence diagrams, ERD, API flow |
|
|
760
719
|
| `sdd_write_tasks` | Task breakdown with dependency graph |
|
|
761
|
-
| `sdd_write_bugfix` | Bugfix specification from issue description |
|
|
762
720
|
| `sdd_run_analysis` | Quality gate analysis with coverage heatmap |
|
|
763
721
|
| `sdd_advance_phase` | Move to next pipeline phase |
|
|
764
722
|
|
|
@@ -797,7 +755,7 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
797
755
|
| `sdd_setup_codespaces` | GitHub Codespaces configuration |
|
|
798
756
|
| `sdd_generate_devcontainer` | .devcontainer/devcontainer.json generation |
|
|
799
757
|
|
|
800
|
-
### Integration and Export (
|
|
758
|
+
### Integration and Export (5)
|
|
801
759
|
|
|
802
760
|
| Tool | Description |
|
|
803
761
|
|------|-------------|
|
|
@@ -806,20 +764,17 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
806
764
|
| `sdd_create_pr` | PR payload with spec summary |
|
|
807
765
|
| `sdd_implement` | Ordered implementation plan with checkpoints |
|
|
808
766
|
| `sdd_research` | Resolve unknowns in RESEARCH.md |
|
|
809
|
-
| `sdd_check_sync` | Detect drift between specification and implementation |
|
|
810
|
-
| `sdd_detect_drift` | Intent drift detection with amendment suggestions |
|
|
811
767
|
|
|
812
|
-
### Documentation (
|
|
768
|
+
### Documentation (4)
|
|
813
769
|
|
|
814
770
|
| Tool | Description |
|
|
815
771
|
|------|-------------|
|
|
816
772
|
| `sdd_generate_docs` | Complete auto-documentation |
|
|
817
|
-
| `sdd_generate_all_docs` | Generate all documentation types in parallel |
|
|
818
773
|
| `sdd_generate_api_docs` | API documentation from design |
|
|
819
774
|
| `sdd_generate_runbook` | Operational runbook |
|
|
820
775
|
| `sdd_generate_onboarding` | Developer onboarding guide |
|
|
821
776
|
|
|
822
|
-
### Utility (
|
|
777
|
+
### Utility (5)
|
|
823
778
|
|
|
824
779
|
| Tool | Description |
|
|
825
780
|
|------|-------------|
|
|
@@ -828,9 +783,6 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
828
783
|
| `sdd_scan_codebase` | Detect tech stack and structure |
|
|
829
784
|
| `sdd_metrics` | Project metrics dashboard |
|
|
830
785
|
| `sdd_amend` | Amend project constitution |
|
|
831
|
-
| `sdd_context_status` | Context tiering status (Hot/Domain/Cold) |
|
|
832
|
-
| `sdd_model_routing` | Model routing guidance for current task |
|
|
833
|
-
| `sdd_check_access` | RBAC access check for current role |
|
|
834
786
|
|
|
835
787
|
### Testing (3)
|
|
836
788
|
|
|
@@ -871,14 +823,14 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
871
823
|
|
|
872
824
|
**[Spec-Kit](https://github.com/paulasilvatech/spec-kit)** is the open-source SDD methodology: EARS notation, gated pipeline phases, constitution model, 25+ specialized agents, and Markdown prompt templates. It defines **what** to do.
|
|
873
825
|
|
|
874
|
-
**Specky** is the
|
|
826
|
+
**Specky** is the complete plugin that reimplements that methodology as 57 enforceable MCP tools with 13 agents, 22 prompts, 8 skills, and 14 hooks. It enforces **how** to do it.
|
|
875
827
|
|
|
876
|
-
| | Spec-Kit (Methodology) | Specky (
|
|
828
|
+
| | Spec-Kit (Methodology) | Specky (Plugin) |
|
|
877
829
|
|--|------------------------|-----------------|
|
|
878
|
-
| **What it is** | Prompt templates + agent definitions |
|
|
879
|
-
| **How it works** | AI reads `.md` templates and follows instructions | AI calls
|
|
880
|
-
| **Validation** | AI tries to follow the prompts | State machine, EARS regex, Zod schemas |
|
|
881
|
-
| **Install** | Copy `.github/agents/` and `.claude/commands/` | `
|
|
830
|
+
| **What it is** | Prompt templates + agent definitions | Complete plugin: 13 agents + 57 MCP tools + 22 prompts + 8 skills + 14 hooks |
|
|
831
|
+
| **How it works** | AI reads `.md` templates and follows instructions | AI calls agents that orchestrate tools with hook validation |
|
|
832
|
+
| **Validation** | AI tries to follow the prompts | State machine, EARS regex, Zod schemas, pre/post hooks |
|
|
833
|
+
| **Install** | Copy `.github/agents/` and `.claude/commands/` | `apm install paulasilvatech/specky` |
|
|
882
834
|
| **Works standalone** | Yes, in any AI IDE | Yes, includes all Spec-Kit patterns |
|
|
883
835
|
| **Best for** | Learning SDD, lightweight adoption | Production enforcement, enterprise, compliance |
|
|
884
836
|
|
|
@@ -888,27 +840,17 @@ When you install Specky, you get the full Spec-Kit methodology reimplemented as
|
|
|
888
840
|
|
|
889
841
|
Together they form the **SDD layer** of the GitHub + Microsoft enterprise platform. Specky reimplements the Spec-Kit methodology as enforceable MCP tools with compliance, traceability, and automation built in.
|
|
890
842
|
|
|
891
|
-
The recommended way to adopt this stack is via the [Specky plugin](plugins/specky-sdd/), which bundles the MCP server, agents, skills, and hooks into a single installable package:
|
|
892
|
-
|
|
893
|
-
```bash
|
|
894
|
-
copilot plugin marketplace add paulasilvatech/specky
|
|
895
|
-
copilot plugin install specky-sdd@specky
|
|
896
|
-
```
|
|
897
|
-
|
|
898
|
-
Or configure the MCP server directly:
|
|
899
|
-
|
|
900
843
|
```json
|
|
901
844
|
{
|
|
902
|
-
"
|
|
903
|
-
"specky
|
|
904
|
-
"type": "stdio",
|
|
845
|
+
"servers": {
|
|
846
|
+
"specky": {
|
|
905
847
|
"command": "specky-sdd"
|
|
906
848
|
}
|
|
907
849
|
}
|
|
908
850
|
}
|
|
909
851
|
```
|
|
910
852
|
|
|
911
|
-
> **Note:** This example assumes `specky-sdd` is installed globally (`npm install -g specky-sdd`). See the [
|
|
853
|
+
> **Note:** This example assumes `specky-sdd` is installed globally (`npm install -g specky-sdd`). See the [Installation](#installation) section for per-workspace and Docker alternatives.
|
|
912
854
|
|
|
913
855
|
## Project Configuration
|
|
914
856
|
|
|
@@ -1020,7 +962,7 @@ Specky is built with enterprise adoption in mind.
|
|
|
1020
962
|
- **Zod `.strict()` validation** — every tool input is schema-validated; unknown fields rejected
|
|
1021
963
|
- **security-scan hook** blocks commits containing hardcoded secrets (exit code 2)
|
|
1022
964
|
- See [SECURITY.md](SECURITY.md) for full OWASP Top 10 coverage
|
|
1023
|
-
- See [
|
|
965
|
+
- See [docs/SYSTEM-DESIGN.md](docs/SYSTEM-DESIGN.md) for complete security architecture
|
|
1024
966
|
|
|
1025
967
|
### Security Best Practices
|
|
1026
968
|
|
|
@@ -1076,25 +1018,42 @@ Every pipeline phase produces a traceable artifact in `.specs/NNN-feature/`. The
|
|
|
1076
1018
|
- **EARS Validator** — programmatic requirement quality enforcement
|
|
1077
1019
|
- **Cross-Artifact Analysis** — automatic alignment checking between spec, design, and tasks
|
|
1078
1020
|
- **Phase Enforcement** — state machine blocks phase-skipping; required files gate advancement
|
|
1079
|
-
- **
|
|
1021
|
+
- **507 unit tests** — CI enforces thresholds on every push
|
|
1080
1022
|
|
|
1081
1023
|
|
|
1082
1024
|
## Development
|
|
1083
1025
|
|
|
1084
1026
|
```bash
|
|
1085
|
-
#
|
|
1086
|
-
|
|
1027
|
+
# Clone and setup
|
|
1028
|
+
git clone https://github.com/paulasilvatech/specky.git
|
|
1029
|
+
cd specky
|
|
1030
|
+
npm install
|
|
1031
|
+
|
|
1032
|
+
# Build
|
|
1033
|
+
npm run build
|
|
1034
|
+
|
|
1035
|
+
# Run tests (507 tests)
|
|
1036
|
+
npm test
|
|
1037
|
+
|
|
1038
|
+
# Run tests with coverage report
|
|
1039
|
+
npm run test:coverage
|
|
1040
|
+
|
|
1041
|
+
# Development mode (auto-reload on file changes)
|
|
1042
|
+
npm run dev
|
|
1087
1043
|
|
|
1088
1044
|
# Verify MCP handshake (quick smoke test)
|
|
1089
|
-
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' |
|
|
1090
|
-
```
|
|
1045
|
+
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | node dist/index.js 2>/dev/null
|
|
1091
1046
|
|
|
1092
|
-
|
|
1047
|
+
# Build and run with Docker locally
|
|
1048
|
+
docker build -t specky-sdd:dev .
|
|
1049
|
+
docker run -p 3200:3200 -v $(pwd):/workspace specky-sdd:dev
|
|
1050
|
+
curl http://localhost:3200/health
|
|
1051
|
+
```
|
|
1093
1052
|
|
|
1094
1053
|
|
|
1095
1054
|
## Roadmap
|
|
1096
1055
|
|
|
1097
|
-
### v3.
|
|
1056
|
+
### v3.1 (current)
|
|
1098
1057
|
|
|
1099
1058
|
| Capability | Status |
|
|
1100
1059
|
|------------|--------|
|
|
@@ -1112,17 +1071,17 @@ For contributors, see [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
|
1112
1071
|
| Cognitive debt metrics at LGTM gates | Stable |
|
|
1113
1072
|
| Test traceability: REQ-ID → test coverage mapping | Stable |
|
|
1114
1073
|
| Intent drift detection with amendment suggestions | Stable |
|
|
1115
|
-
|
|
|
1116
|
-
|
|
|
1074
|
+
| 14 automation hooks (4 blocking) | Stable |
|
|
1075
|
+
| 13 specialized agents + 22 prompts + 8 skills | Stable |
|
|
1117
1076
|
| 6 compliance frameworks (HIPAA, SOC2, GDPR, PCI-DSS, ISO 27001) | Stable |
|
|
1118
1077
|
| 6 input types (transcript, PDF, DOCX, Figma, codebase, raw text) | Stable |
|
|
1119
1078
|
| Test generation for 6 frameworks (vitest, jest, playwright, pytest, junit, xunit) | Stable |
|
|
1120
1079
|
| MCP-to-MCP routing (GitHub, Azure DevOps, Jira, Terraform, Figma, Docker) | Stable |
|
|
1121
1080
|
| SBOM + cosign signing on Docker image | Stable |
|
|
1122
1081
|
| JSONL audit logger (optional) | Stable |
|
|
1123
|
-
|
|
|
1082
|
+
| 507 unit tests | Stable |
|
|
1124
1083
|
|
|
1125
|
-
### v3.
|
|
1084
|
+
### v3.2+ (planned)
|
|
1126
1085
|
|
|
1127
1086
|
| Feature | Description |
|
|
1128
1087
|
|---------|-------------|
|
|
@@ -1130,8 +1089,10 @@ For contributors, see [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
|
1130
1089
|
| Observability | OpenTelemetry metrics and structured logging |
|
|
1131
1090
|
| Internationalization | Spec templates in PT-BR, ES, FR, DE, JA |
|
|
1132
1091
|
| Automated shrinking | fast-check/Hypothesis shrinking feedback into spec refinement |
|
|
1092
|
+
| RBAC | Role-based access control for phase advancement |
|
|
1133
1093
|
| Centralized audit log | SIEM-integrated tamper-evident audit trail |
|
|
1134
1094
|
| Multi-tenant | Isolated workspaces for multiple teams |
|
|
1095
|
+
| Rate limiting | Request throttling for HTTP transport |
|
|
1135
1096
|
| SSO / SAML | Federated identity for enterprise auth |
|
|
1136
1097
|
|
|
1137
1098
|
Have a feature request? [Open an issue](https://github.com/paulasilvatech/specky/issues).
|
package/dist/index.js
CHANGED
|
@@ -72,8 +72,8 @@ const server = new McpServer({
|
|
|
72
72
|
name: SERVER_NAME,
|
|
73
73
|
version: VERSION,
|
|
74
74
|
title: "Specky",
|
|
75
|
-
description: "
|
|
76
|
-
websiteUrl: "https://
|
|
75
|
+
description: "Agentic Spec-Driven Development plugin — 13 agents, 57 MCP tools, 10-phase enforced pipeline, EARS notation, 22 prompts, 8 skills, 14 hooks.",
|
|
76
|
+
websiteUrl: "https://getspecky.ai",
|
|
77
77
|
icons: [
|
|
78
78
|
{
|
|
79
79
|
src: "https://raw.githubusercontent.com/paulasilvatech/specky/main/media/specky-brand-icon.svg",
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specky-sdd",
|
|
3
|
-
"version": "3.
|
|
3
|
+
"version": "3.3.0",
|
|
4
4
|
"description": "Specky — 57 MCP tools for Spec-Driven Development. 10-phase pipeline, enterprise security (rate limiting, HMAC state integrity, RBAC, hash-chained audit), model routing guidance, context tiering, cognitive debt metrics, EARS notation, 17 diagram types.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|