smart-spec-kit-mcp 2.4.6 → 2.4.8

package/README.md

@@ -29,15 +29,46 @@ Plateforme d'orchestration automatisée pour le **développement piloté par les
 - **🤖 Commandes Naturelles**: Utilisez `speckit: spec`, `speckit: plan`, etc. directement dans Copilot Chat
 - **📝 Prompts Versionnés**: Prompts personnalisables et versionnables dans `.spec-kit/prompts/`
 - **🔄 Workflows YAML**: Processus personnalisables étape par étape
-- **📋 Templates**: Spécifications fonctionnelles, plans d'implémentation, rapports de bugs
-- **🛡️ Gouvernance Intégrée**: Constitution projet, principes de développement
-- **� Checklists de Qualité**: "Unit tests for English" pour valider vos requirements
+- **📋 Templates Complets**: Specs, plans, data-model, API contracts (OpenAPI), quickstart, research
+- **🛡️ Gouvernance Intégrée**: Constitution projet, Phase -1 Gates, principes de développement
+- **✅ Checklists de Qualité**: "Unit tests for English" pour valider vos requirements
 - **🔍 Analyse de Traçabilité**: Vérification de cohérence entre specs, plans et tâches
-- **�🔗 Azure DevOps**: Intégration native via MCP
+- **🔗 Azure DevOps**: Intégration native via MCP
 - **❓ Aide Contextuelle**: Demandez de l'aide sur Spec-Kit directement dans Copilot
 
 ---
 
+## 🏆 Pourquoi Smart Spec-Kit vs GitHub Spec-Kit ?
+
+| Aspect | GitHub Spec-Kit | **Smart Spec-Kit** |
+|--------|-----------------|--------------------|
+| **Installation** | Copier manuellement les fichiers | `npx smart-spec-kit-mcp setup` ✨ |
+| **Distribution** | Dossier à cloner | Package npm installable |
+| **Mise à jour** | Copier à nouveau | `npx smart-spec-kit-mcp@latest setup` |
+| **Personnalisation** | Éditer les fichiers sources | Override dans `.spec-kit/` (non-destructif) |
+| **Workflows** | Manuel (copier les commandes) | **Automatisé** avec YAML + approval gates |
+| **Agents** | Prompts fixes | **Agents personnalisables** (`.spec-kit/agents/`) |
+| **Validation** | Manuelle | **Automatique** (sécurité, RGPD, schéma) |
+| **Phase -1 Gates** | Dans les templates | **Intégré dans le workflow** |
+| **Supporting Docs** | Templates séparés | **Génération automatique** (data-model, contracts, quickstart) |
+| **Mémoire Projet** | Non inclus | **Auto-enrichissement** des décisions/learnings |
+| **Multi-langue** | Anglais | **Français + Anglais** |
+| **MCP Server** | ❌ Non | ✅ **Oui** - communication native avec Copilot |
+
+### 🎯 Smart Spec-Kit = GitHub Spec-Kit + Automatisation + MCP
+
+Smart Spec-Kit implémente **100% de la méthodologie GitHub Spec-Kit** (spec-driven.md) avec :
+
+1. **📦 Distribution packagée** - Un seul `npx` pour tout installer
+2. **🔄 Workflows automatisés** - Enchaînement des étapes sans intervention
+3. **📝 Documents de support auto-générés** - `data-model.md`, `contracts/`, `quickstart.md`
+4. **🚦 Phase -1 Gates intégrées** - Validation architecturale avant implémentation
+5. **🧠 Mémoire projet** - Enrichissement automatique des décisions et conventions
+6. **🔌 Serveur MCP natif** - Communication directe avec GitHub Copilot
+7. **🎨 Personnalisation non-destructive** - Vos overrides dans `.spec-kit/` survivent aux mises à jour
+
+---
+
 ## ⚡ Installation Rapide
 
 ### Option 1: Installation Automatique (Recommandé)
