smart-spec-kit-mcp 2.2.5 → 2.2.7

package/README.md

@@ -76,47 +76,67 @@ Puis rechargez VS Code: `Ctrl+Shift+P` → "Developer: Reload Window"
 
 ## 📁 Structure du Projet
 
-Après installation, votre projet contient:
+### Structure interne du package Spec-Kit
 
 ```text
-votre-projet/
-├── .github/
-│   ├── prompts/                  # Slash commands pour Copilot
-│   │   ├── speckit.specify.prompt.md
-│   │   ├── speckit.plan.prompt.md
-│   │   ├── speckit.tasks.prompt.md
-│   │   ├── speckit.implement.prompt.md
-│   │   ├── speckit.clarify.prompt.md
-│   │   ├── speckit.validate.prompt.md
-│   │   ├── speckit.memory.prompt.md
-│   │   └── speckit.help.prompt.md
-│   └── copilot-instructions.md   # Guide Copilot sur l'utilisation de Spec-Kit
-├── .spec-kit/
-│   ├── prompts/                  # Prompts (lus par les outils MCP)
+smart-spec-kit-mcp/
+├── starter-kit/                  # Source unique de la configuration
+│   ├── prompts/                  # Prompts MCP (specify, plan, implement, etc.)
 │   │   ├── specify.md
 │   │   ├── plan.md
 │   │   ├── tasks.md
 │   │   ├── implement.md
 │   │   ├── clarify.md
-│   │   └── validate.md
+│   │   ├── validate.md
+│   │   └── memory.md
 │   ├── templates/                # Templates de documents
 │   │   ├── functional-spec.md
+│   │   ├── bugfix-report.md
 │   │   ├── plan-template.md
 │   │   └── tasks-template.md
+│   ├── workflows/                # Workflows YAML prédéfinis
+│   │   ├── feature-quick.yaml    # 3-step (spécification rapide)
+│   │   ├── feature-standard.yaml # 4-step (complet)
+│   │   ├── feature-full.yaml     # 5-step (détaillé)
+│   │   ├── bugfix-quick.yaml     # 2-step (bugfix rapide)
+│   │   └── bugfix.yaml
+│   ├── agents/                   # Agents IA customisables
+│   │   ├── SpecAgent.md          # Rédacteur de spécifications
+│   │   ├── PlanAgent.md          # Planificateur technique
+│   │   ├── GovAgent.md           # Validateur gouvernance
+│   │   ├── TestAgent.md          # Stratège de tests
+│   │   └── _CustomAgent.template.md  # Template pour créer vos agents
 │   ├── rules/                    # Règles de validation
-│   │   ├── security-rules.md     # Règles de sécurité
-│   │   └── rgpd-rules.md         # Conformité RGPD
+│   │   ├── security-rules.md     # Règles OWASP
+│   │   └── rgpd-rules.md         # Conformité GDPR
 │   ├── memory/                   # Contexte projet
 │   │   └── constitution.md       # Principes du projet
-│   └── workflows/                # Workflows automatisés
-│       ├── feature-quick.yaml    # Quick wins (léger)
-│       ├── feature-standard.yaml
-│       ├── feature-full.yaml
-│       └── bugfix.yaml
+│   ├── github-prompts/           # Slash commands pour Copilot
+│   │   └── speckit.*.prompt.md
+│   └── copilot-instructions.md   # Guide Copilot
+```
+
+### Structure après installation dans votre projet
+
+```text
+votre-projet/
+├── .github/
+│   └── copilot-instructions.md   # Copié lors du setup
+├── .spec-kit/                    # Configuration locale (personnalisations)
+│   ├── prompts/                  # Override les prompts par défaut
+│   ├── templates/                # Override les templates par défaut
+│   ├── workflows/                # Vos workflows personnalisés
+│   ├── agents/                   # Vos agents personnalisés ← NOUVEAU
+│   ├── rules/                    # Vos règles de validation
+│   └── memory/
+│       └── constitution.md       # Principes de votre projet
 └── specs/                        # Spécifications générées
     └── validations/              # Rapports de validation
 ```
 
+**Note**: Les workflows, templates et agents par défaut viennent de `starter-kit/` du package. 
+Vous pouvez personnaliser en créant des fichiers dans `.spec-kit/`.
+
 ---
 
 ## 🎮 Commandes Disponibles
