smart-spec-kit-mcp 2.0.3 → 2.0.5

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.
@@ -2,13 +2,15 @@
2
2
  * Starter Kit Installer
3
3
  *
4
4
  * Handles the installation of Spec-Kit starter kit into user projects.
5
- * Copies prompts to .github/prompts/ and templates to .spec-kit/
5
+ * Copies prompts to .spec-kit/prompts/ and copilot-instructions.md to .github/
6
6
  */
7
7
  import * as fs from "node:fs/promises";
8
8
  import * as path from "node:path";
9
9
  // Directory constants
10
- const GITHUB_PROMPTS_DIR = ".github/prompts";
10
+ const GITHUB_DIR = ".github";
11
+ const COPILOT_INSTRUCTIONS = "copilot-instructions.md";
11
12
  const SPEC_KIT_DIR = ".spec-kit";
13
+ const PROMPTS_DIR = "prompts";
12
14
  const TEMPLATES_DIR = "templates";
13
15
  const MEMORY_DIR = "memory";
14
16
  const SPECS_DIR = "specs";
@@ -75,19 +77,19 @@ export async function installStarterKit(projectPath, options = {}) {
75
77
  };
76
78
  const packageRoot = getPackageRoot();
77
79
  const starterKitPath = path.join(packageRoot, "starter-kit");