@@ -95,11 +126,17 @@ smart-spec-kit-mcp/
 │   │   ├── analyze.md            # Analyse de traçabilité
 │   │   └── checklist.md          # Checklist de qualité des requirements
 │   ├── templates/                # Templates de documents
-│   │   ├── functional-spec.md
+│   │   ├── functional-spec.md    # Spécification fonctionnelle
+│   │   ├── plan-template.md      # Plan avec Phase -1 Gates
+│   │   ├── tasks-template.md     # Liste de tâches
+│   │   ├── data-model.md         # 🆕 Entités et relations
+│   │   ├── quickstart.md         # 🆕 Scénarios de validation
+│   │   ├── research.md           # 🆕 Recherche technique
+│   │   ├── checklist-template.md
 │   │   ├── bugfix-report.md
-│   │   ├── plan-template.md
-│   │   ├── tasks-template.md
-│   │   └── checklist-template.md # Template de checklist de qualité
+│   │   └── contracts/            # 🆕 Contrats API
+│   │       ├── api-template.yaml # OpenAPI 3.0
+│   │       └── events-template.md # WebSocket/SSE
 │   ├── workflows/                # Workflows YAML prédéfinis
 │   │   ├── feature-quick.yaml    # 2-step (spécification rapide)
 │   │   ├── feature-standard.yaml # 5-step (spec → plan → tasks → analyze → implement)
@@ -131,12 +168,23 @@ votre-projet/
 ├── .spec-kit/                    # Configuration locale (personnalisations)
 │   ├── prompts/                  # Override les prompts par défaut
 │   ├── templates/                # Override les templates par défaut
+│   │   └── contracts/            # 🆕 Contrats API personnalisés
 │   ├── workflows/                # Vos workflows personnalisés
-│   ├── agents/                   # Vos agents personnalisés ← NOUVEAU
+│   ├── agents/                   # Vos agents personnalisés
 │   ├── rules/                    # Vos règles de validation
 │   └── memory/
 │       └── constitution.md       # Principes de votre projet
 └── specs/                        # Spécifications générées
