smart-spec-kit-mcp 2.0.1 → 2.0.2

package/dist/utils/starterKitInstaller.js

@@ -0,0 +1,264 @@
+/**
+ * Starter Kit Installer
+ *
+ * Handles the installation of Spec-Kit starter kit into user projects.
+ * Copies prompts to .github/prompts/ and templates to .spec-kit/
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+// Directory constants
+const GITHUB_PROMPTS_DIR = ".github/prompts";
+const SPEC_KIT_DIR = ".spec-kit";
+const TEMPLATES_DIR = "templates";
+const MEMORY_DIR = "memory";
+const SPECS_DIR = "specs";
+/**
+ * Get the package root directory (where the npm package is installed)
+ */
+function getPackageRoot() {
+    const currentDir = path.dirname(new URL(import.meta.url).pathname);
+    // Handle Windows paths (remove leading slash if present)
+    const normalizedDir = currentDir.replace(/^\/([A-Za-z]:)/, "$1");
+    // Go up from dist/utils/ or src/utils/ to package root
+    return path.resolve(normalizedDir, "..", "..");
+}
+/**
+ * Check if a file or directory exists
+ */
+async function exists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Copy a directory recursively
+ */
+async function copyDir(src, dest) {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDir(srcPath, destPath);
+        }
+        else {
+            await fs.copyFile(srcPath, destPath);
+        }
+    }
+}
+/**
+ * Copy a file if the source exists
+ */
+async function copyFileIfExists(src, dest) {
+    if (await exists(src)) {
+        await fs.mkdir(path.dirname(dest), { recursive: true });
+        await fs.copyFile(src, dest);
+        return true;
+    }
+    return false;
+}
+/**
+ * Install the Spec-Kit starter kit into a project
+ */
+export async function installStarterKit(projectPath, options = {}) {
+    const result = {
+        success: true,
+        created: [],
+        skipped: [],
+        errors: [],
+        vsCodeConfig: "",
+    };
+    const packageRoot = getPackageRoot();
+    const starterKitPath = path.join(packageRoot, "starter-kit");
+    // 1. Install prompts to .github/prompts/
+    if (!options.skipPrompts) {
+        const promptsSrc = path.join(starterKitPath, "prompts");
+        const promptsDest = path.join(projectPath, GITHUB_PROMPTS_DIR);
+        if (await exists(promptsSrc)) {
+            const promptsExist = await exists(promptsDest);
+            if (promptsExist && !options.force) {
+                result.skipped.push(GITHUB_PROMPTS_DIR);
+            }
+            else {
+                try {
+                    await copyDir(promptsSrc, promptsDest);
+                    result.created.push(GITHUB_PROMPTS_DIR);
+                }
+                catch (error) {
+                    result.errors.push(`Failed to copy prompts: ${error}`);
+                    result.success = false;
+                }
+            }
+        }
+        else {
+            result.errors.push(`Prompts source not found: ${promptsSrc}`);
+        }
+    }
+    // 2. Install templates to .spec-kit/templates/
+    if (!options.skipTemplates) {
+        const templatesSrc = path.join(starterKitPath, "templates");
+        const templatesDest = path.join(projectPath, SPEC_KIT_DIR, TEMPLATES_DIR);
+        if (await exists(templatesSrc)) {
+            const templatesExist = await exists(templatesDest);
+            if (templatesExist && !options.force) {
+                result.skipped.push(`${SPEC_KIT_DIR}/${TEMPLATES_DIR}`);
+            }
+            else {
+                try {
+                    await copyDir(templatesSrc, templatesDest);
+                    result.created.push(`${SPEC_KIT_DIR}/${TEMPLATES_DIR}`);
+                }
+                catch (error) {
+                    result.errors.push(`Failed to copy templates: ${error}`);
+                    result.success = false;
+                }
+            }
+        }
+        else {
+            result.errors.push(`Templates source not found: ${templatesSrc}`);
+        }
+    }
+    // 3. Install memory/constitution.md to .spec-kit/memory/
+    if (!options.skipMemory) {
+        const memorySrc = path.join(starterKitPath, "memory");
+        const memoryDest = path.join(projectPath, SPEC_KIT_DIR, MEMORY_DIR);
+        if (await exists(memorySrc)) {
+            const memoryExists = await exists(memoryDest);
+            if (memoryExists && !options.force) {
+                result.skipped.push(`${SPEC_KIT_DIR}/${MEMORY_DIR}`);
+            }
+            else {
+                try {
+                    await copyDir(memorySrc, memoryDest);
+                    result.created.push(`${SPEC_KIT_DIR}/${MEMORY_DIR}`);
+                }
+                catch (error) {
+                    result.errors.push(`Failed to copy memory: ${error}`);
+                    result.success = false;
+                }
+            }
+        }
+    }
+    // 4. Create specs/ directory
+    const specsDir = path.join(projectPath, SPECS_DIR);
+    if (!(await exists(specsDir))) {
+        try {
+            await fs.mkdir(specsDir, { recursive: true });
+            // Create a .gitkeep file to preserve the directory
+            await fs.writeFile(path.join(specsDir, ".gitkeep"), "");
+            result.created.push(SPECS_DIR);
+        }
+        catch (error) {
+            result.errors.push(`Failed to create specs directory: ${error}`);
+        }
+    }
+    // 5. Generate VS Code MCP configuration
+    if (!options.skipVsCode) {
+        result.vsCodeConfig = generateVsCodeConfig();
+    }
+    return result;
+}
+/**
+ * Generate VS Code MCP configuration for settings.json
+ */
+export function generateVsCodeConfig() {
+    return JSON.stringify({
+        "mcp": {
+            "servers": {
+                "spec-kit": {
+                    "command": "npx",
+                    "args": ["-y", "spec-kit-mcp"]
+                }
+            }
+        }
+    }, null, 2);
+}
+/**
+ * Generate human-readable installation report
+ */
+export function formatInstallReport(result, projectPath) {
+    let report = "";
+    if (result.success) {
+        report += "# ✅ Spec-Kit Starter Kit Installed!\n\n";
+    }
+    else {
+        report += "# ⚠️ Spec-Kit Installation Completed with Errors\n\n";
+    }
+    if (result.created.length > 0) {
+        report += "## Created\n\n";
+        for (const item of result.created) {
+            report += `- 📁 \`${item}\`\n`;
+        }
+        report += "\n";
+    }
+    if (result.skipped.length > 0) {
+        report += "## Skipped (already exist, use --force to overwrite)\n\n";
+        for (const item of result.skipped) {
+            report += `- ⏭️ \`${item}\`\n`;
+        }
+        report += "\n";
+    }
+    if (result.errors.length > 0) {
+        report += "## Errors\n\n";
+        for (const error of result.errors) {
+            report += `- ❌ ${error}\n`;
+        }
+        report += "\n";
+    }
+    report += "## Project Structure\n\n";
+    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 += "├── .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 += "```\n\n";
+    report += "## VS Code Configuration\n\n";
+    report += "Add this to your `.vscode/settings.json` to enable MCP tools:\n\n";
+    report += "```json\n";
+    report += result.vsCodeConfig;
+    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 += "## 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";
+    return report;
+}
+/**
+ * Check if a project already has Spec-Kit installed
+ */
+export async function isSpecKitInstalled(projectPath) {
+    return {
+        hasPrompts: await exists(path.join(projectPath, GITHUB_PROMPTS_DIR)),
+        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)),
+    };
+}
+//# sourceMappingURL=starterKitInstaller.js.map

