specky-sdd 2.2.1 β 2.2.3
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 +178 -160
- package/dist/constants.d.ts +1 -2
- package/dist/constants.d.ts.map +1 -1
- package/dist/constants.js +5 -2
- package/dist/constants.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -12,73 +12,69 @@
|
|
|
12
12
|
</p>
|
|
13
13
|
</div>
|
|
14
14
|
|
|
15
|
-
---
|
|
16
15
|
|
|
17
|
-
## Table of Contents
|
|
16
|
+
## π Table of Contents
|
|
18
17
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
- [Compliance](#compliance-frameworks) β HIPAA, SOC2, GDPR, PCI-DSS, ISO 27001
|
|
36
|
-
- [Enterprise Ready](#enterprise-ready) β Security posture, audit trail, quality gates
|
|
37
|
-
- [Development](#development) β Build from source, run tests, contribute
|
|
18
|
+
| Section | Description |
|
|
19
|
+
|---------|-------------|
|
|
20
|
+
| [π What is Specky?](#-what-is-specky) | Overview and ecosystem |
|
|
21
|
+
| [π§ Why Specifications Matter](#-why-specifications-matter-in-the-ai-era) | Vibe coding vs deterministic development |
|
|
22
|
+
| [π GETTING-STARTED.md](GETTING-STARTED.md) | **Complete educational guide** (assumes no prior knowledge) |
|
|
23
|
+
| [π Quick Start](#-quick-start) | Install via npm or Docker, connect to your IDE |
|
|
24
|
+
| [π Where Specifications Live](#-where-specifications-live) | File structure and naming conventions |
|
|
25
|
+
| [π₯ Input Methods](#-input-methods--6-ways-to-start) | 6 ways to feed Specky |
|
|
26
|
+
| [ποΈ Three Project Types](#%EF%B8%8F-three-project-types--one-pipeline) | Greenfield, Brownfield, Modernization |
|
|
27
|
+
| [βοΈ Pipeline and LGTM Gates](#%EF%B8%8F-pipeline-and-lgtm-gates) | 10 phases with human review gates |
|
|
28
|
+
| [π§° All 47 Tools](#-all-47-tools) | Complete tool reference by category |
|
|
29
|
+
| [ποΈ The SDD Platform](#%EF%B8%8F-the-spec-driven-development-platform) | Built on Spec-Kit, everything included |
|
|
30
|
+
| [π EARS Notation](#-ears-notation) | The 6 requirement patterns |
|
|
31
|
+
| [π‘οΈ Compliance](#%EF%B8%8F-compliance-frameworks) | HIPAA, SOC2, GDPR, PCI-DSS, ISO 27001 |
|
|
32
|
+
| [π’ Enterprise Ready](#-enterprise-ready) | Security, audit trail, quality gates |
|
|
33
|
+
| [πΊοΈ Roadmap](#%EF%B8%8F-roadmap) | v2.2 (current), v2.3, v3.0 plans |
|
|
38
34
|
|
|
39
|
-
---
|
|
40
35
|
|
|
41
|
-
## What is Specky?
|
|
36
|
+
## π What is Specky?
|
|
42
37
|
|
|
43
|
-
Specky is
|
|
38
|
+
Specky is an open-source **MCP server** that turns the [Spec-Kit](https://github.com/paulasilvatech/spec-kit) SDD methodology into a **programmable enforcement engine** with 47 validated tools. It provides a deterministic pipeline from **any input** (meeting transcripts, documents, Figma designs, or natural language prompts) through specifications, architecture, infrastructure as code, implementation, and deployment.
|
|
44
39
|
|
|
45
|
-
|
|
40
|
+
**Spec-Kit** provides the methodology: EARS notation, gated pipeline phases, constitution model, quality patterns. **Specky** reimplements all of it as MCP tools and adds programmatic enforcement: a state machine that blocks phase-skipping, an EARS validator, cross-artifact analysis, compliance engines, test generation, and MCP-to-MCP routing.
|
|
46
41
|
|
|
47
|
-
**Install Specky and you
|
|
42
|
+
**Install Specky and you get both.** The Spec-Kit methodology is already built in. It works inside any AI IDE that supports MCP, via `.github/agents/` or `.claude/commands/`, and natively in Cursor, Windsurf, or any MCP-compatible client. See how they [complement each other](#%EF%B8%8F-the-spec-driven-development-platform).
|
|
48
43
|
|
|
49
|
-
---
|
|
50
44
|
|
|
51
|
-
## Why Specifications Matter in the AI Era
|
|
45
|
+
## π§ Why Specifications Matter in the AI Era
|
|
52
46
|
|
|
53
47
|
<p align="center">
|
|
54
|
-
<img src="media/why-specifications-matter.svg" alt="Why Specifications Matter
|
|
48
|
+
<img src="media/why-specifications-matter.svg" alt="Why Specifications Matter, From Vibe Coding to Deterministic Development" width="100%"/>
|
|
55
49
|
</p>
|
|
56
50
|
|
|
57
51
|
### The Problem: Vibe Coding
|
|
58
52
|
|
|
59
|
-
AI coding assistants are fast but chaotic. You say *"build me a login system"* and the AI generates code immediately
|
|
53
|
+
AI coding assistants are fast but chaotic. You say *"build me a login system"* and the AI generates code immediately, skipping requirements, guessing architecture, and producing something that works but doesn't match what anyone actually needed. This is **vibe coding**: generating code based on vibes instead of validated specifications.
|
|
60
54
|
|
|
61
55
|
The result? Teams spend 40% of their time on rework because requirements were never written down, acceptance criteria were never defined, and there's no way to verify the code matches the original intent.
|
|
62
56
|
|
|
63
57
|
### The Solution: Deterministic Development
|
|
64
58
|
|
|
65
|
-
**Specifications** are structured documents that describe *what the system must do* before anyone writes code. They've existed for decades in engineering, but AI development mostly ignores them. Specky brings them back
|
|
59
|
+
**Specifications** are structured documents that describe *what the system must do* before anyone writes code. They've existed for decades in engineering, but AI development mostly ignores them. Specky brings them back, with AI enforcement.
|
|
66
60
|
|
|
67
61
|
**Key concepts you should know:**
|
|
68
62
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
63
|
+
| Concept | What it is | Why it matters |
|
|
64
|
+
|---------|-----------|----------------|
|
|
65
|
+
| π **Markdown** | The universal language that both humans and AI read fluently | All spec artifacts are `.md` files in your repo, versioned with Git |
|
|
66
|
+
| π **MCP (Model Context Protocol)** | An open standard that lets AI assistants call external tools (like USB for AI) | Specky is an MCP server; any AI IDE can connect to it |
|
|
67
|
+
| π **EARS Notation** | A method for writing requirements that forces precision with 6 patterns | Eliminates vague statements like "the system should be fast" |
|
|
68
|
+
| π€ **Agents and Skills** | Specialized AI roles that invoke Specky tools with domain expertise | Defined in `.github/agents/` and `.claude/commands/` |
|
|
73
69
|
|
|
74
70
|
### How Specky Enforces Determinism
|
|
75
71
|
|
|
76
72
|
Specky adds a **deterministic engine** between your intent and your code:
|
|
77
73
|
|
|
78
|
-
- **State Machine
|
|
79
|
-
- **EARS Validator
|
|
80
|
-
- **Cross-Artifact Analysis
|
|
81
|
-
- **MCP-to-MCP Architecture
|
|
74
|
+
- **State Machine**: 10 mandatory phases, no skipping. Init, Discover, Specify, Clarify, Design, Tasks, Analyze, Implement, Verify, Release.
|
|
75
|
+
- **EARS Validator**: Every requirement validated against 6 patterns. No vague statements pass.
|
|
76
|
+
- **Cross-Artifact Analysis**: Automatic alignment checking between spec, design, and tasks. Orphaned requirements are flagged instantly.
|
|
77
|
+
- **MCP-to-MCP Architecture**: Specky outputs structured JSON that your AI client routes to GitHub, Azure DevOps, Jira, Terraform, Figma, and Docker MCP servers. No vendor lock-in.
|
|
82
78
|
|
|
83
79
|
> **The AI is the operator; Specky is the engine.** The AI's creativity is channeled through a validated pipeline instead of producing unstructured guesswork. For a complete educational walkthrough, see [GETTING-STARTED.md](GETTING-STARTED.md).
|
|
84
80
|
|
|
@@ -113,18 +109,17 @@ Specky adds a **deterministic engine** between your intent and your code:
|
|
|
113
109
|
|
|
114
110
|
</details>
|
|
115
111
|
|
|
116
|
-
---
|
|
117
112
|
|
|
118
|
-
## Quick Start
|
|
113
|
+
## π Quick Start
|
|
119
114
|
|
|
120
115
|
### Prerequisites
|
|
121
116
|
|
|
122
|
-
- **Node.js 18
|
|
123
|
-
- **An AI IDE or client
|
|
117
|
+
- **Node.js 18+**: [Download here](https://nodejs.org/)
|
|
118
|
+
- **An AI IDE or client**: VS Code with Copilot, Claude Code, Claude Desktop, Cursor, or Windsurf
|
|
124
119
|
|
|
125
120
|
### Option 1: npm (Recommended)
|
|
126
121
|
|
|
127
|
-
No installation needed
|
|
122
|
+
No installation needed. `npx` downloads and runs Specky on demand:
|
|
128
123
|
|
|
129
124
|
```bash
|
|
130
125
|
npx specky-sdd
|
|
@@ -139,7 +134,7 @@ specky-sdd
|
|
|
139
134
|
|
|
140
135
|
### Option 2: Docker
|
|
141
136
|
|
|
142
|
-
Run Specky as an HTTP server in a container
|
|
137
|
+
Run Specky as an HTTP server in a container, no Node.js required on the host:
|
|
143
138
|
|
|
144
139
|
```bash
|
|
145
140
|
# Pull and run (mounts your project into /workspace)
|
|
@@ -208,7 +203,7 @@ Create `.vscode/mcp.json` in your project root:
|
|
|
208
203
|
}
|
|
209
204
|
```
|
|
210
205
|
|
|
211
|
-
Open Copilot Chat
|
|
206
|
+
Open Copilot Chat. Specky's 47 tools are now available. Type `@specky` to scope your prompts.
|
|
212
207
|
|
|
213
208
|
</details>
|
|
214
209
|
|
|
@@ -283,7 +278,7 @@ Add to Cursor's MCP settings (Settings > MCP Servers):
|
|
|
283
278
|
</details>
|
|
284
279
|
|
|
285
280
|
<details>
|
|
286
|
-
<summary><strong>Docker (HTTP mode)
|
|
281
|
+
<summary><strong>Docker (HTTP mode), for any MCP client</strong></summary>
|
|
287
282
|
|
|
288
283
|
If your AI client supports HTTP-based MCP servers, point it to:
|
|
289
284
|
|
|
@@ -299,7 +294,7 @@ docker compose up -d
|
|
|
299
294
|
|
|
300
295
|
</details>
|
|
301
296
|
|
|
302
|
-
### Try It Now
|
|
297
|
+
### β
Try It Now
|
|
303
298
|
|
|
304
299
|
Once connected, type this in your AI chat to see Specky in action:
|
|
305
300
|
|
|
@@ -307,13 +302,18 @@ Once connected, type this in your AI chat to see Specky in action:
|
|
|
307
302
|
> Initialize a Specky project for a todo API and help me define the scope
|
|
308
303
|
```
|
|
309
304
|
|
|
310
|
-
Specky creates the project structure and asks you 7 discovery questions. From here, follow the
|
|
305
|
+
Specky creates the project structure and asks you 7 discovery questions. From here, follow the guide for your project type:
|
|
311
306
|
|
|
312
|
-
|
|
307
|
+
| Your situation | Guide |
|
|
308
|
+
|---------------|-------|
|
|
309
|
+
| π± Building something new | [Greenfield](#-greenfield-project-start-from-scratch) |
|
|
310
|
+
| π§ Adding features to existing code | [Brownfield](#-brownfield-project-add-features-to-existing-code) |
|
|
311
|
+
| π Upgrading a legacy system | [Modernization](#-modernization-project-assess-and-upgrade-legacy-systems) |
|
|
313
312
|
|
|
314
|
-
|
|
313
|
+
> π‘ **New to Spec-Driven Development?** Specky already includes all the SDD methodology from [Spec-Kit](https://github.com/paulasilvatech/spec-kit). Just install Specky and the pipeline guides you through every phase with [educative outputs](#-educative-outputs) that explain the concepts as you work.
|
|
315
314
|
|
|
316
|
-
|
|
315
|
+
|
|
316
|
+
## π Where Specifications Live
|
|
317
317
|
|
|
318
318
|
Every feature gets its own numbered directory inside `.specs/`. This keeps specifications, design documents, and quality reports together as a self-contained package.
|
|
319
319
|
|
|
@@ -339,11 +339,10 @@ your-project/
|
|
|
339
339
|
βββ .specky/config.yml β Optional project-level configuration
|
|
340
340
|
```
|
|
341
341
|
|
|
342
|
-
**Naming convention:** `NNN-feature-name
|
|
342
|
+
**Naming convention:** `NNN-feature-name`, zero-padded number + kebab-case name. Each directory is independent; you can work on multiple features simultaneously.
|
|
343
343
|
|
|
344
|
-
---
|
|
345
344
|
|
|
346
|
-
## Input Methods
|
|
345
|
+
## π₯ Input Methods: 6 Ways to Start
|
|
347
346
|
|
|
348
347
|
<p align="center">
|
|
349
348
|
<img src="media/input-methods.svg" alt="Specky 6 Input Methods" width="100%"/>
|
|
@@ -467,9 +466,8 @@ No file? Just paste the content directly. Every import tool accepts a `raw_text`
|
|
|
467
466
|
Import this and create a specification.
|
|
468
467
|
```
|
|
469
468
|
|
|
470
|
-
---
|
|
471
469
|
|
|
472
|
-
## Three Project Types
|
|
470
|
+
## ποΈ Three Project Types: One Pipeline
|
|
473
471
|
|
|
474
472
|
<p align="center">
|
|
475
473
|
<img src="media/project-workflows.svg" alt="Greenfield, Brownfield, and Modernization Workflows" width="100%"/>
|
|
@@ -477,9 +475,8 @@ No file? Just paste the content directly. Every import tool accepts a `raw_text`
|
|
|
477
475
|
|
|
478
476
|
Specky adapts to any project type. The pipeline is the same; the **starting point** is what changes.
|
|
479
477
|
|
|
480
|
-
---
|
|
481
478
|
|
|
482
|
-
## Greenfield Project
|
|
479
|
+
## π± Greenfield Project: Start from Scratch
|
|
483
480
|
|
|
484
481
|
**Scenario:** You're building a new application with no existing code.
|
|
485
482
|
|
|
@@ -493,13 +490,13 @@ Specky adapts to any project type. The pipeline is the same; the **starting poin
|
|
|
493
490
|
The AI calls `sdd_init` β creates `.specs/001-task-management/CONSTITUTION.md`
|
|
494
491
|
Then calls `sdd_discover` β asks you **7 structured questions**:
|
|
495
492
|
|
|
496
|
-
1. **Scope
|
|
497
|
-
2. **Users
|
|
498
|
-
3. **Constraints
|
|
499
|
-
4. **Integrations
|
|
500
|
-
5. **Performance
|
|
501
|
-
6. **Security
|
|
502
|
-
7. **Deployment
|
|
493
|
+
1. **Scope**: What problem does this solve? What are the boundaries of v1?
|
|
494
|
+
2. **Users**: Who are the primary users? What are their skill levels?
|
|
495
|
+
3. **Constraints**: Language, framework, hosting, budget, timeline?
|
|
496
|
+
4. **Integrations**: What external systems, APIs, or services?
|
|
497
|
+
5. **Performance**: Expected load, concurrent users, response times?
|
|
498
|
+
6. **Security**: Authentication, authorization, compliance requirements?
|
|
499
|
+
7. **Deployment**: CI/CD, monitoring, rollback strategy?
|
|
503
500
|
|
|
504
501
|
Answer each question. Your answers feed directly into the specification.
|
|
505
502
|
|
|
@@ -531,7 +528,7 @@ system shall return a 400 status with a descriptive error message.
|
|
|
531
528
|
### Step 3: Design the architecture
|
|
532
529
|
|
|
533
530
|
```
|
|
534
|
-
> LGTM
|
|
531
|
+
> LGTM.proceed to design
|
|
535
532
|
```
|
|
536
533
|
|
|
537
534
|
The AI calls `sdd_write_design` β creates `DESIGN.md` with:
|
|
@@ -546,7 +543,7 @@ Review and reply **LGTM**.
|
|
|
546
543
|
### Step 4: Break into tasks
|
|
547
544
|
|
|
548
545
|
```
|
|
549
|
-
> LGTM
|
|
546
|
+
> LGTM.create the task breakdown
|
|
550
547
|
```
|
|
551
548
|
|
|
552
549
|
The AI calls `sdd_write_tasks` β creates `TASKS.md` with implementation tasks mapped to acceptance criteria, dependencies, and estimated complexity.
|
|
@@ -581,11 +578,10 @@ The AI calls:
|
|
|
581
578
|
|
|
582
579
|
The AI calls `sdd_export_work_items` + `sdd_create_pr` β generates work item payloads and PR body with full spec traceability.
|
|
583
580
|
|
|
584
|
-
> **Next:** Learn about [EARS notation](#ears-notation) to understand the requirement patterns, or see [all 47 tools](#all-47-tools) for a complete reference.
|
|
581
|
+
> π **Next:** Learn about [EARS notation](#ears-notation) to understand the requirement patterns, or see [all 47 tools](#all-47-tools) for a complete reference.
|
|
585
582
|
|
|
586
|
-
---
|
|
587
583
|
|
|
588
|
-
## Brownfield Project
|
|
584
|
+
## π§ Brownfield Project: Add Features to Existing Code
|
|
589
585
|
|
|
590
586
|
**Scenario:** You have a running application and need to add a new feature with proper specifications.
|
|
591
587
|
|
|
@@ -653,11 +649,10 @@ If you have multiple features specified:
|
|
|
653
649
|
|
|
654
650
|
The AI calls `sdd_cross_analyze` β checks for contradictions, shared dependencies, and consistency issues across `.specs/001-*`, `.specs/002-*`, etc.
|
|
655
651
|
|
|
656
|
-
> **Next:** See [compliance frameworks](#compliance-frameworks) for regulatory validation, or [MCP integration](#mcp-integration-architecture) for routing to external tools.
|
|
652
|
+
> π **Next:** See [compliance frameworks](#compliance-frameworks) for regulatory validation, or [MCP integration](#mcp-integration-architecture) for routing to external tools.
|
|
657
653
|
|
|
658
|
-
---
|
|
659
654
|
|
|
660
|
-
## Modernization Project
|
|
655
|
+
## π Modernization Project: Assess and Upgrade Legacy Systems
|
|
661
656
|
|
|
662
657
|
**Scenario:** You have a legacy system that needs assessment, documentation, and incremental modernization.
|
|
663
658
|
|
|
@@ -671,7 +666,7 @@ The AI calls `sdd_scan_codebase` β maps the technology stack, directory tree,
|
|
|
671
666
|
|
|
672
667
|
### Step 2: Import all existing documentation
|
|
673
668
|
|
|
674
|
-
Gather everything you have
|
|
669
|
+
Gather everything you have.architecture documents, runbooks, meeting notes about the system:
|
|
675
670
|
|
|
676
671
|
```
|
|
677
672
|
> Batch import all documents from /docs/legacy-system/ into specs
|
|
@@ -733,17 +728,16 @@ The AI calls:
|
|
|
733
728
|
|
|
734
729
|
The AI calls `sdd_generate_onboarding` β creates a guide covering architecture decisions, codebase navigation, development workflow, and testing strategy.
|
|
735
730
|
|
|
736
|
-
> **Next:** See [compliance frameworks](#compliance-frameworks) for regulatory validation during modernization, or [project configuration](#project-configuration) to customize Specky for your team.
|
|
731
|
+
> π **Next:** See [compliance frameworks](#compliance-frameworks) for regulatory validation during modernization, or [project configuration](#project-configuration) to customize Specky for your team.
|
|
737
732
|
|
|
738
|
-
---
|
|
739
733
|
|
|
740
|
-
## Pipeline and LGTM Gates
|
|
734
|
+
## βοΈ Pipeline and LGTM Gates
|
|
741
735
|
|
|
742
736
|
<p align="center">
|
|
743
737
|
<img src="media/pipeline-lgtm-gates.svg" alt="Pipeline with LGTM Quality Gates" width="100%"/>
|
|
744
738
|
</p>
|
|
745
739
|
|
|
746
|
-
Every Specky project follows the same 10-phase pipeline. The state machine **blocks phase-skipping
|
|
740
|
+
Every Specky project follows the same 10-phase pipeline. The state machine **blocks phase-skipping**. You cannot jump from Init to Design without completing Specify first.
|
|
747
741
|
|
|
748
742
|
**LGTM gates:** After each major phase (Specify, Design, Tasks), the AI pauses and asks you to review. Reply **LGTM** to proceed. This ensures human oversight at every quality gate.
|
|
749
743
|
|
|
@@ -776,11 +770,10 @@ The AI calls `sdd_advance_phase` β moves the pipeline forward if all prerequis
|
|
|
776
770
|
|
|
777
771
|
All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live). See [Input Methods](#input-methods--6-ways-to-start) for how to feed data into the pipeline.
|
|
778
772
|
|
|
779
|
-
---
|
|
780
773
|
|
|
781
|
-
## All 47 Tools
|
|
774
|
+
## π§° All 47 Tools
|
|
782
775
|
|
|
783
|
-
### Input and Conversion (5)
|
|
776
|
+
### π₯ Input and Conversion (5)
|
|
784
777
|
|
|
785
778
|
| Tool | Description |
|
|
786
779
|
|------|-------------|
|
|
@@ -790,7 +783,7 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
790
783
|
| `sdd_batch_import` | Process folder of mixed documents |
|
|
791
784
|
| `sdd_figma_to_spec` | Figma design to requirements specification |
|
|
792
785
|
|
|
793
|
-
### Pipeline Core (8)
|
|
786
|
+
### π Pipeline Core (8)
|
|
794
787
|
|
|
795
788
|
| Tool | Description |
|
|
796
789
|
|------|-------------|
|
|
@@ -803,7 +796,7 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
803
796
|
| `sdd_run_analysis` | Quality gate analysis with coverage heatmap |
|
|
804
797
|
| `sdd_advance_phase` | Move to next pipeline phase |
|
|
805
798
|
|
|
806
|
-
### Quality and Validation (5)
|
|
799
|
+
### β
Quality and Validation (5)
|
|
807
800
|
|
|
808
801
|
| Tool | Description |
|
|
809
802
|
|------|-------------|
|
|
@@ -813,7 +806,7 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
813
806
|
| `sdd_cross_analyze` | Spec-design-tasks alignment with consistency score |
|
|
814
807
|
| `sdd_validate_ears` | Batch EARS requirement validation |
|
|
815
808
|
|
|
816
|
-
### Diagrams and Visualization (4)
|
|
809
|
+
### π Diagrams and Visualization (4)
|
|
817
810
|
|
|
818
811
|
| Tool | Description |
|
|
819
812
|
|------|-------------|
|
|
@@ -822,7 +815,7 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
822
815
|
| `sdd_generate_user_stories` | User stories with flow diagrams |
|
|
823
816
|
| `sdd_figma_diagram` | FigJam-ready diagram via Figma MCP |
|
|
824
817
|
|
|
825
|
-
### Infrastructure as Code (3)
|
|
818
|
+
### ποΈ Infrastructure as Code (3)
|
|
826
819
|
|
|
827
820
|
| Tool | Description |
|
|
828
821
|
|------|-------------|
|
|
@@ -830,7 +823,7 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
830
823
|
| `sdd_validate_iac` | Validation via Terraform MCP + Azure MCP |
|
|
831
824
|
| `sdd_generate_dockerfile` | Dockerfile + docker-compose from tech stack |
|
|
832
825
|
|
|
833
|
-
### Dev Environment (3)
|
|
826
|
+
### π» Dev Environment (3)
|
|
834
827
|
|
|
835
828
|
| Tool | Description |
|
|
836
829
|
|------|-------------|
|
|
@@ -838,7 +831,7 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
838
831
|
| `sdd_setup_codespaces` | GitHub Codespaces configuration |
|
|
839
832
|
| `sdd_generate_devcontainer` | .devcontainer/devcontainer.json generation |
|
|
840
833
|
|
|
841
|
-
### Integration and Export (5)
|
|
834
|
+
### π Integration and Export (5)
|
|
842
835
|
|
|
843
836
|
| Tool | Description |
|
|
844
837
|
|------|-------------|
|
|
@@ -848,7 +841,7 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
848
841
|
| `sdd_implement` | Ordered implementation plan with checkpoints |
|
|
849
842
|
| `sdd_research` | Resolve unknowns in RESEARCH.md |
|
|
850
843
|
|
|
851
|
-
### Documentation (4)
|
|
844
|
+
### π Documentation (4)
|
|
852
845
|
|
|
853
846
|
| Tool | Description |
|
|
854
847
|
|------|-------------|
|
|
@@ -857,7 +850,7 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
857
850
|
| `sdd_generate_runbook` | Operational runbook |
|
|
858
851
|
| `sdd_generate_onboarding` | Developer onboarding guide |
|
|
859
852
|
|
|
860
|
-
### Utility (5)
|
|
853
|
+
### π§ Utility (5)
|
|
861
854
|
|
|
862
855
|
| Tool | Description |
|
|
863
856
|
|------|-------------|
|
|
@@ -867,49 +860,42 @@ All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
|
867
860
|
| `sdd_metrics` | Project metrics dashboard |
|
|
868
861
|
| `sdd_amend` | Amend project constitution |
|
|
869
862
|
|
|
870
|
-
### Testing (2)
|
|
863
|
+
### π§ͺ Testing (2)
|
|
871
864
|
|
|
872
865
|
| Tool | Description |
|
|
873
866
|
|------|-------------|
|
|
874
867
|
| `sdd_generate_tests` | Generate test stubs from acceptance criteria (vitest/jest/playwright/pytest/junit/xunit) |
|
|
875
|
-
| `sdd_verify_tests` | Verify test results against requirements
|
|
868
|
+
| `sdd_verify_tests` | Verify test results against requirements, report traceability coverage |
|
|
876
869
|
|
|
877
|
-
---
|
|
878
870
|
|
|
879
|
-
## The Spec-Driven Development Platform
|
|
871
|
+
## ποΈ The Spec-Driven Development Platform
|
|
880
872
|
|
|
881
|
-
|
|
873
|
+
<p align="center">
|
|
874
|
+
<img src="media/specky-speckit-integration.svg" alt="How Spec-Kit and Specky Work Together in the GitHub + Microsoft Ecosystem" width="100%"/>
|
|
875
|
+
</p>
|
|
882
876
|
|
|
883
|
-
|
|
877
|
+
### How Spec-Kit and Specky Complement Each Other
|
|
884
878
|
|
|
885
|
-
|
|
879
|
+
**[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.
|
|
886
880
|
|
|
887
|
-
|
|
888
|
-
- 10-phase pipeline structure (Init β Release)
|
|
889
|
-
- 22 Markdown templates for all spec artifacts
|
|
890
|
-
- Quality gate patterns and traceability model
|
|
891
|
-
- Spec-Driven Development methodology and workflow
|
|
881
|
+
**Specky** is the MCP engine that reimplements that methodology as 47 enforceable tools with programmatic validation. It enforces **how** to do it.
|
|
892
882
|
|
|
893
|
-
|
|
883
|
+
| | Spec-Kit (Methodology) | Specky (Engine) |
|
|
884
|
+
|--|------------------------|-----------------|
|
|
885
|
+
| **What it is** | Prompt templates + agent definitions | MCP server with 47 tools |
|
|
886
|
+
| **How it works** | AI reads `.md` templates and follows instructions | AI calls tools that validate, enforce, and generate |
|
|
887
|
+
| **Validation** | AI tries to follow the prompts | State machine, EARS regex, Zod schemas |
|
|
888
|
+
| **Install** | Copy `.github/agents/` and `.claude/commands/` | `npx specky-sdd` (includes methodology built-in) |
|
|
889
|
+
| **Works standalone** | Yes, in any AI IDE | Yes, includes all Spec-Kit patterns |
|
|
890
|
+
| **Best for** | Learning SDD, lightweight adoption | Production enforcement, enterprise, compliance |
|
|
894
891
|
|
|
895
|
-
|
|
896
|
-
- **State machine** β blocks phase-skipping, enforces prerequisites
|
|
897
|
-
- **EARS validator** β regex-based requirement validation, flags vague terms
|
|
898
|
-
- **6 input types** β transcripts, documents, Figma, codebase scan, raw text, prompts
|
|
899
|
-
- **Compliance engines** β HIPAA, SOC2, GDPR, PCI-DSS, ISO 27001
|
|
900
|
-
- **Test generation** β 6 frameworks (vitest, jest, playwright, pytest, junit, xunit)
|
|
901
|
-
- **MCP-to-MCP routing** β structured payloads for GitHub, Azure DevOps, Jira, Terraform, Figma, Docker
|
|
902
|
-
- **Cross-artifact analysis** β automatic alignment checking with consistency scoring
|
|
903
|
-
- **Educative outputs** β every tool explains what it did and what to do next
|
|
892
|
+
### Together: The Complete SDD Layer
|
|
904
893
|
|
|
905
|
-
|
|
894
|
+
When you install Specky, you get the full Spec-Kit methodology reimplemented as validated MCP tools. **No separate installation of Spec-Kit needed.** But Spec-Kit remains available as a standalone learning tool for teams that want to adopt SDD concepts before using the engine.
|
|
906
895
|
|
|
907
|
-
|
|
908
|
-
- Learn SDD concepts before using the full platform
|
|
909
|
-
- Work in environments where MCP servers aren't available
|
|
910
|
-
- Use the prompt templates with any AI tool that doesn't support MCP
|
|
896
|
+
Together they form the **SDD layer** of the GitHub + Microsoft enterprise platform, competing with standalone approaches like Kiro (AWS), Cursor, and Windsurf.
|
|
911
897
|
|
|
912
|
-
|
|
898
|
+
> π‘ **Key insight from the [SDD Market Analysis 2026](https://paulanunes85.github.io/sdd-market-analysis-2026/)**: SDD workflow scores are at competitive parity (4:4 tie). The enterprise platform surrounding the SDD layer is the differentiator: security, governance, multi-model freedom, and compliance. GitHub + Microsoft scores 4.25/5.0 vs Kiro's 2.85/5.0.
|
|
913
899
|
|
|
914
900
|
```json
|
|
915
901
|
{
|
|
@@ -922,9 +908,8 @@ But for production use, **Specky is all you need**:
|
|
|
922
908
|
}
|
|
923
909
|
```
|
|
924
910
|
|
|
925
|
-
---
|
|
926
911
|
|
|
927
|
-
## Project Configuration
|
|
912
|
+
## βοΈ Project Configuration
|
|
928
913
|
|
|
929
914
|
Create `.specky/config.yml` in your project root to customize Specky:
|
|
930
915
|
|
|
@@ -938,9 +923,8 @@ audit_enabled: true # Enable audit trail
|
|
|
938
923
|
|
|
939
924
|
When `templates_path` is set, Specky uses your custom templates instead of the built-in ones. When `audit_enabled` is true, tool invocations are logged locally.
|
|
940
925
|
|
|
941
|
-
---
|
|
942
926
|
|
|
943
|
-
## MCP Integration Architecture
|
|
927
|
+
## π MCP Integration Architecture
|
|
944
928
|
|
|
945
929
|
<p align="center">
|
|
946
930
|
<img src="media/architecture-mcp-ecosystem.svg" alt="Specky MCP Ecosystem Architecture" width="100%"/>
|
|
@@ -971,9 +955,8 @@ Specky --> sdd_figma_to_spec(file_key: "abc123") --> Figma request
|
|
|
971
955
|
| **Figma MCP** | Design context, FigJam diagrams |
|
|
972
956
|
| **Docker MCP** | Local dev environments |
|
|
973
957
|
|
|
974
|
-
---
|
|
975
958
|
|
|
976
|
-
## EARS Notation
|
|
959
|
+
## π EARS Notation
|
|
977
960
|
|
|
978
961
|
Every requirement in Specky follows EARS (Easy Approach to Requirements Syntax):
|
|
979
962
|
|
|
@@ -988,21 +971,19 @@ Every requirement in Specky follows EARS (Easy Approach to Requirements Syntax):
|
|
|
988
971
|
|
|
989
972
|
The EARS validator programmatically checks every requirement against these 6 patterns. Vague terms like "fast", "good", "easy" are flagged automatically.
|
|
990
973
|
|
|
991
|
-
---
|
|
992
974
|
|
|
993
|
-
## Compliance Frameworks
|
|
975
|
+
## π‘οΈ Compliance Frameworks
|
|
994
976
|
|
|
995
977
|
Built-in compliance checking against:
|
|
996
978
|
|
|
997
|
-
- **HIPAA
|
|
998
|
-
- **SOC 2
|
|
999
|
-
- **GDPR
|
|
1000
|
-
- **PCI-DSS
|
|
1001
|
-
- **ISO 27001
|
|
979
|
+
- **HIPAA**: Access control, audit, encryption, PHI protection
|
|
980
|
+
- **SOC 2**: Logical access, monitoring, change management, incident response
|
|
981
|
+
- **GDPR**: Lawful processing, right to erasure, data portability, breach notification
|
|
982
|
+
- **PCI-DSS**: Firewall, stored data protection, encryption, user identification
|
|
983
|
+
- **ISO 27001**: Security policies, access control, cryptography, incident management
|
|
1002
984
|
|
|
1003
|
-
---
|
|
1004
985
|
|
|
1005
|
-
## Educative Outputs
|
|
986
|
+
## π‘ Educative Outputs
|
|
1006
987
|
|
|
1007
988
|
Every tool response includes structured guidance:
|
|
1008
989
|
|
|
@@ -1015,29 +996,27 @@ Every tool response includes structured guidance:
|
|
|
1015
996
|
}
|
|
1016
997
|
```
|
|
1017
998
|
|
|
1018
|
-
---
|
|
1019
999
|
|
|
1020
|
-
## End-to-End Flow
|
|
1000
|
+
## π End-to-End Flow
|
|
1021
1001
|
|
|
1022
1002
|
<p align="center">
|
|
1023
1003
|
<img src="media/end-to-end-flow.svg" alt="Specky End-to-End Development Flow" width="100%"/>
|
|
1024
1004
|
</p>
|
|
1025
1005
|
|
|
1026
|
-
From any [input](#input-methods--6-ways-to-start) to production
|
|
1006
|
+
From any [input](#input-methods--6-ways-to-start) to production.fully automated, [MCP-orchestrated](#mcp-integration-architecture), with artifacts and diagrams generated at every step. All artifacts are saved in [`.specs/NNN-feature/`](#where-specifications-live).
|
|
1027
1007
|
|
|
1028
|
-
---
|
|
1029
1008
|
|
|
1030
|
-
## Enterprise Ready
|
|
1009
|
+
## π’ Enterprise Ready
|
|
1031
1010
|
|
|
1032
1011
|
Specky is built with enterprise adoption in mind.
|
|
1033
1012
|
|
|
1034
1013
|
### Security Posture
|
|
1035
1014
|
|
|
1036
|
-
- **2 runtime dependencies
|
|
1037
|
-
- **Zero outbound network requests
|
|
1038
|
-
- **No `eval()` or dynamic code execution
|
|
1039
|
-
- **Path traversal prevention
|
|
1040
|
-
- **Zod `.strict()` validation
|
|
1015
|
+
- **2 runtime dependencies**.minimal attack surface (`@modelcontextprotocol/sdk`, `zod`)
|
|
1016
|
+
- **Zero outbound network requests**.all data stays local
|
|
1017
|
+
- **No `eval()` or dynamic code execution**.template rendering is string replacement only
|
|
1018
|
+
- **Path traversal prevention**: FileManager sanitizes all paths, blocks `..` sequences
|
|
1019
|
+
- **Zod `.strict()` validation**.every tool input is schema-validated; unknown fields rejected
|
|
1041
1020
|
- See [SECURITY.md](SECURITY.md) for full OWASP Top 10 coverage
|
|
1042
1021
|
|
|
1043
1022
|
### Compliance Validation
|
|
@@ -1058,14 +1037,13 @@ Every pipeline phase produces a traceable artifact in `.specs/NNN-feature/`. The
|
|
|
1058
1037
|
|
|
1059
1038
|
### Quality Gates
|
|
1060
1039
|
|
|
1061
|
-
- **EARS Validator
|
|
1062
|
-
- **Cross-Artifact Analysis
|
|
1063
|
-
- **Phase Enforcement
|
|
1040
|
+
- **EARS Validator**.programmatic requirement quality enforcement
|
|
1041
|
+
- **Cross-Artifact Analysis**.automatic alignment checking between spec, design, and tasks
|
|
1042
|
+
- **Phase Enforcement**.state machine blocks phase-skipping; required files gate advancement
|
|
1064
1043
|
- **211 unit tests** with 89% code coverage; CI enforces thresholds on every push
|
|
1065
1044
|
|
|
1066
|
-
---
|
|
1067
1045
|
|
|
1068
|
-
## Development
|
|
1046
|
+
## π οΈ Development
|
|
1069
1047
|
|
|
1070
1048
|
```bash
|
|
1071
1049
|
# Clone and setup
|
|
@@ -1094,24 +1072,64 @@ docker run -p 3200:3200 -v $(pwd):/workspace specky-sdd:dev
|
|
|
1094
1072
|
curl http://localhost:3200/health
|
|
1095
1073
|
```
|
|
1096
1074
|
|
|
1097
|
-
---
|
|
1098
1075
|
|
|
1099
|
-
##
|
|
1076
|
+
## πΊοΈ Roadmap
|
|
1077
|
+
|
|
1078
|
+
### v2.2 (current, stable)
|
|
1079
|
+
|
|
1080
|
+
Specky v2.2 is **production-ready** for teams and organizations adopting Spec-Driven Development.
|
|
1081
|
+
|
|
1082
|
+
| Capability | Status |
|
|
1083
|
+
|------------|--------|
|
|
1084
|
+
| 47 MCP tools across 10 pipeline phases | β
Stable |
|
|
1085
|
+
| State machine enforcement (no phase-skipping) | β
Stable |
|
|
1086
|
+
| EARS validation (6 patterns, vague term detection) | β
Stable |
|
|
1087
|
+
| 6 input types (transcript, PDF, DOCX, Figma, codebase, raw text) | β
Stable |
|
|
1088
|
+
| Compliance checking (HIPAA, SOC2, GDPR, PCI-DSS, ISO 27001) | β
Stable |
|
|
1089
|
+
| Test generation (vitest, jest, playwright, pytest, junit, xunit) | β
Stable |
|
|
1090
|
+
| MCP-to-MCP routing (GitHub, Azure DevOps, Jira, Terraform, Figma, Docker) | β
Stable |
|
|
1091
|
+
| Docker deployment with health check | β
Stable |
|
|
1092
|
+
| 211 unit tests, 89% code coverage | β
Stable |
|
|
1093
|
+
| `.github/agents/` + `.claude/commands/` integration | β
Stable |
|
|
1094
|
+
|
|
1095
|
+
### v2.3 (planned)
|
|
1096
|
+
|
|
1097
|
+
| Feature | Description |
|
|
1098
|
+
|---------|-------------|
|
|
1099
|
+
| π HTTP authentication | Token-based auth for the HTTP transport (Docker/container mode) |
|
|
1100
|
+
| π Observability | OpenTelemetry metrics and structured logging for tool invocations |
|
|
1101
|
+
| π Spec versioning | Track specification versions with diff and rollback support |
|
|
1102
|
+
| π Internationalization | Spec templates in multiple languages (PT-BR, ES, FR, DE, JA) |
|
|
1103
|
+
|
|
1104
|
+
### v3.0 (future)
|
|
1105
|
+
|
|
1106
|
+
| Feature | Description |
|
|
1107
|
+
|---------|-------------|
|
|
1108
|
+
| π₯ RBAC | Role-based access control for pipeline phase advancement |
|
|
1109
|
+
| π Persistent audit log | Centralized audit trail beyond `.sdd-state.json` |
|
|
1110
|
+
| β‘ Rate limiting | Request throttling for multi-tenant deployments |
|
|
1111
|
+
| π SSO/SAML | Enterprise identity provider integration |
|
|
1112
|
+
| π’ Multi-tenant | Isolated workspaces for multiple teams on a single server |
|
|
1113
|
+
| π Analytics dashboard | Specification quality metrics over time |
|
|
1114
|
+
|
|
1115
|
+
> π‘ Have a feature request? [Open an issue](https://github.com/paulasilvatech/specky/issues) on GitHub.
|
|
1116
|
+
|
|
1117
|
+
|
|
1118
|
+
## π€ Contributing
|
|
1100
1119
|
|
|
1101
1120
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for architecture details and how to add tools, templates, or services.
|
|
1102
1121
|
|
|
1103
|
-
---
|
|
1104
1122
|
|
|
1105
|
-
## Links
|
|
1123
|
+
## π Links
|
|
1106
1124
|
|
|
1107
|
-
- [CHANGELOG.md](CHANGELOG.md)
|
|
1108
|
-
- [SECURITY.md](SECURITY.md)
|
|
1109
|
-
- [CONTRIBUTING.md](CONTRIBUTING.md)
|
|
1110
|
-
- [Spec-Kit](https://github.com/paulasilvatech/spec-kit)
|
|
1111
|
-
- [
|
|
1125
|
+
- [CHANGELOG.md](CHANGELOG.md): Version history and release notes
|
|
1126
|
+
- [SECURITY.md](SECURITY.md): Vulnerability disclosure policy and OWASP Top 10 coverage
|
|
1127
|
+
- [CONTRIBUTING.md](CONTRIBUTING.md): How to add tools, templates, or services
|
|
1128
|
+
- [Spec-Kit](https://github.com/paulasilvatech/spec-kit): The SDD methodology foundation
|
|
1129
|
+
- [SDD Market Analysis 2026](https://paulanunes85.github.io/sdd-market-analysis-2026/): Enterprise readiness comparison
|
|
1130
|
+
- [npm package](https://www.npmjs.com/package/specky-sdd): `specky-sdd` on npm
|
|
1112
1131
|
|
|
1113
|
-
---
|
|
1114
1132
|
|
|
1115
|
-
## License
|
|
1133
|
+
## π License
|
|
1116
1134
|
|
|
1117
|
-
MIT
|
|
1135
|
+
MIT. Created by [Paula Silva](https://github.com/paulasilvatech) | Americas Software GBB, Microsoft
|
package/dist/constants.d.ts
CHANGED
|
@@ -2,8 +2,7 @@
|
|
|
2
2
|
* Specky MCP Server β Constants
|
|
3
3
|
* All shared constants, enums, and configuration values.
|
|
4
4
|
*/
|
|
5
|
-
|
|
6
|
-
export declare const VERSION = "2.2.0";
|
|
5
|
+
export declare const VERSION: string;
|
|
7
6
|
/** Server name for MCP handshake */
|
|
8
7
|
export declare const SERVER_NAME = "specky";
|
|
9
8
|
/** Total tool count for ecosystem check */
|
package/dist/constants.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;
|
|
1
|
+
{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}
|
package/dist/constants.js
CHANGED
|
@@ -2,8 +2,11 @@
|
|
|
2
2
|
* Specky MCP Server β Constants
|
|
3
3
|
* All shared constants, enums, and configuration values.
|
|
4
4
|
*/
|
|
5
|
-
/** Specky server version β
|
|
6
|
-
|
|
5
|
+
/** Specky server version β read from package.json at build time */
|
|
6
|
+
import { createRequire } from "node:module";
|
|
7
|
+
const _require = createRequire(import.meta.url);
|
|
8
|
+
const _pkg = _require("../package.json");
|
|
9
|
+
export const VERSION = _pkg.version;
|
|
7
10
|
/** Server name for MCP handshake */
|
|
8
11
|
export const SERVER_NAME = "specky";
|
|
9
12
|
/** Total tool count for ecosystem check */
|
package/dist/constants.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,
|
|
1
|
+
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specky-sdd",
|
|
3
|
-
"version": "2.2.
|
|
3
|
+
"version": "2.2.3",
|
|
4
4
|
"description": "Specky β The open-source MCP server for Spec-Driven Development (SDD). Transforms natural language into production-grade specifications with EARS notation, architecture design, and quality gates.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|