+    ├── [feature-name]/           # 🆕 Dossier par feature
+    │   ├── spec.md               # Spécification fonctionnelle
+    │   ├── plan.md               # Plan d'implémentation
+    │   ├── data-model.md         # 🆕 Entités et relations
+    │   ├── quickstart.md         # 🆕 Scénarios validation
+    │   ├── tasks.md              # Liste des tâches
+    │   ├── research.md           # 🆕 Recherche technique (optionnel)
+    │   └── contracts/            # 🆕 Contrats API
+    │       ├── api.yaml          # OpenAPI 3.0
+    │       └── events.md         # Événements temps réel (optionnel)
     └── validations/              # Rapports de validation
 ```
 

package/dist/schemas/workflowSchema.d.ts

@@ -16,9 +16,11 @@ export declare const WorkflowStepSchema: z.ZodObject<{
         review: "review";
         create_file: "create_file";
         call_agent: "call_agent";
+        call_tool: "call_tool";
     }>;
     description: z.ZodString;
     agent: z.ZodOptional<z.ZodString>;
+    tool: z.ZodOptional<z.ZodString>;
     inputs: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
@@ -63,9 +65,11 @@ export declare const WorkflowSchema: z.ZodObject<{
             review: "review";
             create_file: "create_file";
             call_agent: "call_agent";
+            call_tool: "call_tool";
         }>;
         description: z.ZodString;
         agent: z.ZodOptional<z.ZodString>;
+        tool: z.ZodOptional<z.ZodString>;
         inputs: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;

package/dist/schemas/workflowSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflowSchema.d.ts","sourceRoot":"","sources":["../../src/schemas/workflowSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;iBAmB7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQzB,CAAC;AAGH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"workflowSchema.d.ts","sourceRoot":"","sources":["../../src/schemas/workflowSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;iBAoB7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQzB,CAAC;AAGH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/schemas/workflowSchema.js

@@ -32,10 +32,11 @@ const FlexibleInputsSchema = z.union([
 export const WorkflowStepSchema = z.object({
     id: z.string().describe("Unique identifier for the step"),
     name: z.string().describe("Human-readable step name"),
-    action: z.enum(["fetch_ado", "generate_content", "review", "create_file", "call_agent"])
+    action: z.enum(["fetch_ado", "generate_content", "review", "create_file", "call_agent", "call_tool"])
         .describe("The type of action to perform"),
     description: z.string().describe("Detailed description of what this step does"),
     agent: z.string().optional().describe("Agent to use for this step (e.g., SpecAgent, PlanAgent)"),
+    tool: z.string().optional().describe("MCP tool to call when action is 'call_tool'"),
     inputs: FlexibleInputsSchema.describe("Input parameters for the step"),
     outputs: z.array(z.string()).optional().describe("Expected outputs from this step"),
     next: z.string().optional().describe("Next step ID (if not sequential)"),

package/dist/schemas/workflowSchema.js.map

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

package/dist/utils/workflowLoader.d.ts

@@ -48,11 +48,12 @@ export declare function loadWorkflowWithTemplate(workflowName: string): Promise<
 export declare function getWorkflowStep(workflow: Workflow, stepId: string): {
     id: string;
     name: string;
-    action: "fetch_ado" | "generate_content" | "review" | "create_file" | "call_agent";
+    action: "fetch_ado" | "generate_content" | "review" | "create_file" | "call_agent" | "call_tool";
     description: string;
     requiresApproval: boolean;
     useSubagent: boolean;
     agent?: string | undefined;
+    tool?: string | undefined;
     inputs?: Record<string, string | string[]> | {
         name: string;
         description?: string | undefined;
@@ -68,11 +69,12 @@ export declare function getWorkflowStep(workflow: Workflow, stepId: string): {
 export declare function getFirstStep(workflow: Workflow): {
     id: string;
     name: string;
-    action: "fetch_ado" | "generate_content" | "review" | "create_file" | "call_agent";
+    action: "fetch_ado" | "generate_content" | "review" | "create_file" | "call_agent" | "call_tool";
     description: string;
     requiresApproval: boolean;
     useSubagent: boolean;
     agent?: string | undefined;
+    tool?: string | undefined;
     inputs?: Record<string, string | string[]> | {
         name: string;
         description?: string | undefined;
@@ -88,11 +90,12 @@ export declare function getFirstStep(workflow: Workflow): {
 export declare function getNextStep(workflow: Workflow, currentStepId: string): {
     id: string;
     name: string;
-    action: "fetch_ado" | "generate_content" | "review" | "create_file" | "call_agent";
+    action: "fetch_ado" | "generate_content" | "review" | "create_file" | "call_agent" | "call_tool";
     description: string;
     requiresApproval: boolean;
     useSubagent: boolean;
     agent?: string | undefined;
+    tool?: string | undefined;
     inputs?: Record<string, string | string[]> | {
         name: string;
         description?: string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"workflowLoader.d.ts","sourceRoot":"","sources":["../../src/utils/workflowLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAG7E,YAAY,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAmH7D;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CACpD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAC9D,CAEA;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8B1E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAKnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;cAEjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ;;;;;;;;;;;;;;;;cAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM;;;;;;;;;;;;;;;;qBAepE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAiErD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC3D,CASA"}
+{"version":3,"file":"workflowLoader.d.ts","sourceRoot":"","sources":["../../src/utils/workflowLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAG7E,YAAY,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAmH7D;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CACpD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAC9D,CAEA;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8B1E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAKnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;cAEjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ;;;;;;;;;;;;;;;;;cAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM;;;;;;;;;;;;;;;;;qBAepE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAiErD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC3D,CASA"}

package/docs/DOCUMENTATION.md

@@ -30,8 +30,17 @@ Spec-Kit is an MCP (Model Context Protocol) server that provides **customizable
    - Versioned and maintainable in your project
 
 5. **Templates** (`.spec-kit/templates/`)
-   - Document templates for specs, plans, tasks
-   - Markdown format
+   - Document templates for specs, plans, tasks, and supporting documents
+   - Markdown and YAML formats
+   - **Available templates**:
+     - `functional-spec.md` - Feature specification
+     - `plan-template.md` - Implementation plan with Phase -1 Gates
+     - `tasks-template.md` - Task breakdown
+     - `data-model.md` - Entity definitions, relations, validation
+     - `quickstart.md` - Manual validation scenarios
+     - `research.md` - Technical research and comparisons
+     - `contracts/api-template.yaml` - OpenAPI 3.0 specification
+     - `contracts/events-template.md` - WebSocket/SSE event contracts
 
 6. **Constitution** (`.spec-kit/memory/constitution.md`)
    - Project principles and conventions
@@ -121,7 +130,7 @@ speckit: spec user authentication with OAuth
 
 ### speckit_plan
 
-**Purpose**: Create an implementation plan from a specification.
+**Purpose**: Create a complete implementation plan with supporting documents from a specification.
 
 **Slash Command**: `/speckit.plan`
 
@@ -142,12 +151,40 @@ speckit: plan pour la spec specs/auth-spec.md
 
 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`
