smart-spec-kit-mcp 2.0.4 → 2.0.6

package/dist/utils/starterKitInstaller.js

@@ -2,13 +2,15 @@
  * Starter Kit Installer
  *
  * Handles the installation of Spec-Kit starter kit into user projects.
- * Copies prompts to .github/prompts/ and templates to .spec-kit/
+ * Copies prompts to .spec-kit/prompts/ and copilot-instructions.md to .github/
  */
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 // Directory constants
-const GITHUB_PROMPTS_DIR = ".github/prompts";
+const GITHUB_DIR = ".github";
+const COPILOT_INSTRUCTIONS = "copilot-instructions.md";
 const SPEC_KIT_DIR = ".spec-kit";
+const PROMPTS_DIR = "prompts";
 const TEMPLATES_DIR = "templates";
 const MEMORY_DIR = "memory";
 const SPECS_DIR = "specs";
@@ -75,19 +77,19 @@ export async function installStarterKit(projectPath, options = {}) {
     };
     const packageRoot = getPackageRoot();
     const starterKitPath = path.join(packageRoot, "starter-kit");
-    // 1. Install prompts to .github/prompts/
+    // 1. Install prompts to .spec-kit/prompts/
     if (!options.skipPrompts) {
         const promptsSrc = path.join(starterKitPath, "prompts");
-        const promptsDest = path.join(projectPath, GITHUB_PROMPTS_DIR);
+        const promptsDest = path.join(projectPath, SPEC_KIT_DIR, PROMPTS_DIR);
         if (await exists(promptsSrc)) {
             const promptsExist = await exists(promptsDest);
             if (promptsExist && !options.force) {
-                result.skipped.push(GITHUB_PROMPTS_DIR);
+                result.skipped.push(`${SPEC_KIT_DIR}/${PROMPTS_DIR}`);
             }
             else {
                 try {
                     await copyDir(promptsSrc, promptsDest);
-                    result.created.push(GITHUB_PROMPTS_DIR);
+                    result.created.push(`${SPEC_KIT_DIR}/${PROMPTS_DIR}`);
                 }
                 catch (error) {
                     result.errors.push(`Failed to copy prompts: ${error}`);
@@ -98,6 +100,26 @@ export async function installStarterKit(projectPath, options = {}) {
         else {
             result.errors.push(`Prompts source not found: ${promptsSrc}`);
         }
+        // Copy copilot-instructions.md to .github/
+        const instructionsSrc = path.join(starterKitPath, COPILOT_INSTRUCTIONS);
+        const instructionsDest = path.join(projectPath, GITHUB_DIR, COPILOT_INSTRUCTIONS);
+        if (await exists(instructionsSrc)) {
+            const instructionsExist = await exists(instructionsDest);
+            if (instructionsExist && !options.force) {
+                result.skipped.push(`${GITHUB_DIR}/${COPILOT_INSTRUCTIONS}`);
+            }
+            else {
+                try {
+                    await fs.mkdir(path.join(projectPath, GITHUB_DIR), { recursive: true });
+                    await fs.copyFile(instructionsSrc, instructionsDest);
+                    result.created.push(`${GITHUB_DIR}/${COPILOT_INSTRUCTIONS}`);
+                }
+                catch (error) {
+                    result.errors.push(`Failed to copy copilot-instructions: ${error}`);
+                    result.success = false;
+                }
+            }
+        }
     }
     // 2. Install templates to .spec-kit/templates/
     if (!options.skipTemplates) {
@@ -214,18 +236,18 @@ export function formatInstallReport(result, projectPath) {
     report += "```\n";
     report += `${path.basename(projectPath)}/\n`;
     report += "├── .github/\n";
-    report += "│   └── prompts/              # Slash commands for Copilot\n";
-    report += "│       ├── speckit.init.md\n";
-    report += "│       ├── speckit.specify.md\n";
-    report += "│       ├── speckit.clarify.md\n";
-    report += "│       ├── speckit.plan.md\n";
-    report += "│       ├── speckit.tasks.md\n";
-    report += "│       └── speckit.implement.md\n";
+    report += "│   └── copilot-instructions.md  # Instructions for Copilot\n";
     report += "├── .spec-kit/\n";
-    report += "│   ├── templates/            # Specification templates\n";
-    report += "│   └── memory/               # Project context\n";
-    report += "│       └── constitution.md   # Project principles\n";
-    report += "└── specs/                    # Generated specifications\n";
+    report += "│   ├── prompts/             # Prompt-as-code files (read by MCP)\n";
+    report += "│   │   ├── specify.md\n";
+    report += "│   │   ├── plan.md\n";
+    report += "│   │   ├── tasks.md\n";
+    report += "│   │   ├── implement.md\n";
+    report += "│   │   └── clarify.md\n";
+    report += "│   ├── templates/           # Specification templates\n";
+    report += "│   └── memory/              # Project context\n";
+    report += "│       └── constitution.md  # Project principles\n";
+    report += "└── specs/                   # Generated specifications\n";
     report += "```\n\n";
     report += "## VS Code Configuration\n\n";
     report += "Add this to your `.vscode/settings.json` to enable MCP tools:\n\n";
@@ -234,20 +256,19 @@ export function formatInstallReport(result, projectPath) {
     report += "\n```\n\n";
     report += "## Next Steps\n\n";
     report += "1. **Edit your constitution**: `.spec-kit/memory/constitution.md`\n";
-    report += "2. **Use slash commands** in Copilot Chat:\n";
-    report += "   - `/speckit.specify` - Create a specification\n";
-    report += "   - `/speckit.plan` - Create implementation plan\n";
-    report += "   - `/speckit.tasks` - Generate task breakdown\n";
-    report += "   - `/speckit.implement` - Start implementation\n\n";
+    report += "2. **Use spec-kit commands** in Copilot Chat:\n";
+    report += "   - `speckit: spec` - Create a specification\n";
+    report += "   - `speckit: plan` - Create implementation plan\n";
+    report += "   - `speckit: tasks` - Generate task breakdown\n";
+    report += "   - `speckit: implement` - Start implementation\n\n";
     report += "## Available Commands\n\n";
     report += "| Command | Description |\n";
     report += "|---------|-------------|\n";
-    report += "| `/speckit.init` | Initialize Spec-Kit in a project |\n";
-    report += "| `/speckit.specify` | Create specification from requirements |\n";
-    report += "| `/speckit.clarify` | Clarify ambiguous requirements |\n";
-    report += "| `/speckit.plan` | Create technical implementation plan |\n";
-    report += "| `/speckit.tasks` | Generate task breakdown |\n";
-    report += "| `/speckit.implement` | Execute implementation tasks |\n";
+    report += "| `speckit: spec` | Create specification from requirements |\n";
+    report += "| `speckit: clarify` | Clarify ambiguous requirements |\n";
+    report += "| `speckit: plan` | Create technical implementation plan |\n";
+    report += "| `speckit: tasks` | Generate task breakdown |\n";
+    report += "| `speckit: implement` | Execute implementation tasks |\n";
     return report;
 }
 /**
@@ -255,7 +276,8 @@ export function formatInstallReport(result, projectPath) {
  */
 export async function isSpecKitInstalled(projectPath) {
     return {
-        hasPrompts: await exists(path.join(projectPath, GITHUB_PROMPTS_DIR)),
+        hasPrompts: await exists(path.join(projectPath, SPEC_KIT_DIR, PROMPTS_DIR)),
+        hasInstructions: await exists(path.join(projectPath, GITHUB_DIR, COPILOT_INSTRUCTIONS)),
         hasTemplates: await exists(path.join(projectPath, SPEC_KIT_DIR, TEMPLATES_DIR)),
         hasMemory: await exists(path.join(projectPath, SPEC_KIT_DIR, MEMORY_DIR)),
         hasSpecs: await exists(path.join(projectPath, SPECS_DIR)),

package/dist/utils/starterKitInstaller.js.map

@@ -1 +1 @@
-{"version":3,"file":"starterKitInstaller.js","sourceRoot":"","sources":["../../src/utils/starterKitInstaller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"starterKitInstaller.js","sourceRoot":"","sources":["../../src/utils/starterKitInstaller.ts"],"names":[],"mappings":"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"}

package/docs/DOCUMENTATION.md

@@ -0,0 +1,423 @@
+# Spec-Kit Documentation
+
+This is the comprehensive documentation for Spec-Kit. Copilot can read this file to answer user questions.
+
+## Overview
+
+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.
+
+## Architecture
+
+### Components
+
+1. **MCP Server** (`smart-spec-kit-mcp`)
+   - Runs as a background process
+   - Exposes tools via Model Context Protocol
+   - Communicates with GitHub Copilot
+
+2. **Copilot Instructions** (`.github/copilot-instructions.md`)
+   - Tells Copilot how to use Spec-Kit tools
+   - Defines command keywords and aliases
+
+3. **Prompts** (`.spec-kit/prompts/`)
+   - Prompt-as-Code files read by MCP tools
+   - Define behavior for each command
+   - Customizable per project
+
+4. **Templates** (`.spec-kit/templates/`)
+   - Document templates for specs, plans, tasks
+   - Markdown format
+
+5. **Constitution** (`.spec-kit/memory/constitution.md`)
+   - Project principles and conventions
+   - Technical stack definition
+   - Development guidelines
+
+6. **Workflows** (`.spec-kit/workflows/`)
+   - YAML-based workflow definitions
+   - Multi-step automated processes
+
+---
+
+## MCP Tools
+
+> **Note**: All parameters are optional. Spec-Kit is designed to be conversational - if you don't provide information upfront, Copilot will ask for it.
+
+### speckit_specify
+
+**Purpose**: Create a functional specification from requirements.
+
+**Triggers**: `speckit: spec`, `speckit: specify`, `créer une spec`
+
+**Parameters** (all optional):
+- `requirements`: What you want to build. Can be:
+  - A feature description: "user authentication with email/password"
+  - A user story: "As a user, I want to..."
+  - An Azure DevOps work item ID: "#12345"
+- `contextId`: ID for the specification filename
+
+**Examples**:
+```
+speckit: spec
+speckit: spec pour un système de notifications push
+speckit: spec user authentication with OAuth
+```
+
+**Behavior**:
+1. Loads prompt from `.spec-kit/prompts/specify.md`
+2. Loads constitution from `.spec-kit/memory/constitution.md`
+3. Loads template from `.spec-kit/templates/functional-spec.md`
+4. If no requirements provided, asks the user
+5. Output saved to `specs/{contextId}-spec.md`
+
+### speckit_plan
+
+**Purpose**: Create an implementation plan from a specification.
+
+**Triggers**: `speckit: plan`, `planifier`, `créer un plan`
+
+**Parameters** (all optional):
+- `specPath`: Path to specification file (auto-detects most recent if not provided)
+
+**Examples**:
+```
+speckit: plan
+speckit: plan pour la spec specs/auth-spec.md
+```
+
+**Behavior**:
+1. Finds the most recent specification in `specs/`
+2. Loads prompt from `.spec-kit/prompts/plan.md`
+3. Returns context for generating the plan
+4. Output saved to `specs/plan.md`
+
+### speckit_tasks
+
+**Purpose**: Generate a task breakdown from a plan.
+
+**Triggers**: `speckit: tasks`, `générer les tâches`, `créer les tâches`
+
+**Parameters** (all optional):
+- `planPath`: Path to plan file (auto-detects most recent if not provided)
+
+**Examples**:
+```
+speckit: tasks
+speckit: générer les tâches
+```
+
+**Behavior**:
+1. Finds the most recent plan in `specs/`
+2. Loads prompt from `.spec-kit/prompts/tasks.md`
+3. Returns context for generating tasks
+4. Output saved to `specs/tasks.md`
+
+### speckit_implement
+
+**Purpose**: Implement tasks one by one.
+
+**Triggers**: `speckit: implement`, `implémenter`, `coder`
+
+**Parameters** (all optional):
+- `taskId`: Specific task ID to implement (picks next pending if not provided)
+
+**Examples**:
+```
+speckit: implement
+speckit: implement task 3
+speckit: implémenter la tâche 5
+```
+
+**Behavior**:
+1. Loads tasks from `specs/tasks.md`
+2. Finds next pending task (or specified task)
+3. Loads prompt from `.spec-kit/prompts/implement.md`
+4. Returns context for implementation
+5. Updates task status after completion
+
+### speckit_clarify
+
+**Purpose**: Clarify ambiguous requirements.
+
+**Triggers**: `speckit: clarify`, `clarifier`, `préciser`
+
+**Parameters** (all optional):
+- `specPath`: Path to specification (auto-detects if not provided)
+- `questions`: Specific questions to clarify
+
+**Examples**:
+```
+speckit: clarify
+speckit: clarifier les critères d'acceptation
+```
+
+**Behavior**:
+1. Finds `[NEEDS CLARIFICATION]` markers
+2. Loads prompt from `.spec-kit/prompts/clarify.md`
+3. Returns targeted questions for stakeholders
+
+### speckit_help
+
+**Purpose**: Provide help and documentation.
+
+**Triggers**: `speckit: help`, `aide sur speckit`
+
+**Parameters** (all optional):
+- `topic`: Specific topic to get help on
+
+**Examples**:
+```
+speckit: help
+speckit: help workflows
+speckit: help comment créer un template ?
+```
+
+**Topics covered**:
+- Commands and usage
+- Customization (prompts, templates, workflows)
+- Troubleshooting
+- Architecture
+
+---
+
+## Customization Guide
+
+### Modifying Prompts
+
+Prompts control how each command behaves. Edit files in `.spec-kit/prompts/`:
+
+```markdown
+# .spec-kit/prompts/specify.md
+
+## My Custom Specification Process
+
+1. First, analyze the business need
+2. Then identify technical constraints
+...
+```
+
+Changes take effect immediately - no restart needed.
+
+### Creating Custom Templates
+
+Templates define document structure. Create/edit in `.spec-kit/templates/`:
+
+```markdown
+# .spec-kit/templates/my-template.md
+
+# {Title}
+
+## Summary
+{summary}
+
+## Requirements
+{requirements}
+
+## Technical Notes
+{notes}
+```
+
+### Creating a New Workflow
+
+Workflows are YAML files defining multi-step processes:
+
+```yaml
+# .spec-kit/workflows/my-workflow.yaml
+
+name: my-workflow
+displayName: "My Custom Workflow"
+description: "Does something specific"
+template: my-template.md
+defaultAgent: SpecAgent
+
+steps:
+  - id: step1
+    name: "First Step"
+    action: call_agent
+    agent: SpecAgent
+    description: "What this step does"
+    inputs:
+      - name: input1
+        description: "Description"
+        required: true
+    
+  - id: step2
+    name: "Second Step"
+    action: call_agent
+    agent: PlanAgent
+    dependsOn: [step1]
+    description: "What this step does"
+```
+
+**Available actions**:
+- `call_agent` - Call an AI agent
+- `fetch_ado` - Fetch Azure DevOps work item
+- `save_artifact` - Save to file
+- `validate` - Validate output
+
+**Available agents**:
+- `SpecAgent` - Writes specifications
+- `PlanAgent` - Creates plans
+- `GovAgent` - Validates governance
+- `TestAgent` - Creates test strategies
+
+### Editing the Constitution
+
+The constitution defines project principles. Edit `.spec-kit/memory/constitution.md`:
+
+```markdown
+# Project Constitution
+
+## Technical Stack
+- Language: TypeScript
+- Framework: React + Node.js
+- Database: PostgreSQL
+- Testing: Jest + Playwright
+
+## Development Principles
+1. Clean Architecture - separate concerns
+2. Test-Driven Development
+3. Code review required for all changes
+4. Documentation as code
+
+## Naming Conventions
+- Files: kebab-case
+- Components: PascalCase
+- Functions: camelCase
+
+## API Guidelines
+- RESTful design
+- Version in URL (/api/v1/)
+- JSON responses
+```
+
+---
+
+## Troubleshooting
+
+### Commands Not Working
+
+1. **Check MCP configuration** in `.vscode/settings.json`:
+```json
+{
+  "mcp": {
+    "servers": {
+      "spec-kit": {
+        "command": "npx",
+        "args": ["-y", "smart-spec-kit-mcp"]
+      }
+    }
+  }
+}
+```
+
+2. **Reload VS Code**: `Ctrl+Shift+P` → "Developer: Reload Window"
+
+3. **Check copilot-instructions.md exists** at `.github/copilot-instructions.md`
+
+### Setup Not Finding Files
+
+Run setup with the project path:
+```bash
+npx smart-spec-kit-mcp setup --project /path/to/project
+```
+
+### Prompts Not Loading
+
+1. Check files exist in `.spec-kit/prompts/`
+2. Ensure valid Markdown format
+3. Run setup again to reinstall:
+```bash
+npx smart-spec-kit-mcp setup --project . --force
+```
+
+### Templates Not Applied
+
+1. Check files in `.spec-kit/templates/`
+2. Verify template name matches reference
+
+---
+
+## Workflow Reference
+
+### feature-standard
+
+Standard feature specification workflow.
+
+**Steps**:
+1. Fetch requirements
+2. Generate specification
+3. Create plan
+4. Generate tasks
+5. Review
+
+### feature-full
+
+Complete workflow with governance.
+
+**Steps**:
+1. Fetch requirements
+2. Generate specification
+3. Security review
+4. GDPR compliance check
+5. Architecture review
+6. Create plan
+7. Generate tasks
+8. Test strategy
+9. Implementation
+10. Final review
+
+### bugfix
+
+Bug fix workflow.
+
+**Steps**:
+1. Fetch bug report
+2. Root cause analysis
+3. Fix plan
+4. Implementation
+5. Regression tests
+
+---
+
+## Best Practices
+
+### Writing Good Requirements
+
+- Be specific about user needs
+- Include acceptance criteria
+- Define edge cases
+- Reference related features
+
+### Effective Specifications
+
+- Start with the "why" (business value)
+- Define clear scope (in/out)
+- Use Given/When/Then for criteria
+- Document assumptions
+
+### Task Breakdown
+
+- Atomic tasks (1-4 hours each)
+- Clear acceptance criteria
+- Explicit dependencies
+- Testable outcomes
+
+---
+
+## FAQ
+
+**Q: Can I use Spec-Kit without Azure DevOps?**
+A: Yes! Azure DevOps integration is optional. You can provide requirements directly.
+
+**Q: How do I add a new agent?**
+A: Agents are defined in the source code. For custom behavior, modify prompts instead.
+
+**Q: Can multiple people use Spec-Kit on the same project?**
+A: Yes! All configuration is in the project directory and can be version-controlled.
+
+**Q: How do I update Spec-Kit?**
+A: Run `npx smart-spec-kit-mcp@latest setup` to get the latest version.
+
+**Q: Can I use my own templates?**
+A: Yes! Add templates to `.spec-kit/templates/` and reference them in workflows.