78
- // 1. Install prompts to .github/prompts/
80
+ // 1. Install prompts to .spec-kit/prompts/
79
81
  if (!options.skipPrompts) {
80
82
  const promptsSrc = path.join(starterKitPath, "prompts");
81
- const promptsDest = path.join(projectPath, GITHUB_PROMPTS_DIR);
83
+ const promptsDest = path.join(projectPath, SPEC_KIT_DIR, PROMPTS_DIR);
82
84
  if (await exists(promptsSrc)) {
83
85
  const promptsExist = await exists(promptsDest);
84
86
  if (promptsExist && !options.force) {
85
- result.skipped.push(GITHUB_PROMPTS_DIR);
87
+ result.skipped.push(`${SPEC_KIT_DIR}/${PROMPTS_DIR}`);
86
88
  }
87
89
  else {
88
90
  try {
89
91
  await copyDir(promptsSrc, promptsDest);
90
- result.created.push(GITHUB_PROMPTS_DIR);
92
+ result.created.push(`${SPEC_KIT_DIR}/${PROMPTS_DIR}`);
91
93
  }
92
94
  catch (error) {
93
95
  result.errors.push(`Failed to copy prompts: ${error}`);
@@ -98,6 +100,26 @@ export async function installStarterKit(projectPath, options = {}) {
98
100
  else {
99
101
  result.errors.push(`Prompts source not found: ${promptsSrc}`);
100
102
  }
103
+ // Copy copilot-instructions.md to .github/
104
+ const instructionsSrc = path.join(starterKitPath, COPILOT_INSTRUCTIONS);
105
+ const instructionsDest = path.join(projectPath, GITHUB_DIR, COPILOT_INSTRUCTIONS);
106
+ if (await exists(instructionsSrc)) {
107
+ const instructionsExist = await exists(instructionsDest);
108
+ if (instructionsExist && !options.force) {
109
+ result.skipped.push(`${GITHUB_DIR}/${COPILOT_INSTRUCTIONS}`);
110
+ }
111
+ else {
112
+ try {
113
+ await fs.mkdir(path.join(projectPath, GITHUB_DIR), { recursive: true });
114
+ await fs.copyFile(instructionsSrc, instructionsDest);
115
+ result.created.push(`${GITHUB_DIR}/${COPILOT_INSTRUCTIONS}`);
116
+ }
117
+ catch (error) {
118
+ result.errors.push(`Failed to copy copilot-instructions: ${error}`);
119
+ result.success = false;
120
+ }
121
+ }
122
+ }
101
123
  }
102
124
  // 2. Install templates to .spec-kit/templates/
103
125
  if (!options.skipTemplates) {
@@ -214,18 +236,18 @@ export function formatInstallReport(result, projectPath) {
214
236
  report += "```\n";
215
237
  report += `${path.basename(projectPath)}/\n`;
216
238
  report += "├── .github/\n";
217
- report += "│ └── prompts/ # Slash commands for Copilot\n";
218
- report += "│ ├── speckit.init.md\n";
219
- report += "│ ├── speckit.specify.md\n";
220
- report += "│ ├── speckit.clarify.md\n";
221
- report += "│ ├── speckit.plan.md\n";
222
- report += "│ ├── speckit.tasks.md\n";
223
- report += "│ └── speckit.implement.md\n";
239
+ report += "│ └── copilot-instructions.md # Instructions for Copilot\n";
224
240
  report += "├── .spec-kit/\n";
225
- report += "│ ├── templates/ # Specification templates\n";
226
- report += "│ └── memory/ # Project context\n";
227
- report += "│ └── constitution.md # Project principles\n";
228
- report += "└── specs/ # Generated specifications\n";
241
+ report += "│ ├── prompts/ # Prompt-as-code files (read by MCP)\n";
242
+ report += "│ │ ├── specify.md\n";
243
+ report += "│ │ ├── plan.md\n";
244
+ report += "│ │ ├── tasks.md\n";
245
+ report += "│ │ ├── implement.md\n";
246
+ report += "│ │ └── clarify.md\n";
247
+ report += "│ ├── templates/ # Specification templates\n";
248
+ report += "│ └── memory/ # Project context\n";
249
+ report += "│ └── constitution.md # Project principles\n";
250
+ report += "└── specs/ # Generated specifications\n";
229
251
  report += "```\n\n";
230
252
  report += "## VS Code Configuration\n\n";
231
253
  report += "Add this to your `.vscode/settings.json` to enable MCP tools:\n\n";
@@ -234,20 +256,19 @@ export function formatInstallReport(result, projectPath) {
234
256
  report += "\n```\n\n";
235
257
  report += "## Next Steps\n\n";
236
258
  report += "1. **Edit your constitution**: `.spec-kit/memory/constitution.md`\n";
237
- report += "2. **Use slash commands** in Copilot Chat:\n";
238
- report += " - `/speckit.specify` - Create a specification\n";
239
- report += " - `/speckit.plan` - Create implementation plan\n";
240
- report += " - `/speckit.tasks` - Generate task breakdown\n";
241
- report += " - `/speckit.implement` - Start implementation\n\n";
259
+ report += "2. **Use spec-kit commands** in Copilot Chat:\n";
260
+ report += " - `speckit: spec` - Create a specification\n";
261
+ report += " - `speckit: plan` - Create implementation plan\n";
262
+ report += " - `speckit: tasks` - Generate task breakdown\n";
263
+ report += " - `speckit: implement` - Start implementation\n\n";
242
264
  report += "## Available Commands\n\n";
243
265
  report += "| Command | Description |\n";
244
266
  report += "|---------|-------------|\n";
245
- report += "| `/speckit.init` | Initialize Spec-Kit in a project |\n";
246
- report += "| `/speckit.specify` | Create specification from requirements |\n";
247
- report += "| `/speckit.clarify` | Clarify ambiguous requirements |\n";
248
- report += "| `/speckit.plan` | Create technical implementation plan |\n";
249
- report += "| `/speckit.tasks` | Generate task breakdown |\n";
250
- report += "| `/speckit.implement` | Execute implementation tasks |\n";
267
+ report += "| `speckit: spec` | Create specification from requirements |\n";
268
+ report += "| `speckit: clarify` | Clarify ambiguous requirements |\n";
269
+ report += "| `speckit: plan` | Create technical implementation plan |\n";
270
+ report += "| `speckit: tasks` | Generate task breakdown |\n";
271
+ report += "| `speckit: implement` | Execute implementation tasks |\n";
251
272
  return report;
252
273
  }
253
274
  /**
@@ -255,7 +276,8 @@ export function formatInstallReport(result, projectPath) {
255
276
  */
256
277
  export async function isSpecKitInstalled(projectPath) {
257
278
  return {
258
- hasPrompts: await exists(path.join(projectPath, GITHUB_PROMPTS_DIR)),
279
+ hasPrompts: await exists(path.join(projectPath, SPEC_KIT_DIR, PROMPTS_DIR)),
280
+ hasInstructions: await exists(path.join(projectPath, GITHUB_DIR, COPILOT_INSTRUCTIONS)),
259
281
  hasTemplates: await exists(path.join(projectPath, SPEC_KIT_DIR, TEMPLATES_DIR)),
260
282
  hasMemory: await exists(path.join(projectPath, SPEC_KIT_DIR, MEMORY_DIR)),
261
283
  hasSpecs: await exists(path.join(projectPath, SPECS_DIR)),
@@ -1 +1 @@
1
- {"version":3,"file":"starterKitInstaller.js","sourceRoot":"","sources":["../../src/utils/starterKitInstaller.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"starterKitInstaller.js","sourceRoot":"","sources":["../../src/utils/starterKitInstaller.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,379 @@
1
+ # Spec-Kit Documentation
2
+
3
+ This is the comprehensive documentation for Spec-Kit. Copilot can read this file to answer user questions.
4
+
5
+ ## Overview
6
+
7
+ Spec-Kit is an MCP (Model Context Protocol) server that provides **Prompt-as-Code** functionality for specification-driven development. It integrates with GitHub Copilot in VS Code to guide developers through creating specifications, plans, tasks, and implementation.
8
+
9
+ ## Architecture
10
+
11
+ ### Components
12
+
13
+ 1. **MCP Server** (`smart-spec-kit-mcp`)
14
+ - Runs as a background process
15
+ - Exposes tools via Model Context Protocol
16
+ - Communicates with GitHub Copilot
17
+
18
+ 2. **Copilot Instructions** (`.github/copilot-instructions.md`)
19
+ - Tells Copilot how to use Spec-Kit tools
20
+ - Defines command keywords and aliases
21
+
22
+ 3. **Prompts** (`.spec-kit/prompts/`)
23
+ - Prompt-as-Code files read by MCP tools
24
+ - Define behavior for each command
25
+ - Customizable per project
26
+
27
+ 4. **Templates** (`.spec-kit/templates/`)
28
+ - Document templates for specs, plans, tasks
29
+ - Markdown format
30
+
31
+ 5. **Constitution** (`.spec-kit/memory/constitution.md`)
32
+ - Project principles and conventions
33
+ - Technical stack definition
34
+ - Development guidelines
35
+
36
+ 6. **Workflows** (`.spec-kit/workflows/`)
37
+ - YAML-based workflow definitions
38
+ - Multi-step automated processes
39
+
40
+ ---
41
+
42
+ ## MCP Tools
43
+
44
+ ### speckit_specify
45
+
46
+ **Purpose**: Create a functional specification from requirements.
47
+
48
+ **Triggers**: `speckit: spec`, `speckit: specify`, `créer une spec`
49
+
50
+ **Parameters**:
51
+ - `requirements` (required): The requirements to specify
52
+ - `contextId` (optional): ID for the specification filename
53
+
54
+ **Behavior**:
55
+ 1. Loads prompt from `.spec-kit/prompts/specify.md`
56
+ 2. Loads constitution from `.spec-kit/memory/constitution.md`
57
+ 3. Loads template from `.spec-kit/templates/functional-spec.md`
58
+ 4. Returns context for Copilot to generate the specification
59
+ 5. Output saved to `specs/{contextId}-spec.md`
60
+
61
+ ### speckit_plan
62
+
63
+ **Purpose**: Create an implementation plan from a specification.
64
+
65
+ **Triggers**: `speckit: plan`, `planifier`, `créer un plan`
66
+
67
+ **Parameters**:
68
+ - `specPath` (optional): Path to specification file
69
+
70
+ **Behavior**:
71
+ 1. Finds the most recent specification in `specs/`
72
+ 2. Loads prompt from `.spec-kit/prompts/plan.md`
73
+ 3. Returns context for generating the plan
74
+ 4. Output saved to `specs/plan.md`
75
+
76
+ ### speckit_tasks
77
+
78
+ **Purpose**: Generate a task breakdown from a plan.
79
+
80
+ **Triggers**: `speckit: tasks`, `générer les tâches`, `créer les tâches`
81
+
82
+ **Parameters**:
83
+ - `planPath` (optional): Path to plan file
84
+
85
+ **Behavior**:
86
+ 1. Finds the most recent plan in `specs/`
87
+ 2. Loads prompt from `.spec-kit/prompts/tasks.md`
88
+ 3. Returns context for generating tasks
89
+ 4. Output saved to `specs/tasks.md`
90
+
91
+ ### speckit_implement
92
+
93
+ **Purpose**: Implement tasks one by one.
94
+
95
+ **Triggers**: `speckit: implement`, `implémenter`, `coder`
96
+
97
+ **Parameters**:
98
+ - `taskId` (optional): Specific task ID to implement
99
+
100
+ **Behavior**:
101
+ 1. Loads tasks from `specs/tasks.md`
102
+ 2. Finds next pending task (or specified task)
103
+ 3. Loads prompt from `.spec-kit/prompts/implement.md`
104
+ 4. Returns context for implementation
105
+ 5. Updates task status after completion
106
+
107
+ ### speckit_clarify
108
+
109
+ **Purpose**: Clarify ambiguous requirements.
110
+
111
+ **Triggers**: `speckit: clarify`, `clarifier`, `préciser`
112
+
113
+ **Parameters**:
114
+ - `specPath` (optional): Path to specification
115
+ - `questions` (optional): Specific questions
116
+
117
+ **Behavior**:
118
+ 1. Finds `[NEEDS CLARIFICATION]` markers
119
+ 2. Loads prompt from `.spec-kit/prompts/clarify.md`
120
+ 3. Returns targeted questions for stakeholders
121
+
122
+ ### speckit_help
123
+
124
+ **Purpose**: Provide help and documentation.
125
+
126
+ **Triggers**: `speckit: help`, `aide sur speckit`
127
+
128
+ **Parameters**:
129
+ - `topic` (optional): Specific topic to get help on
130
+
131
+ **Topics covered**:
132
+ - Commands and usage
133
+ - Customization (prompts, templates, workflows)
134
+ - Troubleshooting
135
+ - Architecture
136
+
137
+ ---
138
+
139
+ ## Customization Guide
140
+
141
+ ### Modifying Prompts
142
+
143
+ Prompts control how each command behaves. Edit files in `.spec-kit/prompts/`:
144
+
145
+ ```markdown
146
+ # .spec-kit/prompts/specify.md
147
+
148
+ ## My Custom Specification Process
149
+
150
+ 1. First, analyze the business need
151
+ 2. Then identify technical constraints
152
+ ...
153
+ ```
154
+
155
+ Changes take effect immediately - no restart needed.
156
+
157
+ ### Creating Custom Templates
158
+
159
+ Templates define document structure. Create/edit in `.spec-kit/templates/`:
160
+
161
+ ```markdown
162
+ # .spec-kit/templates/my-template.md
163
+
164
+ # {Title}
165
+
166
+ ## Summary
167
+ {summary}
168
+
169
+ ## Requirements
170
+ {requirements}
171
+
172
+ ## Technical Notes
173
+ {notes}
174
+ ```
175
+
176
+ ### Creating a New Workflow
177
+
178
+ Workflows are YAML files defining multi-step processes:
179
+
180
+ ```yaml
181
+ # .spec-kit/workflows/my-workflow.yaml
182
+
183
+ name: my-workflow
184
+ displayName: "My Custom Workflow"
185
+ description: "Does something specific"
186
+ template: my-template.md
187
+ defaultAgent: SpecAgent
188
+
189
+ steps:
190
+ - id: step1
191
+ name: "First Step"
192
+ action: call_agent
193
+ agent: SpecAgent
194
+ description: "What this step does"
195
+ inputs:
196
+ - name: input1
197
+ description: "Description"
198
+ required: true
199
+
200
+ - id: step2
201
+ name: "Second Step"
202
+ action: call_agent
203
+ agent: PlanAgent
204
+ dependsOn: [step1]
205
+ description: "What this step does"
206
+ ```
207
+
208
+ **Available actions**:
209
+ - `call_agent` - Call an AI agent
210
+ - `fetch_ado` - Fetch Azure DevOps work item
211
+ - `save_artifact` - Save to file
212
+ - `validate` - Validate output
213
+
214
+ **Available agents**:
215
+ - `SpecAgent` - Writes specifications
216
+ - `PlanAgent` - Creates plans
217
+ - `GovAgent` - Validates governance
218
+ - `TestAgent` - Creates test strategies
219
+
220
+ ### Editing the Constitution
221
+
222
+ The constitution defines project principles. Edit `.spec-kit/memory/constitution.md`:
223
+
224
+ ```markdown
225
+ # Project Constitution
226
+
227
+ ## Technical Stack
228
+ - Language: TypeScript
229
+ - Framework: React + Node.js
230
+ - Database: PostgreSQL
231
+ - Testing: Jest + Playwright
232
+
233
+ ## Development Principles
234
+ 1. Clean Architecture - separate concerns
235
+ 2. Test-Driven Development
236
+ 3. Code review required for all changes
237
+ 4. Documentation as code
238
+
239
+ ## Naming Conventions
240
+ - Files: kebab-case
241
+ - Components: PascalCase
242
+ - Functions: camelCase
243
+
244
+ ## API Guidelines
245
+ - RESTful design
246
+ - Version in URL (/api/v1/)
247
+ - JSON responses
248
+ ```
249
+
250
+ ---
251
+
252
+ ## Troubleshooting
253
+
254
+ ### Commands Not Working
255
+
256
+ 1. **Check MCP configuration** in `.vscode/settings.json`:
257
+ ```json
258
+ {
259
+ "mcp": {
260
+ "servers": {
261
+ "spec-kit": {
262
+ "command": "npx",
263
+ "args": ["-y", "smart-spec-kit-mcp"]
264
+ }
265
+ }
266
+ }
267
+ }
268
+ ```
269
+
270
+ 2. **Reload VS Code**: `Ctrl+Shift+P` → "Developer: Reload Window"
271
+
272
+ 3. **Check copilot-instructions.md exists** at `.github/copilot-instructions.md`
273
+
274
+ ### Setup Not Finding Files
275
+
276
+ Run setup with the project path:
277
+ ```bash
278
+ npx smart-spec-kit-mcp setup --project /path/to/project
279
+ ```
280
+
281
+ ### Prompts Not Loading
282
+
283
+ 1. Check files exist in `.spec-kit/prompts/`
284
+ 2. Ensure valid Markdown format
285
+ 3. Run setup again to reinstall:
286
+ ```bash
287
+ npx smart-spec-kit-mcp setup --project . --force
288
+ ```
289
+
290
+ ### Templates Not Applied
291
+
292
+ 1. Check files in `.spec-kit/templates/`
293
+ 2. Verify template name matches reference
294
+
295
+ ---
296
+
297
+ ## Workflow Reference
298
+
299
+ ### feature-standard
300
+
301
+ Standard feature specification workflow.
302
+
303
+ **Steps**:
304
+ 1. Fetch requirements
305
+ 2. Generate specification
306
+ 3. Create plan
307
+ 4. Generate tasks
308
+ 5. Review
309
+
310
+ ### feature-full
311
+
312
+ Complete workflow with governance.
313
+
314
+ **Steps**:
315
+ 1. Fetch requirements
316
+ 2. Generate specification
317
+ 3. Security review
318
+ 4. GDPR compliance check
319
+ 5. Architecture review
320
+ 6. Create plan
321
+ 7. Generate tasks
322
+ 8. Test strategy
323
+ 9. Implementation
324
+ 10. Final review
325
+
326
+ ### bugfix
327
+
328
+ Bug fix workflow.
329
+
330
+ **Steps**:
331
+ 1. Fetch bug report
332
+ 2. Root cause analysis
333
+ 3. Fix plan
334
+ 4. Implementation
335
+ 5. Regression tests
336
+
337
+ ---
338
+
339
+ ## Best Practices
340
+
341
+ ### Writing Good Requirements
342
+
343
+ - Be specific about user needs
344
+ - Include acceptance criteria
345
+ - Define edge cases
346
+ - Reference related features
347
+
348
+ ### Effective Specifications
349
+
350
+ - Start with the "why" (business value)
351
+ - Define clear scope (in/out)
352
+ - Use Given/When/Then for criteria
353
+ - Document assumptions
354
+
355
+ ### Task Breakdown
356
+
357
+ - Atomic tasks (1-4 hours each)
358
+ - Clear acceptance criteria
359
+ - Explicit dependencies
360
+ - Testable outcomes
361
+
362
+ ---
363
+
364
+ ## FAQ
365
+
366
+ **Q: Can I use Spec-Kit without Azure DevOps?**
367
+ A: Yes! Azure DevOps integration is optional. You can provide requirements directly.
368
+
369
+ **Q: How do I add a new agent?**
370
+ A: Agents are defined in the source code. For custom behavior, modify prompts instead.
371
+
372
+ **Q: Can multiple people use Spec-Kit on the same project?**
373
+ A: Yes! All configuration is in the project directory and can be version-controlled.
374
+
375
+ **Q: How do I update Spec-Kit?**
376
+ A: Run `npx smart-spec-kit-mcp@latest setup` to get the latest version.
377
+
378
+ **Q: Can I use my own templates?**
379
+ A: Yes! Add templates to `.spec-kit/templates/` and reference them in workflows.