package/dist/utils/starterKitInstaller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starterKitInstaller.js","sourceRoot":"","sources":["../../src/utils/starterKitInstaller.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,sBAAsB;AACtB,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAC7C,MAAM,YAAY,GAAG,WAAW,CAAC;AACjC,MAAM,aAAa,GAAG,WAAW,CAAC;AAClC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAC5B,MAAM,SAAS,GAAG,OAAO,CAAC;AAE1B;;GAEG;AACH,SAAS,cAAc;IACrB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnE,yDAAyD;IACzD,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IACjE,uDAAuD;IACvD,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,MAAM,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,IAAY;IAC9C,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,IAAY;IACvD,IAAI,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAaD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB,EACnB,UAMI,EAAE;IAEN,MAAM,MAAM,GAAkB;QAC5B,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,EAAE;QACV,YAAY,EAAE,EAAE;KACjB,CAAC;IAEF,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAE7D,yCAAyC;IACzC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QACxD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;QAE/D,IAAI,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YAE/C,IAAI,YAAY,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;oBACvC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;gBAC1C,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;oBACvD,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAC5D,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;QAE1E,IAAI,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/B,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAEnD,IAAI,cAAc,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACrC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,IAAI,aAAa,EAAE,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;oBAC3C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,IAAI,aAAa,EAAE,CAAC,CAAC;gBAC1D,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAC;oBACzD,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;QAEpE,IAAI,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YAE9C,IAAI,YAAY,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,IAAI,UAAU,EAAE,CAAC,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;oBACrC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,IAAI,UAAU,EAAE,CAAC,CAAC;gBACvD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;oBACtD,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACnD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,mDAAmD;YACnD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;YACxD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,CAAC,YAAY,GAAG,oBAAoB,EAAE,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,KAAK,EAAE;YACL,SAAS,EAAE;gBACT,UAAU,EAAE;oBACV,SAAS,EAAE,KAAK;oBAChB,MAAM,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC;iBAC/B;aACF;SACF;KACF,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAqB,EAAE,WAAmB;IAC5E,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,yCAAyC,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,sDAAsD,CAAC;IACnE,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,gBAAgB,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,IAAI,UAAU,IAAI,MAAM,CAAC;QACjC,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,0DAA0D,CAAC;QACrE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,IAAI,UAAU,IAAI,MAAM,CAAC;QACjC,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,eAAe,CAAC;QAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,IAAI,OAAO,KAAK,IAAI,CAAC;QAC7B,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;IACjB,CAAC;IAED,MAAM,IAAI,0BAA0B,CAAC;IACrC,MAAM,IAAI,OAAO,CAAC;IAClB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC;IAC7C,MAAM,IAAI,gBAAgB,CAAC;IAC3B,MAAM,IAAI,8DAA8D,CAAC;IACzE,MAAM,IAAI,+BAA+B,CAAC;IAC1C,MAAM,IAAI,kCAAkC,CAAC;IAC7C,MAAM,IAAI,kCAAkC,CAAC;IAC7C,MAAM,IAAI,+BAA+B,CAAC;IAC1C,MAAM,IAAI,gCAAgC,CAAC;IAC3C,MAAM,IAAI,oCAAoC,CAAC;IAC/C,MAAM,IAAI,kBAAkB,CAAC;IAC7B,MAAM,IAAI,2DAA2D,CAAC;IACtE,MAAM,IAAI,mDAAmD,CAAC;IAC9D,MAAM,IAAI,sDAAsD,CAAC;IACjE,MAAM,IAAI,4DAA4D,CAAC;IACvE,MAAM,IAAI,SAAS,CAAC;IAEpB,MAAM,IAAI,8BAA8B,CAAC;IACzC,MAAM,IAAI,mEAAmE,CAAC;IAC9E,MAAM,IAAI,WAAW,CAAC;IACtB,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC;IAC9B,MAAM,IAAI,WAAW,CAAC;IAEtB,MAAM,IAAI,mBAAmB,CAAC;IAC9B,MAAM,IAAI,qEAAqE,CAAC;IAChF,MAAM,IAAI,8CAA8C,CAAC;IACzD,MAAM,IAAI,oDAAoD,CAAC;IAC/D,MAAM,IAAI,qDAAqD,CAAC;IAChE,MAAM,IAAI,mDAAmD,CAAC;IAC9D,MAAM,IAAI,sDAAsD,CAAC;IAEjE,MAAM,IAAI,2BAA2B,CAAC;IACtC,MAAM,IAAI,6BAA6B,CAAC;IACxC,MAAM,IAAI,6BAA6B,CAAC;IACxC,MAAM,IAAI,0DAA0D,CAAC;IACrE,MAAM,IAAI,mEAAmE,CAAC;IAC9E,MAAM,IAAI,2DAA2D,CAAC;IACtE,MAAM,IAAI,8DAA8D,CAAC;IACzE,MAAM,IAAI,kDAAkD,CAAC;IAC7D,MAAM,IAAI,2DAA2D,CAAC;IAEtE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAM1D,OAAO;QACL,UAAU,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;QACpE,YAAY,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;QAC/E,SAAS,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;QACzE,QAAQ,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smart-spec-kit-mcp",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "AI-driven specification platform using MCP (Model Context Protocol) for VS Code & GitHub Copilot",
   "main": "dist/index.js",
   "type": "module",