+3. **Validates Phase -1 Gates** (mandatory before planning):
+   - Simplicity Gate (Article VII): ≤3 projects, no future-proofing
+   - Anti-Abstraction Gate (Article VIII): Use framework directly
+   - Integration-First Gate (Article IX): Contracts before code
+   - Test-First Gate (Article III): Tests derived from spec
+4. Generates the main plan (`plan.md`)
+5. **Generates supporting documents**:
+   - `data-model.md` - Entity definitions, relations, validation rules
+   - `contracts/api.yaml` - OpenAPI 3.0 specification
+   - `contracts/events.md` - Real-time events (if applicable)
+   - `quickstart.md` - Manual validation scenarios
+   - `research.md` - Technical research (optional)
+
+**Output Structure**:
+
+```
+specs/[branch-name]/
+├── spec.md           # Already exists
+├── plan.md           # Main implementation plan
+├── data-model.md     # Entity definitions
+├── quickstart.md     # Validation scenarios
+├── research.md       # Technical research (optional)
+└── contracts/
+    ├── api.yaml      # OpenAPI 3.0
+    └── events.md     # Real-time events (optional)
+```
+
+**Phase -1 Gates**:
+
+These gates enforce architectural discipline from the Constitution. All gates must pass before proceeding to implementation. Document justified exceptions in the Complexity Tracking section of the plan.
 
 ### speckit_tasks
 
-**Purpose**: Generate a task breakdown from a plan.
+**Purpose**: Generate a dependency-ordered task breakdown from plan and supporting documents.
 
 **Slash Command**: `/speckit.tasks`
 
@@ -164,12 +201,36 @@ speckit: tasks
 speckit: générer les tâches
 ```
 
+**Input Sources**:
+
+| Document | Required | What to Extract |
+|----------|----------|------------------|
+| `plan.md` | ✅ Yes | Phases, architecture, decisions |
+| `data-model.md` | ✅ Yes | Entity CRUD tasks, migrations |
+| `contracts/api.yaml` | ✅ Yes | Endpoint implementation tasks |
+| `contracts/events.md` | If exists | Event handler tasks |
+| `quickstart.md` | ✅ Yes | Validation test tasks |
+| `research.md` | If exists | Setup/integration tasks |
+
+**Task Format**:
+
+```
+- [ ] T### [P] [US#] Description with file path
+```
+
+Where:
+- `T###` = Task number (T001, T002...)
+- `[P]` = Parallel marker (if task can run in parallel)
+- `[US#]` = User Story reference from spec
+
 **Behavior**:
 
-1. Finds the most recent plan in `specs/`
+1. Finds the most recent plan and supporting docs in `specs/`
 2. Loads prompt from `.spec-kit/prompts/tasks.md`
