specky-sdd 3.2.1 → 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 +44 -0
- package/README.md +117 -129
- package/SECURITY.md +4 -4
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,50 @@ All notable changes to Specky are documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [3.2.2] - 2026-04-13
|
|
9
|
+
|
|
10
|
+
### Documentation (npm republish)
|
|
11
|
+
|
|
12
|
+
- **Plugin-first Quick Start**: README now leads with plugin installation (`copilot plugin install`), MCP-only as alternative
|
|
13
|
+
- **`mcpServers` key**: All JSON config examples updated from `servers` to `mcpServers`
|
|
14
|
+
- **Stale counts fixed**: Tool count (53/55/56 → 57), hook count (7 → 10), agent count (5 → 7), skill count (6) across README, SECURITY, CONTRIBUTING
|
|
15
|
+
- **SDD Platform table**: Updated to 57 tools, plugin install command
|
|
16
|
+
- **GETTING-STARTED.md**: Full English rewrite with plugin-first installation, use cases, model routing, hooks, FAQ
|
|
17
|
+
- **CONTRIBUTING.md**: Added Plugin Structure section; version reference updated to v3.2.x
|
|
18
|
+
- **No runtime changes** — MCP server code is identical to v3.2.1
|
|
19
|
+
|
|
20
|
+
## [3.2.1] - 2026-04-13
|
|
21
|
+
|
|
22
|
+
### Plugin Marketplace
|
|
23
|
+
|
|
24
|
+
- **`marketplace.json`**: Added `.github/plugin/marketplace.json` — repo is now a valid GitHub Copilot plugin marketplace
|
|
25
|
+
- **`plugin.json`**: Added `plugins/specky-sdd/.github/plugin/plugin.json` in Claude Code spec format (7 agents, 19 commands, 6 skills)
|
|
26
|
+
- **`.mcp.json`**: Plugin ships its own MCP config with `mcpServers` key and `specky-sdd@latest`
|
|
27
|
+
- **`.claude-plugin/`**: Added symlink for Claude Code marketplace compatibility
|
|
28
|
+
- **Plugin README**: Full plugin documentation at `plugins/specky-sdd/README.md` with skills, agents, commands, MCP server, and installation instructions
|
|
29
|
+
- **Plugin install**: Users can now install via `copilot plugin marketplace add paulasilvatech/specky && copilot plugin install specky-sdd@specky`
|
|
30
|
+
- **Flat structure**: Restructured from versioned `specky-sdd-vscode-v1.2.1/.github/plugin/specky/` to flat `plugins/specky-sdd/`
|
|
31
|
+
- **MCP key fix**: All JSON configs now use `mcpServers` key (previously `servers` in some files)
|
|
32
|
+
- **Version sync**: All plugin files aligned to v3.2.1 (`config.yml`, `plugin.json`, `marketplace.json`)
|
|
33
|
+
- **Cleanup**: Removed duplicate directories, empty `.github/agents/`, `.github/prompts/`, `.github/instructions/`, `.github/hooks/`
|
|
34
|
+
|
|
35
|
+
### MCP Server Metadata
|
|
36
|
+
|
|
37
|
+
- **Server title**: MCP panel now shows "Specky" with description instead of raw binary name
|
|
38
|
+
- **Server icon**: SVG + PNG icons served from GitHub raw content, visible in VS Code MCP panel
|
|
39
|
+
- **Website URL**: Links to [getspecky.ai](https://getspecky.ai) from server metadata
|
|
40
|
+
- **Instructions**: AI clients receive pipeline guidance during MCP handshake
|
|
41
|
+
- **Template path fix**: Templates now resolve from `dist/templates/` (self-contained npm package)
|
|
42
|
+
|
|
43
|
+
### Documentation
|
|
44
|
+
|
|
45
|
+
- **MCP config examples**: Added `"type": "stdio"` to all VS Code, Claude Code, and Claude Desktop config examples
|
|
46
|
+
- **Removed broken env vars**: Removed `SDD_WORKSPACE` / `${workspaceFolder}` that caused startup errors
|
|
47
|
+
- **Tool count**: Updated 56 → 57 across all documentation
|
|
48
|
+
- **EARS patterns**: Fixed 5 → 6 pattern count (includes Complex)
|
|
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 [getspecky.ai](https://getspecky.ai)
|
|
51
|
+
|
|
8
52
|
## [3.2.0] - 2026-04-12
|
|
9
53
|
|
|
10
54
|
### Enterprise Security Hardening
|
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,7 +21,7 @@
|
|
|
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
26
|
<a href="https://www.npmjs.com/package/specky-sdd">npm</a> ·
|
|
27
27
|
<a href="SECURITY.md">Security</a>
|
|
@@ -34,9 +34,10 @@
|
|
|
34
34
|
| | Section | Description |
|
|
35
35
|
|---|---------|-------------|
|
|
36
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 |
|
|
37
38
|
| | [Why Specifications Matter](#why-specifications-matter-in-the-ai-era) | Vibe coding vs deterministic development |
|
|
38
39
|
| | [Getting Started](GETTING-STARTED.md) | Complete educational guide |
|
|
39
|
-
| **Use** | [Quick Start](#quick-start) | Install
|
|
40
|
+
| **Use** | [Quick Start](#quick-start) | Install the plugin via APM, curl, or npm |
|
|
40
41
|
| | [Where Specifications Live](#where-specifications-live) | File structure and naming conventions |
|
|
41
42
|
| | [Input Methods](#input-methods-6-ways-to-start) | 6 ways to feed Specky |
|
|
42
43
|
| | [Three Project Types](#three-project-types-one-pipeline) | Greenfield, Brownfield, Modernization |
|
|
@@ -46,16 +47,46 @@
|
|
|
46
47
|
| **Enterprise** | [Compliance Frameworks](#compliance-frameworks) | HIPAA, SOC2, GDPR, PCI-DSS, ISO 27001 |
|
|
47
48
|
| | [Enterprise Ready](#enterprise-ready) | Security, audit trail, quality gates |
|
|
48
49
|
| **Platform** | [The SDD Platform](#the-spec-driven-development-platform) | Built on Spec-Kit, everything included |
|
|
49
|
-
| | [Roadmap](#roadmap) | v3.
|
|
50
|
+
| | [Roadmap](#roadmap) | v3.0 current, v3.1+ planned |
|
|
50
51
|
|
|
51
52
|
|
|
52
53
|
## What is Specky?
|
|
53
54
|
|
|
54
|
-
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.
|
|
55
56
|
|
|
56
|
-
|
|
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.
|
|
57
58
|
|
|
58
|
-
|
|
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.
|
|
59
90
|
|
|
60
91
|
|
|
61
92
|
## Why Specifications Matter in the AI Era
|
|
@@ -81,7 +112,8 @@ The result? Teams spend 40% of their time on rework because requirements were ne
|
|
|
81
112
|
| **Markdown** | The universal language that both humans and AI read fluently | All spec artifacts are `.md` files in your repo, versioned with Git |
|
|
82
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 |
|
|
83
114
|
| **EARS Notation** | A method for writing requirements that forces precision with 6 patterns | Eliminates vague statements like "the system should be fast" |
|
|
84
|
-
| **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 |
|
|
85
117
|
|
|
86
118
|
### How Specky Enforces Determinism
|
|
87
119
|
|
|
@@ -98,18 +130,20 @@ Specky adds a **deterministic engine** between your intent and your code:
|
|
|
98
130
|
|
|
99
131
|
| Capability | Specky |
|
|
100
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 |
|
|
101
136
|
| Any input (PDF, DOCX, PPTX, transcript, Figma) to spec | 57 MCP tools handle all input formats |
|
|
102
137
|
| EARS validation (programmatic, not AI guessing) | 6 patterns enforced at schema level |
|
|
103
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 |
|
|
104
140
|
| 17 diagram types generated automatically | C4 (4 levels), sequence, ER, activity, use case, DFD, deployment, network |
|
|
105
141
|
| Infrastructure as Code | Terraform, Bicep, Dockerfile from DESIGN.md |
|
|
106
142
|
| Work item export | GitHub Issues, Azure Boards, Jira via MCP-to-MCP routing |
|
|
107
143
|
| 6 compliance frameworks | HIPAA, SOC2, GDPR, PCI-DSS, ISO 27001 built-in |
|
|
108
144
|
| Cross-artifact traceability | Requirement to design to task to test to code |
|
|
109
|
-
|
|
|
110
|
-
|
|
|
111
|
-
| Checkpoint/restore | Persistent snapshots of all spec artifacts |
|
|
112
|
-
| 7 automation hooks | Tests, docs, security scan, spec sync, SRP, changelog, checkpoint |
|
|
145
|
+
| Gitflow-SDD branching | spec/NNN → develop → stage → main |
|
|
146
|
+
| APM distribution | `apm install paulasilvatech/specky` — one command, everything works |
|
|
113
147
|
| Works in any MCP host | VS Code + Copilot, Claude Code, Cursor, Windsurf, or any MCP client |
|
|
114
148
|
| Zero outbound network calls | Fully air-gapped, code never leaves your machine |
|
|
115
149
|
| MIT open source | Fork it, extend it, audit it. No vendor lock, no seat pricing |
|
|
@@ -120,77 +154,45 @@ Specky adds a **deterministic engine** between your intent and your code:
|
|
|
120
154
|
### Prerequisites
|
|
121
155
|
|
|
122
156
|
- **Node.js 18+**: [Download here](https://nodejs.org/)
|
|
123
|
-
- **An AI IDE**: VS Code with Copilot, Claude Code,
|
|
124
|
-
|
|
125
|
-
### Step 1: Choose Your Installation Scope
|
|
157
|
+
- **An AI IDE**: VS Code with Copilot, Claude Code, Cursor, or Windsurf
|
|
126
158
|
|
|
127
|
-
|
|
128
|
-
|-------|-------------|----------|
|
|
129
|
-
| **Per workspace** (recommended) | Config file lives inside the repo, shared with the team via Git | Teams, open-source projects |
|
|
130
|
-
| **Global (once)** | Installed on your machine, available in every repo automatically | Personal use, quick setup |
|
|
159
|
+
### Install the Plugin
|
|
131
160
|
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
<details open>
|
|
135
|
-
<summary><strong>Global (recommended): Install once, use everywhere</strong></summary>
|
|
136
|
-
|
|
137
|
-
Install globally so `specky-sdd` is always available — no re-download on every run:
|
|
161
|
+
#### Via APM (recommended)
|
|
138
162
|
|
|
139
163
|
```bash
|
|
140
|
-
|
|
164
|
+
apm install paulasilvatech/specky
|
|
141
165
|
```
|
|
142
166
|
|
|
143
|
-
|
|
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.
|
|
144
168
|
|
|
145
|
-
|
|
146
|
-
```json
|
|
147
|
-
{
|
|
148
|
-
"servers": {
|
|
149
|
-
"specky": {
|
|
150
|
-
"type": "stdio",
|
|
151
|
-
"command": "specky-sdd"
|
|
152
|
-
}
|
|
153
|
-
}
|
|
154
|
-
}
|
|
155
|
-
```
|
|
169
|
+
#### Via curl installer (no APM required)
|
|
156
170
|
|
|
157
|
-
**Claude Code**:
|
|
158
171
|
```bash
|
|
159
|
-
|
|
172
|
+
cd your-project/
|
|
173
|
+
bash <(curl -sL https://raw.githubusercontent.com/paulasilvatech/specky/main/install.sh)
|
|
160
174
|
```
|
|
161
175
|
|
|
162
|
-
|
|
176
|
+
#### Via Copilot CLI (skills only)
|
|
163
177
|
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
|
|
167
|
-
| Linux | `~/.config/Claude/claude_desktop_config.json` |
|
|
168
|
-
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
|
|
169
|
-
|
|
170
|
-
```json
|
|
171
|
-
{
|
|
172
|
-
"mcpServers": {
|
|
173
|
-
"specky": {
|
|
174
|
-
"command": "specky-sdd"
|
|
175
|
-
}
|
|
176
|
-
}
|
|
177
|
-
}
|
|
178
|
+
```bash
|
|
179
|
+
copilot plugin install paulasilvatech/specky
|
|
178
180
|
```
|
|
179
181
|
|
|
180
|
-
</details>
|
|
181
|
-
|
|
182
182
|
<details>
|
|
183
|
-
<summary><strong>
|
|
183
|
+
<summary><strong>MCP server only (advanced — tools without agents/prompts/hooks)</strong></summary>
|
|
184
184
|
|
|
185
|
-
|
|
185
|
+
```bash
|
|
186
|
+
npm install -g specky-sdd
|
|
187
|
+
```
|
|
186
188
|
|
|
187
189
|
**VS Code** (`.vscode/mcp.json`):
|
|
188
190
|
```json
|
|
189
191
|
{
|
|
190
192
|
"servers": {
|
|
191
193
|
"specky": {
|
|
192
|
-
"
|
|
193
|
-
"
|
|
194
|
+
"command": "specky-sdd",
|
|
195
|
+
"env": { "SDD_WORKSPACE": "${workspaceFolder}" }
|
|
194
196
|
}
|
|
195
197
|
}
|
|
196
198
|
}
|
|
@@ -201,54 +203,30 @@ Add a config file to the repo so teammates get Specky automatically on clone —
|
|
|
201
203
|
claude mcp add specky -- specky-sdd
|
|
202
204
|
```
|
|
203
205
|
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
</details>
|
|
207
|
-
|
|
208
|
-
<details>
|
|
209
|
-
<summary><strong>Docker: Docker (HTTP mode, no Node.js required)</strong></summary>
|
|
210
|
-
|
|
211
|
-
Run Specky as an HTTP server in a container:
|
|
212
|
-
|
|
206
|
+
**Docker** (HTTP mode, no Node.js):
|
|
213
207
|
```bash
|
|
214
208
|
docker run -d --name specky -p 3200:3200 -v $(pwd):/workspace ghcr.io/paulasilvatech/specky:latest
|
|
215
209
|
```
|
|
216
210
|
|
|
217
|
-
Verify it's running:
|
|
218
|
-
|
|
219
|
-
```bash
|
|
220
|
-
curl http://localhost:3200/health
|
|
221
|
-
```
|
|
222
|
-
|
|
223
|
-
Point any MCP client that supports HTTP to `http://localhost:3200/mcp`
|
|
224
|
-
|
|
225
|
-
Stop when done:
|
|
226
|
-
|
|
227
|
-
```bash
|
|
228
|
-
docker stop specky && docker rm specky
|
|
229
|
-
```
|
|
230
|
-
|
|
231
211
|
</details>
|
|
232
212
|
|
|
233
|
-
###
|
|
213
|
+
### Verify
|
|
234
214
|
|
|
235
|
-
Open
|
|
215
|
+
Open Copilot Chat and type:
|
|
236
216
|
|
|
237
217
|
```
|
|
238
|
-
|
|
218
|
+
@specky-onboarding
|
|
239
219
|
```
|
|
240
220
|
|
|
241
|
-
The
|
|
221
|
+
The onboarding wizard detects your project context (greenfield/brownfield/modernization) and guides you through setup.
|
|
242
222
|
|
|
243
223
|
### Try It Now
|
|
244
224
|
|
|
245
|
-
Once connected, type this in your AI chat to see Specky in action:
|
|
246
|
-
|
|
247
225
|
```
|
|
248
|
-
|
|
226
|
+
@specky-orchestrator run the pipeline for a todo API
|
|
249
227
|
```
|
|
250
228
|
|
|
251
|
-
|
|
229
|
+
The orchestrator coordinates all 10 phases: Init → Research → Specify → Design → Tasks → Implement → Verify → Review → Release, with LGTM gates at Specify, Design, and Tasks.
|
|
252
230
|
|
|
253
231
|
| Your situation | Guide |
|
|
254
232
|
|---------------|-------|
|
|
@@ -719,7 +697,7 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
719
697
|
|
|
720
698
|
## All 57 Tools
|
|
721
699
|
|
|
722
|
-
### Input and Conversion (
|
|
700
|
+
### Input and Conversion (5)
|
|
723
701
|
|
|
724
702
|
| Tool | Description |
|
|
725
703
|
|------|-------------|
|
|
@@ -727,10 +705,9 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
727
705
|
| `sdd_import_transcript` | Parse meeting transcripts (Teams, Zoom, Google Meet) |
|
|
728
706
|
| `sdd_auto_pipeline` | Any input to complete spec pipeline (all documents) |
|
|
729
707
|
| `sdd_batch_import` | Process folder of mixed documents |
|
|
730
|
-
| `sdd_batch_transcripts` | Process folder of meeting transcripts |
|
|
731
708
|
| `sdd_figma_to_spec` | Figma design to requirements specification |
|
|
732
709
|
|
|
733
|
-
### Pipeline Core (
|
|
710
|
+
### Pipeline Core (8)
|
|
734
711
|
|
|
735
712
|
| Tool | Description |
|
|
736
713
|
|------|-------------|
|
|
@@ -740,7 +717,6 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
740
717
|
| `sdd_clarify` | Resolve ambiguities with decision tree |
|
|
741
718
|
| `sdd_write_design` | 12-section system design (C4 model) with sequence diagrams, ERD, API flow |
|
|
742
719
|
| `sdd_write_tasks` | Task breakdown with dependency graph |
|
|
743
|
-
| `sdd_write_bugfix` | Bugfix specification from issue description |
|
|
744
720
|
| `sdd_run_analysis` | Quality gate analysis with coverage heatmap |
|
|
745
721
|
| `sdd_advance_phase` | Move to next pipeline phase |
|
|
746
722
|
|
|
@@ -779,7 +755,7 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
779
755
|
| `sdd_setup_codespaces` | GitHub Codespaces configuration |
|
|
780
756
|
| `sdd_generate_devcontainer` | .devcontainer/devcontainer.json generation |
|
|
781
757
|
|
|
782
|
-
### Integration and Export (
|
|
758
|
+
### Integration and Export (5)
|
|
783
759
|
|
|
784
760
|
| Tool | Description |
|
|
785
761
|
|------|-------------|
|
|
@@ -788,20 +764,17 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
788
764
|
| `sdd_create_pr` | PR payload with spec summary |
|
|
789
765
|
| `sdd_implement` | Ordered implementation plan with checkpoints |
|
|
790
766
|
| `sdd_research` | Resolve unknowns in RESEARCH.md |
|
|
791
|
-
| `sdd_check_sync` | Detect drift between specification and implementation |
|
|
792
|
-
| `sdd_detect_drift` | Intent drift detection with amendment suggestions |
|
|
793
767
|
|
|
794
|
-
### Documentation (
|
|
768
|
+
### Documentation (4)
|
|
795
769
|
|
|
796
770
|
| Tool | Description |
|
|
797
771
|
|------|-------------|
|
|
798
772
|
| `sdd_generate_docs` | Complete auto-documentation |
|
|
799
|
-
| `sdd_generate_all_docs` | Generate all documentation types in parallel |
|
|
800
773
|
| `sdd_generate_api_docs` | API documentation from design |
|
|
801
774
|
| `sdd_generate_runbook` | Operational runbook |
|
|
802
775
|
| `sdd_generate_onboarding` | Developer onboarding guide |
|
|
803
776
|
|
|
804
|
-
### Utility (
|
|
777
|
+
### Utility (5)
|
|
805
778
|
|
|
806
779
|
| Tool | Description |
|
|
807
780
|
|------|-------------|
|
|
@@ -810,9 +783,6 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
810
783
|
| `sdd_scan_codebase` | Detect tech stack and structure |
|
|
811
784
|
| `sdd_metrics` | Project metrics dashboard |
|
|
812
785
|
| `sdd_amend` | Amend project constitution |
|
|
813
|
-
| `sdd_context_status` | Context tiering status (Hot/Domain/Cold) |
|
|
814
|
-
| `sdd_model_routing` | Model routing guidance for current task |
|
|
815
|
-
| `sdd_check_access` | RBAC access check for current role |
|
|
816
786
|
|
|
817
787
|
### Testing (3)
|
|
818
788
|
|
|
@@ -853,14 +823,14 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
853
823
|
|
|
854
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.
|
|
855
825
|
|
|
856
|
-
**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.
|
|
857
827
|
|
|
858
|
-
| | Spec-Kit (Methodology) | Specky (
|
|
828
|
+
| | Spec-Kit (Methodology) | Specky (Plugin) |
|
|
859
829
|
|--|------------------------|-----------------|
|
|
860
|
-
| **What it is** | Prompt templates + agent definitions |
|
|
861
|
-
| **How it works** | AI reads `.md` templates and follows instructions | AI calls
|
|
862
|
-
| **Validation** | AI tries to follow the prompts | State machine, EARS regex, Zod schemas |
|
|
863
|
-
| **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` |
|
|
864
834
|
| **Works standalone** | Yes, in any AI IDE | Yes, includes all Spec-Kit patterns |
|
|
865
835
|
| **Best for** | Learning SDD, lightweight adoption | Production enforcement, enterprise, compliance |
|
|
866
836
|
|
|
@@ -874,14 +844,13 @@ Together they form the **SDD layer** of the GitHub + Microsoft enterprise platfo
|
|
|
874
844
|
{
|
|
875
845
|
"servers": {
|
|
876
846
|
"specky": {
|
|
877
|
-
"type": "stdio",
|
|
878
847
|
"command": "specky-sdd"
|
|
879
848
|
}
|
|
880
849
|
}
|
|
881
850
|
}
|
|
882
851
|
```
|
|
883
852
|
|
|
884
|
-
> **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.
|
|
885
854
|
|
|
886
855
|
## Project Configuration
|
|
887
856
|
|
|
@@ -993,7 +962,7 @@ Specky is built with enterprise adoption in mind.
|
|
|
993
962
|
- **Zod `.strict()` validation** — every tool input is schema-validated; unknown fields rejected
|
|
994
963
|
- **security-scan hook** blocks commits containing hardcoded secrets (exit code 2)
|
|
995
964
|
- See [SECURITY.md](SECURITY.md) for full OWASP Top 10 coverage
|
|
996
|
-
- See [
|
|
965
|
+
- See [docs/SYSTEM-DESIGN.md](docs/SYSTEM-DESIGN.md) for complete security architecture
|
|
997
966
|
|
|
998
967
|
### Security Best Practices
|
|
999
968
|
|
|
@@ -1049,25 +1018,42 @@ Every pipeline phase produces a traceable artifact in `.specs/NNN-feature/`. The
|
|
|
1049
1018
|
- **EARS Validator** — programmatic requirement quality enforcement
|
|
1050
1019
|
- **Cross-Artifact Analysis** — automatic alignment checking between spec, design, and tasks
|
|
1051
1020
|
- **Phase Enforcement** — state machine blocks phase-skipping; required files gate advancement
|
|
1052
|
-
- **
|
|
1021
|
+
- **507 unit tests** — CI enforces thresholds on every push
|
|
1053
1022
|
|
|
1054
1023
|
|
|
1055
1024
|
## Development
|
|
1056
1025
|
|
|
1057
1026
|
```bash
|
|
1058
|
-
#
|
|
1059
|
-
|
|
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
|
|
1060
1043
|
|
|
1061
1044
|
# Verify MCP handshake (quick smoke test)
|
|
1062
|
-
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' |
|
|
1063
|
-
```
|
|
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
|
|
1064
1046
|
|
|
1065
|
-
|
|
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
|
+
```
|
|
1066
1052
|
|
|
1067
1053
|
|
|
1068
1054
|
## Roadmap
|
|
1069
1055
|
|
|
1070
|
-
### v3.
|
|
1056
|
+
### v3.1 (current)
|
|
1071
1057
|
|
|
1072
1058
|
| Capability | Status |
|
|
1073
1059
|
|------------|--------|
|
|
@@ -1085,17 +1071,17 @@ For contributors, see [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
|
1085
1071
|
| Cognitive debt metrics at LGTM gates | Stable |
|
|
1086
1072
|
| Test traceability: REQ-ID → test coverage mapping | Stable |
|
|
1087
1073
|
| Intent drift detection with amendment suggestions | Stable |
|
|
1088
|
-
|
|
|
1089
|
-
|
|
|
1074
|
+
| 14 automation hooks (4 blocking) | Stable |
|
|
1075
|
+
| 13 specialized agents + 22 prompts + 8 skills | Stable |
|
|
1090
1076
|
| 6 compliance frameworks (HIPAA, SOC2, GDPR, PCI-DSS, ISO 27001) | Stable |
|
|
1091
1077
|
| 6 input types (transcript, PDF, DOCX, Figma, codebase, raw text) | Stable |
|
|
1092
1078
|
| Test generation for 6 frameworks (vitest, jest, playwright, pytest, junit, xunit) | Stable |
|
|
1093
1079
|
| MCP-to-MCP routing (GitHub, Azure DevOps, Jira, Terraform, Figma, Docker) | Stable |
|
|
1094
1080
|
| SBOM + cosign signing on Docker image | Stable |
|
|
1095
1081
|
| JSONL audit logger (optional) | Stable |
|
|
1096
|
-
|
|
|
1082
|
+
| 507 unit tests | Stable |
|
|
1097
1083
|
|
|
1098
|
-
### v3.
|
|
1084
|
+
### v3.2+ (planned)
|
|
1099
1085
|
|
|
1100
1086
|
| Feature | Description |
|
|
1101
1087
|
|---------|-------------|
|
|
@@ -1103,8 +1089,10 @@ For contributors, see [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
|
1103
1089
|
| Observability | OpenTelemetry metrics and structured logging |
|
|
1104
1090
|
| Internationalization | Spec templates in PT-BR, ES, FR, DE, JA |
|
|
1105
1091
|
| Automated shrinking | fast-check/Hypothesis shrinking feedback into spec refinement |
|
|
1092
|
+
| RBAC | Role-based access control for phase advancement |
|
|
1106
1093
|
| Centralized audit log | SIEM-integrated tamper-evident audit trail |
|
|
1107
1094
|
| Multi-tenant | Isolated workspaces for multiple teams |
|
|
1095
|
+
| Rate limiting | Request throttling for HTTP transport |
|
|
1108
1096
|
| SSO / SAML | Federated identity for enterprise auth |
|
|
1109
1097
|
|
|
1110
1098
|
Have a feature request? [Open an issue](https://github.com/paulasilvatech/specky/issues).
|
package/SECURITY.md
CHANGED
|
@@ -26,7 +26,7 @@ If you discover a security vulnerability in Specky, please report it responsibly
|
|
|
26
26
|
|
|
27
27
|
### Input Validation
|
|
28
28
|
|
|
29
|
-
All
|
|
29
|
+
All 57 MCP tool inputs are validated using [Zod](https://zod.dev/) schemas with `.strict()` mode. No unknown fields are accepted. This prevents injection of unexpected parameters through the MCP JSON-RPC interface.
|
|
30
30
|
|
|
31
31
|
```
|
|
32
32
|
AI Client → JSON-RPC → Zod .strict() validation → Service layer
|
|
@@ -193,15 +193,15 @@ Running `npx specky-sdd` without a pinned version downloads the latest package f
|
|
|
193
193
|
| Approach | Risk reduction | Notes |
|
|
194
194
|
|----------|---------------|-------|
|
|
195
195
|
| `npm install -g specky-sdd` | **High** — fetches once, runs offline after | Recommended default |
|
|
196
|
-
| `npm install -g specky-sdd@3.2.
|
|
197
|
-
| Docker (`ghcr.io/paulasilvatech/specky:3.2.
|
|
196
|
+
| `npm install -g specky-sdd@3.2.1` | **Higher** — version-pinned, no silent upgrades | Best for reproducible environments |
|
|
197
|
+
| Docker (`ghcr.io/paulasilvatech/specky:3.2.1`) | **Highest** — immutable image by digest | Best for CI/CD and air-gapped |
|
|
198
198
|
| `npx specky-sdd` (unversioned) | **Baseline** — re-downloads on each invocation | Avoid in production pipelines |
|
|
199
199
|
|
|
200
200
|
**Workspace isolation pattern** (CI/CD):
|
|
201
201
|
|
|
202
202
|
```bash
|
|
203
203
|
# Install into a local vendor directory — no global write permissions needed
|
|
204
|
-
npm install specky-sdd@3.2.
|
|
204
|
+
npm install specky-sdd@3.2.1 --prefix ./vendor --ignore-scripts
|
|
205
205
|
./vendor/node_modules/.bin/specky-sdd
|
|
206
206
|
```
|
|
207
207
|
|
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":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,8BAA8B;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,iCAAiC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,yBAAyB;AACzB,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AACpE,OAAO,CAAC,KAAK,CAAC,4BAA4B,aAAa,EAAE,CAAC,CAAC;AAE3D,oDAAoD;AACpD,MAAM,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;AACzC,IAAI,MAAM,CAAC,cAAc;IAAE,OAAO,CAAC,KAAK,CAAC,8BAA8B,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;AAChG,IAAI,MAAM,CAAC,aAAa;IAAE,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;AAEzE,wBAAwB;AACxB,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE,
|
|
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",
|