@@ -12,7 +12,7 @@
     "dist",
     "workflows",
     "templates",
-    ".github/copilot/prompts",
+    "starter-kit",
     "README.md"
   ],
   "publishConfig": {

package/starter-kit/memory/constitution.md

@@ -0,0 +1,122 @@
+# Project Constitution
+
+> This document defines the core principles and guidelines that govern all development on this project.
+
+## Project Information
+
+- **Project Name**: [TO FILL: Your project name]
+- **Ratification Date**: [TO FILL: YYYY-MM-DD]
+- **Last Amended**: [TO FILL: YYYY-MM-DD]
+- **Version**: 1.0.0
+
+---
+
+## Core Principles
+
+### Principle 1: [TO FILL: Principle Name]
+
+[TO FILL: Description of this principle and what it means for the project]
+
+**Rationale**: [TO FILL: Why this principle matters and what problems it solves]
+
+**Examples**:
+- [TO FILL: Concrete example of applying this principle]
+
+---
+
+### Principle 2: Code Quality
+
+All code must be readable, maintainable, and follow established coding standards.
+
+**Rationale**: Consistent, high-quality code reduces bugs, speeds up onboarding, and makes the codebase easier to maintain over time.
+
+**Guidelines**:
+- Code must pass linting without warnings
+- All public functions must have documentation
+- Complex logic must include explanatory comments
+- Code review required for all changes
+
+---
+
+### Principle 3: Test Coverage
+
+All features must have appropriate test coverage before being considered complete.
+
+**Rationale**: Tests provide confidence that code works as intended and prevents regressions during future changes.
+
+**Guidelines**:
+- Unit tests for business logic (minimum 80% coverage)
+- Integration tests for API endpoints
+- E2E tests for critical user flows
+
+---
+
+### Principle 4: Documentation First
+
+Features must be specified before implementation begins.
+
+**Rationale**: Clear specifications reduce misunderstandings, prevent rework, and create a shared understanding among all stakeholders.
+
+**Guidelines**:
+- Use `/speckit.specify` before starting any new feature
+- Keep specifications updated as requirements evolve
+- Link implementation PRs to their specifications
+
+---
+
+### Principle 5: Security by Design
+
+Security considerations must be part of every feature from the start.
+
+**Rationale**: Retrofitting security is expensive and error-prone. Building it in from the start is more effective.
+
+**Guidelines**:
+- Validate all user inputs
+- Use parameterized queries for database access
+- Follow principle of least privilege
+- Document security considerations in specifications
+
+---
+
+## Tech Stack Guidelines
+
+### Preferred Technologies
+| Category | Technology | Notes |
+|----------|------------|-------|
+| Language | [TO FILL] | |
+| Framework | [TO FILL] | |
+| Database | [TO FILL] | |
+| Testing | [TO FILL] | |
+
+### Code Style
+- [TO FILL: Link to style guide or describe key conventions]
+
+### Dependencies
+- Prefer well-maintained, widely-used packages
+- Document the reason for adding new dependencies
+- Keep dependencies updated regularly
+
+---
+
+## Governance
+
+### Amendment Process
+1. Propose changes via pull request to this document
+2. Changes require approval from [TO FILL: who approves]
+3. Version number updated according to semantic versioning:
+   - **MAJOR**: Principle removed or fundamentally changed
+   - **MINOR**: New principle or section added
+   - **PATCH**: Clarifications and wording improvements
+
+### Enforcement
+- Code reviews should verify adherence to these principles
+- Automated checks where possible (linting, test coverage)
+- Regular retrospectives to assess principle effectiveness
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.0 | [TO FILL] | Initial constitution |

package/starter-kit/prompts/speckit.clarify.md

@@ -0,0 +1,129 @@
+---
+description: Identify underspecified areas in the specification and ask targeted clarification questions. Run before /speckit.plan.
+---
+
+# /speckit.clarify - Clarify Requirements
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Outline
+
+You are clarifying underspecified areas in the specification. Follow this workflow:
+
+### 1. Load Specification
+
+Find and read the specification file:
+- Check `specs/` directory for recent spec files
+- If user provides a spec path, use that
+- If no spec found, inform user to run `/speckit.specify` first
+
+### 2. Analyze for Gaps
+
+Review the specification for:
+
+**Critical Gaps** (must clarify):
+- Ambiguous scope boundaries
+- Undefined user roles/permissions
+- Missing error handling behavior
+- Unclear data validation rules
+- Security requirements not addressed
+
+**Important Gaps** (should clarify):
+- Performance expectations
+- Edge cases not covered
+- Integration details
+- UI/UX specifics
+
+**Minor Gaps** (nice to clarify):
+- Naming conventions
+- Logging requirements
+- Documentation needs
+
+### 3. Generate Questions
+
+Create a maximum of 5 highly targeted questions:
+
+For each question:
+1. **Question**: Clear, specific question
+2. **Context**: Why this matters for implementation
+3. **Options**: Provide 2-3 reasonable options with recommendations
+4. **Default**: Suggest a default if no answer provided
+
+**Question Format**:
+```
+### Question {N}: {Topic}
+
+{Question text}
+
+**Why it matters**: {Impact on implementation}
+
+**Options**:
+| Option | Description |
+|--------|-------------|
+| A (Recommended) | {Description} |
+| B | {Description} |
+| C | {Description} |
+
+You can reply with the option letter, "recommended", or provide your own answer.
+```
+
+### 4. Interactive Clarification
+
+Present questions one at a time:
+1. Ask the question with options
+2. Wait for user response
+3. Record the answer
+4. Update the specification with the clarification
+
+For each answer:
+- If user says "yes", "recommended", or "A" → use the recommended option
+- If user provides a different answer → validate it fits the context
+- If user says "skip" → note as "Deferred" and continue
+
+### 5. Update Specification
+
+Add a **Clarifications** section to the specification:
+
+```markdown
+## Clarifications
+
+| # | Topic | Question | Answer | Date |
+|---|-------|----------|--------|------|
+| 1 | {Topic} | {Question summary} | {Answer} | {Date} |
+```
+
+Also update relevant sections with the clarified information.
+
+### 6. Report Completion
+
+Output:
+- Number of clarifications made
+- Summary of decisions
+- Any deferred items
+- Next step: `/speckit.plan` to create implementation plan
+
+## Question Generation Rules
+
+**DO ask about**:
+- Scope boundaries (what's explicitly in/out)
+- User roles and their permissions
+- Error states and recovery
+- Data retention and privacy
+- Performance requirements
+
+**DON'T ask about**:
+- Implementation details (that's for /speckit.plan)
+- Obvious defaults (pagination, sorting, etc.)
+- Tech stack choices (user provides in /speckit.plan)
+
+## Handoffs
+
+After completing clarifications:
+- **Create plan**: `/speckit.plan` - Now ready to plan implementation
+- **Re-specify**: `/speckit.specify` - If major changes needed

package/starter-kit/prompts/speckit.implement.md

@@ -0,0 +1,122 @@
+---
+description: Execute the implementation tasks from tasks.md. Implements the feature according to the plan.
+---
+
+# /speckit.implement - Execute Implementation
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Outline
+
+You are implementing the feature according to the task list. Follow this workflow:
+
+### 1. Validate Prerequisites
+
+Check that all required files exist:
+- `specs/{feature}/spec.md` - Specification
+- `specs/{feature}/plan.md` - Implementation plan
+- `specs/{feature}/tasks.md` - Task breakdown
+
+If any are missing, inform user which `/speckit.*` command to run.
+
+### 2. Load Implementation Context
+
+Read all design documents:
+- **tasks.md**: Complete task list with execution order
+- **plan.md**: Tech stack, architecture, file structure
+- **data-model.md**: Entity definitions (if exists)
+- **contracts/**: API specifications (if exists)
+- **research.md**: Technical decisions (if exists)
+
+### 3. Verify Project Setup
+
+Check or create essential project files:
+
+**Based on tech stack, verify:**
+- Package management files (`package.json`, `requirements.txt`, `*.csproj`)
+- Ignore files (`.gitignore`, `.dockerignore` if Docker used)
+- Linting/formatting config (`.eslintrc`, `prettier.config.js`, etc.)
+- TypeScript config if applicable
+
+**Create if missing** - only ask user if multiple valid options exist.
+
+### 4. Execute Tasks
+
+Process tasks from `tasks.md` in order:
+
+1. **Read the task** - Understand what needs to be done
+2. **Check dependencies** - Verify prerequisite tasks are complete
+3. **Implement** - Write the code following the plan
+4. **Mark complete** - Check off the task in tasks.md
+
+For each task:
+```
+📋 Task T{number}: {description}
+📁 File: {file_path}
+⏳ Status: In Progress...
+```
+
+### 5. Implementation Guidelines
+
+**Code Quality**:
+- Follow the code style specified in plan.md or project conventions
+- Include appropriate comments and documentation
+- Write tests if specified in the tasks
+- Handle errors appropriately
+
+**Progress Tracking**:
+- Update task checkboxes as you complete them
+- Note any blockers or issues encountered
+- Suggest adjustments if tasks need modification
+
+**Checkpoint Validation**:
+- At each phase checkpoint, run the specified validation
+- Report results before proceeding to next phase
+
+### 6. Handle Blockers
+
+If a task cannot be completed:
+1. Document the blocker in the task
+2. Check if it's a dependency issue
+3. Ask user for clarification if needed
+4. Skip and continue with non-blocked tasks
+
+### 7. Report Progress
+
+After each phase or upon request, report:
+- Tasks completed
+- Tasks remaining
+- Any blockers encountered
+- Code quality notes
+- Next steps
+
+## Execution Mode Options
+
+User can specify in `$ARGUMENTS`:
+
+- **Full implementation**: Complete all tasks
+- **Phase only**: `--phase 3` - Complete only specified phase
+- **Single task**: `--task T015` - Complete only specified task
+- **Dry run**: `--dry-run` - Show what would be done without making changes
+
+## Quality Checks
+
+Before marking implementation complete:
+- [ ] All tasks in tasks.md are checked off
+- [ ] Code compiles/runs without errors
+- [ ] Tests pass (if applicable)
+- [ ] No TODO comments left unaddressed
+- [ ] Documentation is updated
+
+## Handoffs
+
+After completing implementation:
+- **Test the feature** - Run tests and verify functionality
+- **Create PR** - Prepare pull request with summary
+- **Update spec** - Mark specification as implemented