-3. Returns context for generating tasks
-4. Output saved to `specs/tasks.md`
+3. Derives tasks from all input sources
+4. Organizes by phase (Setup → Data Layer → API → Events → Testing → Polish)
+5. Identifies parallel groups and dependencies
+6. Output saved to `specs/tasks.md`
 
 ### speckit_implement
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smart-spec-kit-mcp",
-  "version": "2.4.6",
+  "version": "2.4.8",
   "description": "AI-driven specification platform using MCP (Model Context Protocol) for VS Code & GitHub Copilot",
   "main": "dist/index.js",
   "type": "module",

package/starter-kit/agents/PlanAgent.md

@@ -1,13 +1,15 @@
 ---
 name: PlanAgent
 displayName: "Planning Agent"
-description: "Expert in technical planning and task decomposition"
+description: "Expert in technical planning, data modeling, API design, and task decomposition"
 capabilities:
-  - Break down features into technical tasks
+  - Validate Phase -1 Gates (Simplicity, Anti-Abstraction, Integration-First, Test-First)
+  - Create data models with entities, relations, and validation rules
+  - Design API contracts (OpenAPI 3.0) and event contracts
+  - Generate quickstart validation scenarios from user stories
+  - Break down features into technical tasks with dependencies
   - Estimate effort and complexity
-  - Identify dependencies between tasks
-  - Suggest implementation approaches
-  - Create sprint-ready work items
+  - Identify critical path and parallel work opportunities
 ---
 
 ## System Prompt
@@ -16,36 +18,76 @@ You are PlanAgent, an expert technical architect specialized in implementation p
 
 ### Your Role
 
-You transform specifications and requirements into actionable, well-structured implementation plans with clear tasks, dependencies, and estimates.
+You transform specifications into comprehensive implementation plans including:
+1. **Main Plan** (`plan.md`) - Architecture, phases, decisions
+2. **Data Model** (`data-model.md`) - Entities, relations, validation
+3. **API Contracts** (`contracts/api.yaml`) - OpenAPI 3.0 specification
+4. **Event Contracts** (`contracts/events.md`) - Real-time events (if applicable)
+5. **Quickstart** (`quickstart.md`) - Manual validation scenarios
+6. **Research** (`research.md`) - Technical comparisons (optional)
+7. **Tasks** (`tasks.md`) - Actionable task breakdown
+
+### Phase -1 Gates (MANDATORY)
+
+Before creating any plan, validate:
+
+**Simplicity Gate (Article VII)**:
+- Using ≤3 projects for initial implementation?
+- No future-proofing or speculative features?
+
+**Anti-Abstraction Gate (Article VIII)**:
+- Using framework features directly?
+- Single model representation per entity?
+
+**Integration-First Gate (Article IX)**:
+- Contracts defined before implementation?
+- Using real dependencies (not mocks)?
+
+**Test-First Gate (Article III)**:
+- Tests derived from spec?
+- Quickstart scenarios ready?
 
 ### Core Principles
 
-1. **Actionable Tasks**: Each task should be completable by a single developer in 1-3 days.
-2. **Clear Dependencies**: Explicitly identify what must be done before each task.
-3. **Risk-Aware**: Highlight technical risks and suggest mitigation strategies.
-4. **Pragmatic**: Balance ideal solutions with practical constraints (time, resources, tech debt).
+1. **Contracts First**: Define data-model and API contracts BEFORE implementation plan.
+2. **Actionable Tasks**: Each task should be completable by a single developer in 1-3 days.
+3. **Clear Dependencies**: Explicitly identify what must be done before each task.
+4. **Risk-Aware**: Highlight technical risks and suggest mitigation strategies.
+5. **Pragmatic**: Balance ideal solutions with practical constraints.
+
+### Document Generation Order
 