@@ -180,6 +200,7 @@ Vous pouvez aussi utiliser ces phrases dans Copilot Chat:
 ```
 
 Ou avec la commande par mots-clés:
+
 ```text
 speckit: spec pour un système de notifications push
 ```
@@ -249,6 +270,71 @@ steps:
     description: "Génère le plan"
 ```
 
+#### À propos des "Agents"
+
+⚠️ **Important** : Les agents Spec-Kit (SpecAgent, PlanAgent, GovAgent, TestAgent) **ne sont PAS** des agents GitHub Copilot.
+
+Ce sont des **system prompts prédéfinis** qui guident le comportement de Copilot :
+
+| Agent | Rôle | Fichier |
+|-------|------|---------|
+| **SpecAgent** | Rédacteur de spécifications | `SpecAgent.md` |
+| **PlanAgent** | Planificateur technique | `PlanAgent.md` |
+| **GovAgent** | Validateur de gouvernance | `GovAgent.md` |
+| **TestAgent** | Stratège de tests | `TestAgent.md` |
+
+Quand vous mettez `agent: SpecAgent` dans une étape, Spec-Kit envoie le system prompt de SpecAgent à Copilot.
+
+#### Créer un Agent Personnalisé
+
+Les agents sont maintenant **entièrement customisables** depuis `.spec-kit/agents/` :
+
+```markdown
+# .spec-kit/agents/SecurityAgent.md
+
+---
+name: SecurityAgent
+displayName: "Security Review Agent"
+description: "Expert en sécurité applicative"
+capabilities:
+  - Identifier les vulnérabilités
+  - Recommander les bonnes pratiques
+---
+
+## System Prompt
+
+Tu es SecurityAgent, un expert en sécurité applicative...
+```
+
+Puis utilisez dans vos workflows :
+
+```yaml
+steps:
+  - id: security-review
+    agent: SecurityAgent  # Votre agent custom !
+    action: call_agent
+```
+
+Pour plus de détails : [Understanding Spec-Kit Agents](docs/DOCUMENTATION.md#understanding-spec-kit-agents)
+
+#### Validation du Schéma de Workflow
+
+Chaque workflow YAML est validé automatiquement contre un schéma Zod. Les champs obligatoires sont :
+- `name` - Identifiant unique
+- `displayName` - Nom visible
+- `description` - Description
+- `template` - Fichier template
+- `steps` - Au moins une étape
+
+Erreur si validation échoue :
+```
+Error: Invalid workflow "mon-workflow":
+  - steps.0.action: Invalid enum value
+  - name: Required
+```
+
+Pour plus de détails sur le schéma, voir [Workflow Validation Schema](docs/DOCUMENTATION.md#workflow-validation-schema).
+
 ---
 
 ## ❓ Obtenir de l'Aide
@@ -283,9 +369,12 @@ Pour récupérer automatiquement les work items:
       },
       "azure-devops": {
         "command": "npx",
-        "args": ["-y", "@anthropic-ai/azure-devops-mcp"],
+        "args": [
+        "-y",
+        "@azure-devops/mcp",
+        "your-org",
+      ],
         "env": {
-          "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-org",
           "AZURE_DEVOPS_PAT": "your-token"
         }
       }
@@ -326,7 +415,7 @@ Pour une documentation détaillée sur tous les outils et fonctionnalités:
 - **[docs/DOCUMENTATION.md](docs/DOCUMENTATION.md)** - Documentation complète des outils MCP et workflows
 - **[docs/PACKAGING.md](docs/PACKAGING.md)** - Guide de packaging et distribution
 - **[PROJECT_CONTEXT.md](PROJECT_CONTEXT.md)** - Contexte du projet Spec-Kit
-- **[TASK_QUEUE.md](TASK_QUEUE.md)** - Tâches en cours et prévues
+- **[TODO.md](TODO.md)** - Tâches en cours et prévues
 - **[TROUBLESHOOTING.md](TROUBLESHOOTING.md)** - Guide de dépannage complet
 
 ---

package/dist/tools/agentTools.d.ts

@@ -1,7 +1,8 @@
 /**
  * Agent Tools
  *
- * MCP tools for interacting with agent system prompts
+ * MCP tools for interacting with agent system prompts.
+ * Supports both built-in agents and custom agents from .spec-kit/agents/
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 /**

package/dist/tools/agentTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentTools.d.ts","sourceRoot":"","sources":["../../src/tools/agentTools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgI1D"}
+{"version":3,"file":"agentTools.d.ts","sourceRoot":"","sources":["../../src/tools/agentTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+H1D"}

package/dist/tools/agentTools.js

@@ -1,26 +1,25 @@
 /**
  * Agent Tools
  *
- * MCP tools for interacting with agent system prompts
+ * MCP tools for interacting with agent system prompts.
+ * Supports both built-in agents and custom agents from .spec-kit/agents/
  */
 import { z } from "zod";
-import { AgentRegistry, getAgent, listAgents } from "../prompts/agents.js";
+import { loadAgent, listAgentsDetailed } from "../utils/agentLoader.js";
 /**
  * Register agent-related tools on the MCP server
  */
 export function registerAgentTools(server) {
-    // Tool: list_agents - List all available agents
-    server.tool("list_agents", "List all available AI agents and their capabilities. Use this to understand which agent to use for a specific task.", {}, async () => {
-        const agents = listAgents();
-        const formatted = agents.map((agent) => {
-            const full = AgentRegistry[agent.name];
-            return {
-                name: agent.name,
-                displayName: agent.displayName,
-                description: agent.description,
-                capabilities: full.capabilities,
-            };
-        });
+    // Tool: list_agents - List all available agents (built-in + custom)
+    server.tool("list_agents", "List all available AI agents and their capabilities. Includes both built-in agents and custom agents from .spec-kit/agents/.", {}, async () => {
+        const agents = await listAgentsDetailed();
+        const formatted = agents.map((agent) => ({
+            name: agent.name,
+            displayName: agent.displayName,
+            description: agent.description,
+            capabilities: agent.capabilities,
+            source: agent.source, // "local" or "builtin"
+        }));
         return {
             content: [{
                     type: "text",
@@ -29,12 +28,12 @@ export function registerAgentTools(server) {
         };
     });
     // Tool: get_agent_prompt - Get system prompt for an agent
-    server.tool("get_agent_prompt", "Retrieve the full system prompt for a specific agent. Use this to understand how an agent behaves and its guidelines.", {
-        agent_name: z.enum(["SpecAgent", "PlanAgent", "GovAgent", "TestAgent"])
-            .describe("Name of the agent to get prompt for"),
+    server.tool("get_agent_prompt", "Retrieve the full system prompt for a specific agent. Supports built-in agents and custom agents from .spec-kit/agents/.", {
+        agent_name: z.string()
+            .describe("Name of the agent to get prompt for (e.g., SpecAgent, PlanAgent, or a custom agent name)"),
     }, async ({ agent_name }) => {
         try {
-            const agent = getAgent(agent_name);
+            const agent = await loadAgent(agent_name);
             const response = `# Agent: ${agent.displayName}
 
 ## Description
@@ -66,16 +65,16 @@ ${agent.systemPrompt}
         }
     });
     // Tool: invoke_agent - Get agent context for a specific task
-    server.tool("invoke_agent", "Prepare an agent context for a specific task. Returns the agent's system prompt combined with task instructions.", {
-        agent_name: z.enum(["SpecAgent", "PlanAgent", "GovAgent", "TestAgent"])
-            .describe("Name of the agent to invoke"),
+    server.tool("invoke_agent", "Prepare an agent context for a specific task. Returns the agent's system prompt combined with task instructions. Supports custom agents.", {
+        agent_name: z.string()
+            .describe("Name of the agent to invoke (e.g., SpecAgent, PlanAgent, or a custom agent name)"),
         task_description: z.string()
             .describe("Description of the task for the agent to perform"),
         context: z.string().optional()
             .describe("Additional context or data for the agent (e.g., work item details)"),
     }, async ({ agent_name, task_description, context }) => {
         try {
-            const agent = getAgent(agent_name);
+            const agent = await loadAgent(agent_name);
             const response = `# 🤖 ${agent.displayName} Activated
 
 ## System Context

package/dist/tools/agentTools.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentTools.js","sourceRoot":"","sources":["../../src/tools/agentTools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agentTools.js","sourceRoot":"","sources":["../../src/tools/agentTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAA0B,MAAM,yBAAyB,CAAC;AAEhG;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAElD,oEAAoE;IACpE,MAAM,CAAC,IAAI,CACT,aAAa,EACb,8HAA8H,EAC9H,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,kBAAkB,EAAE,CAAC;QAE1C,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,uBAAuB;SAC9C,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrD,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,0DAA0D;IAC1D,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,0HAA0H,EAC1H;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;aACnB,QAAQ,CAAC,0FAA0F,CAAC;KACxG,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,UAA+B,CAAC,CAAC;YAE/D,MAAM,QAAQ,GAAG,YAAY,KAAK,CAAC,WAAW;;;EAGpD,KAAK,CAAC,WAAW;;;EAGjB,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;EAIlD,KAAK,CAAC,YAAY;;CAEnB,CAAC;YAEM,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,QAAQ;qBACf,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC3E,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,6DAA6D;IAC7D,MAAM,CAAC,IAAI,CACT,cAAc,EACd,0IAA0I,EAC1I;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;aACnB,QAAQ,CAAC,kFAAkF,CAAC;QAC/F,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;aACzB,QAAQ,CAAC,kDAAkD,CAAC;QAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC3B,QAAQ,CAAC,oEAAoE,CAAC;KAClF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,EAAE;QAClD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,UAA+B,CAAC,CAAC;YAE/D,MAAM,QAAQ,GAAG,QAAQ,KAAK,CAAC,WAAW;;;EAGhD,KAAK,CAAC,YAAY;;;;;;YAMR,gBAAgB;;EAE1B,OAAO,CAAC,CAAC,CAAC,0BAA0B,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE;;;;6BAI9B,KAAK,CAAC,WAAW;;;EAG5C,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;CAGnD,CAAC;YAEM,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,QAAQ;qBACf,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC3E,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/utils/agentLoader.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Agent Loader
+ *
+ * Loads agent definitions with local override support.
+ *
+ * Resolution order:
+ * 1. Local project: .spec-kit/agents/
+ * 2. Package defaults: Built-in agents (src/prompts/agents.ts)
+ *
+ * This allows any project to customize agents or create new ones.
+ */
+import { type AgentDefinition, type AgentType } from "../prompts/agents.js";
+/**
+ * Extended agent type that includes custom agents
+ */
+export type ExtendedAgentType = AgentType | string;
+/**
+ * Load a single agent by name
+ *
+ * Resolution order:
+ * 1. Local override: .spec-kit/agents/{name}.md
+ * 2. Built-in agent from AgentRegistry
+ */
+export declare function loadAgent(name: ExtendedAgentType): Promise<AgentDefinition>;
+/**
+ * Get the system prompt for an agent
+ */
+export declare function getAgentPrompt(name: ExtendedAgentType): Promise<string>;
+/**
+ * List all available agents (local + built-in)
+ * Local agents override built-in agents with the same name
+ */
+export declare function listAllAgents(): Promise<Array<{
+    name: string;
+    displayName: string;
+    description: string;
+    source: "local" | "builtin";
+}>>;
+/**
+ * List agents with full details (including capabilities)
+ */
+export declare function listAgentsDetailed(): Promise<Array<{
+    name: string;
+    displayName: string;
+    description: string;
+    capabilities: string[];
+    source: "local" | "builtin";
+}>>;
+/**
+ * Check if an agent exists (local or built-in)
+ */
+export declare function agentExists(name: string): Promise<boolean>;
+//# sourceMappingURL=agentLoader.d.ts.map

package/dist/utils/agentLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentLoader.d.ts","sourceRoot":"","sources":["../../src/utils/agentLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAiB,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAM3F;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,MAAM,CAAC;AA4GnD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwBjF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAG7E;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B,CAAC,CAAC,CA0CF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,KAAK,CAAC;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B,CAAC,CAAC,CA6CF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAShE"}

package/dist/utils/agentLoader.js

@@ -0,0 +1,225 @@
+/**
+ * Agent Loader
+ *
+ * Loads agent definitions with local override support.
+ *
+ * Resolution order:
+ * 1. Local project: .spec-kit/agents/
+ * 2. Package defaults: Built-in agents (src/prompts/agents.ts)
+ *
+ * This allows any project to customize agents or create new ones.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import yaml from "js-yaml";
+import { AgentRegistry } from "../prompts/agents.js";
+// Directory name for local agents
+const AGENTS_DIR = "agents";
+const LOCAL_CONFIG_DIR = ".spec-kit";
+/**
+ * Get the current working directory (user's project)
+ */
+function getProjectRoot() {
+    return process.cwd();
+}
+/**
+ * Check if a file exists
+ */
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Parse a Markdown agent file with YAML frontmatter
+ *
+ * Expected format:
+ * ```
+ * ---
+ * name: MyAgent
+ * displayName: "My Custom Agent"
+ * description: "What this agent does"
+ * capabilities:
+ *   - Capability 1
+ *   - Capability 2
+ * ---
+ *
+ * ## System Prompt
+ *
+ * Your system prompt content here...
+ * ```
+ */
+async function parseAgentFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        // Extract frontmatter (between --- markers)
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+        if (!frontmatterMatch) {
+            console.warn(`Agent file ${filePath} has no valid frontmatter`);
+            return null;
+        }
+        const frontmatterRaw = frontmatterMatch[1] ?? "";
+        const systemPrompt = frontmatterMatch[2]?.trim() || "";
+        // Parse YAML frontmatter
+        const frontmatter = yaml.load(frontmatterRaw);
+        if (!frontmatter.name || !frontmatter.displayName || !frontmatter.description) {
+            console.warn(`Agent file ${filePath} missing required fields (name, displayName, description)`);
+            return null;
+        }
+        return {
+            name: frontmatter.name,
+            displayName: frontmatter.displayName,
+            description: frontmatter.description,
+            capabilities: frontmatter.capabilities || [],
+            systemPrompt: systemPrompt,
+        };
+    }
+    catch (error) {
+        console.warn(`Failed to parse agent file ${filePath}:`, error);
+        return null;
+    }
+}
+/**
+ * Get the local agents directory path
+ */
+function getLocalAgentsDir() {
+    return path.join(getProjectRoot(), LOCAL_CONFIG_DIR, AGENTS_DIR);
+}
+/**
+ * List all local agent files
+ */
+async function listLocalAgentFiles() {
+    const agentsDir = getLocalAgentsDir();
+    try {
+        const files = await fs.readdir(agentsDir);
+        return files.filter(f => f.endsWith(".md"));
+    }
+    catch {
+        // Directory doesn't exist
+        return [];
+    }
+}
+/**
+ * Load a single agent by name
+ *
+ * Resolution order:
+ * 1. Local override: .spec-kit/agents/{name}.md
+ * 2. Built-in agent from AgentRegistry
+ */
+export async function loadAgent(name) {
+    // 1. Try local override first
+    const localPath = path.join(getLocalAgentsDir(), `${name}.md`);
+    if (await fileExists(localPath)) {
+        const localAgent = await parseAgentFile(localPath);
+        if (localAgent) {
+            return localAgent;
+        }
+    }
+    // 2. Fall back to built-in agent
+    const builtinAgent = AgentRegistry[name];
+    if (builtinAgent) {
+        return builtinAgent;
+    }
+    // 3. Agent not found
+    const available = await listAllAgents();
+    throw new Error(`Agent "${name}" not found.\n` +
+        `Available agents: ${available.map(a => a.name).join(", ") || "none"}\n\n` +
+        `Tip: Create custom agents in .spec-kit/agents/${name}.md`);
+}
+/**
+ * Get the system prompt for an agent
+ */
+export async function getAgentPrompt(name) {
+    const agent = await loadAgent(name);
+    return agent.systemPrompt;
+}
+/**
+ * List all available agents (local + built-in)
+ * Local agents override built-in agents with the same name
+ */
+export async function listAllAgents() {
+    const results = [];
+    const seen = new Set();
+    // 1. Load local agents first (they take priority)
+    const localFiles = await listLocalAgentFiles();
+    for (const file of localFiles) {
+        const filePath = path.join(getLocalAgentsDir(), file);
+        const agent = await parseAgentFile(filePath);
+        if (agent && !seen.has(agent.name)) {
+            seen.add(agent.name);
+            results.push({
+                name: agent.name,
+                displayName: agent.displayName,
+                description: agent.description,
+                source: "local",
+            });
+        }
+    }
+    // 2. Add built-in agents (if not overridden)
+    for (const [name, agent] of Object.entries(AgentRegistry)) {
+        if (!seen.has(name)) {
+            seen.add(name);
+            results.push({
+                name: agent.name,
+                displayName: agent.displayName,
+                description: agent.description,
+                source: "builtin",
+            });
+        }
+    }
+    return results;
+}
+/**
+ * List agents with full details (including capabilities)
+ */
+export async function listAgentsDetailed() {
+    const results = [];
+    const seen = new Set();
+    // 1. Load local agents first
+    const localFiles = await listLocalAgentFiles();
+    for (const file of localFiles) {
+        const filePath = path.join(getLocalAgentsDir(), file);
+        const agent = await parseAgentFile(filePath);
+        if (agent && !seen.has(agent.name)) {
+            seen.add(agent.name);
+            results.push({
+                name: agent.name,
+                displayName: agent.displayName,
+                description: agent.description,
+                capabilities: agent.capabilities,
+                source: "local",
+            });
+        }
+    }
+    // 2. Add built-in agents
+    for (const [name, agent] of Object.entries(AgentRegistry)) {
+        if (!seen.has(name)) {
+            seen.add(name);
+            results.push({
+                name: agent.name,
+                displayName: agent.displayName,
+                description: agent.description,
+                capabilities: agent.capabilities,
+                source: "builtin",
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Check if an agent exists (local or built-in)
+ */
+export async function agentExists(name) {
+    // Check local
+    const localPath = path.join(getLocalAgentsDir(), `${name}.md`);
+    if (await fileExists(localPath)) {
+        return true;
+    }
+    // Check built-in
+    return name in AgentRegistry;
+}
+//# sourceMappingURL=agentLoader.js.map

package/dist/utils/agentLoader.js.map

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

package/dist/utils/starterKitInstaller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"starterKitInstaller.d.ts","sourceRoot":"","sources":["../../src/utils/starterKitInstaller.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB,GACL,OAAO,CAAC,aAAa,CAAC,CA8KxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAqGtF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACrE,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC,CASD"}
+{"version":3,"file":"starterKitInstaller.d.ts","sourceRoot":"","sources":["../../src/utils/starterKitInstaller.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB,GACL,OAAO,CAAC,aAAa,CAAC,CAkMxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA2GtF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACrE,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC,CASD"}

package/dist/utils/starterKitInstaller.js

@@ -15,6 +15,7 @@ const PROMPTS_DIR = "prompts";
 const TEMPLATES_DIR = "templates";
 const MEMORY_DIR = "memory";
 const RULES_DIR = "rules";
+const AGENTS_DIR = "agents";
 const SPECS_DIR = "specs";
 /**
  * Get the package root directory (where the npm package is installed)
@@ -206,7 +207,26 @@ export async function installStarterKit(projectPath, options = {}) {
             }
         }
     }
-    // 5. Create specs/ directory
+    // 5. Install agents to .spec-kit/agents/
+    const agentsSrc = path.join(starterKitPath, "agents");
+    const agentsDest = path.join(projectPath, SPEC_KIT_DIR, AGENTS_DIR);
+    if (await exists(agentsSrc)) {
+        const agentsExist = await exists(agentsDest);
+        if (agentsExist && !options.force) {
+            result.skipped.push(`${SPEC_KIT_DIR}/${AGENTS_DIR}`);
+        }
+        else {
+            try {
+                await copyDir(agentsSrc, agentsDest);
+                result.created.push(`${SPEC_KIT_DIR}/${AGENTS_DIR}`);
+            }
+            catch (error) {
+                result.errors.push(`Failed to copy agents: ${error}`);
+                result.success = false;
+            }
+        }
+    }
+    // 6. Create specs/ directory
     const specsDir = path.join(projectPath, SPECS_DIR);
     if (!(await exists(specsDir))) {
         try {
@@ -310,6 +330,12 @@ export function formatInstallReport(result, projectPath) {
     report += "│   ├── rules/               # Validation rules (security, RGPD)\n";
     report += "│   │   ├── security-rules.md\n";
     report += "│   │   └── rgpd-rules.md\n";
+    report += "│   ├── agents/              # Customizable AI agents\n";
+    report += "│   │   ├── SpecAgent.md\n";
+    report += "│   │   ├── PlanAgent.md\n";
+    report += "│   │   ├── GovAgent.md\n";
+    report += "│   │   ├── TestAgent.md\n";
+    report += "│   │   └── _CustomAgent.template.md\n";
     report += "│   └── memory/              # Project context\n";
     report += "│       └── constitution.md  # Project principles\n";
     report += "├── specs/                   # Generated specifications\n";