-### Task Decomposition Guidelines
+1. Validate Phase -1 Gates
+2. Generate `data-model.md` (entities from spec)
+3. Generate `contracts/api.yaml` (endpoints from entities)
+4. Generate `contracts/events.md` (if real-time features)
+5. Generate `quickstart.md` (scenarios from user stories)
+6. Generate `plan.md` (architecture, phases)
+7. Generate `research.md` (only if tech decisions needed)
 
-- Start with the end-to-end happy path
-- Add error handling and edge cases as separate tasks
-- Include tasks for testing, documentation, and deployment
-- Consider database migrations, API changes, and breaking changes
-- Account for code review and QA time
+### Task Format
 
-### Estimation Approach
+Use this EXACT format:
+```
+- [ ] T### [P] [US#] Description with file path
+```
 
-- Use relative sizing (S/M/L/XL) or story points
-- Factor in unknowns and learning curves
-- Include buffer for integration and testing
-- Be explicit about assumptions affecting estimates
+Where:
+- `T###` = Task number
+- `[P]` = Parallel marker (if can run in parallel)
+- `[US#]` = User Story reference
 
-### Output Format
+### Output Structure
 
-For each task, provide:
-- Clear title (verb + object)
-- Description with acceptance criteria
-- Size/effort estimate
-- Dependencies (task IDs)
-- Technical notes and implementation hints
-- Risk flags if applicable
+```
+specs/[branch-name]/
+├── spec.md           # Already exists
+├── plan.md           # Main implementation plan
+├── data-model.md     # Entity definitions
+├── quickstart.md     # Validation scenarios
+├── tasks.md          # Task breakdown
+├── research.md       # Technical research (optional)
+└── contracts/
+    ├── api.yaml      # OpenAPI 3.0
+    └── events.md     # Real-time events (optional)
+```

package/starter-kit/copilot-instructions.md

@@ -95,7 +95,13 @@ speckit_constitution → speckit_specify → speckit_plan → speckit_tasks →
 ├── templates/         # Document templates
 │   ├── functional-spec.md
 │   ├── plan-template.md
-│   └── tasks-template.md
+│   ├── tasks-template.md
+│   ├── data-model.md          # NEW: Entity definitions
+│   ├── quickstart.md          # NEW: Validation scenarios
+│   ├── research.md            # NEW: Technical research
+│   └── contracts/             # NEW: API contracts
+│       ├── api-template.yaml  # OpenAPI 3.0
+│       └── events-template.md # WebSocket/SSE events
 ├── rules/             # Validation rules
 │   ├── security-rules.md
 │   └── rgpd-rules.md
@@ -105,9 +111,32 @@ speckit_constitution → speckit_specify → speckit_plan → speckit_tasks →
     └── feature-quick.yaml  # Quick wins (lightweight)
 
 specs/                 # Generated specifications (output)
+├── [branch-name]/     # Feature folder (e.g., 003-chat-system)
+│   ├── spec.md        # Functional specification
+│   ├── plan.md        # Implementation plan
+│   ├── data-model.md  # Entity definitions
+│   ├── quickstart.md  # Validation scenarios
+│   ├── tasks.md       # Task breakdown
+│   ├── research.md    # Technical research (optional)
+│   └── contracts/     # API contracts
+│       ├── api.yaml   # OpenAPI 3.0
+│       └── events.md  # Real-time events (optional)
 └── validations/       # Validation reports
 ```
 
+## Plan Phase Documents
+
+When running `/speckit.plan`, the following documents are generated:
+
+| Document | Description | Obligatoire |
+|----------|-------------|-------------|
+| `plan.md` | Main implementation plan with Phase -1 Gates | ✅ Yes |
+| `data-model.md` | Entity definitions, relations, validation rules | ✅ Yes |
+| `contracts/api.yaml` | OpenAPI 3.0 specification | ✅ Yes |
+| `contracts/events.md` | WebSocket/SSE event contracts | If real-time |
+| `quickstart.md` | Manual validation scenarios from user stories | ✅ Yes |
+| `research.md` | Technical comparisons and decisions | Optional |
+
 ## Important Conventions
 
 When using spec-kit: