smart-spec-kit-mcp 2.0.1 → 2.0.3

package/starter-kit/templates/functional-spec.md

@@ -0,0 +1,144 @@
+---
+title: "[TO FILL: Feature Title]"
+workitem_id: "[TO FILL]"
+type: Functional Specification
+version: "1.0"
+status: Draft
+author: "[TO FILL]"
+created: "[TO FILL: Date]"
+last_updated: "[TO FILL: Date]"
+---
+
+# Functional Specification: [TO FILL: Feature Title]
+
+## 1. Overview
+
+### 1.1 Purpose
+[TO FILL: Brief description of the feature's purpose and the problem it solves]
+
+### 1.2 Scope
+**In Scope:**
+- [TO FILL: What is included]
+
+**Out of Scope:**
+- [TO FILL: What is explicitly excluded]
+
+### 1.3 Background
+[TO FILL: Context and history leading to this feature request]
+
+---
+
+## 2. Stakeholders
+
+| Role | Name | Responsibility |
+|------|------|----------------|
+| Product Owner | [TO FILL] | Requirements validation |
+| Tech Lead | [TO FILL] | Technical decisions |
+| QA Lead | [TO FILL] | Test strategy |
+
+---
+
+## 3. Requirements
+
+### 3.1 Functional Requirements
+
+| ID | Requirement | Priority | Source |
+|----|-------------|----------|--------|
+| FR-001 | [TO FILL] | Must Have | |
+| FR-002 | [TO FILL] | Should Have | |
+| FR-003 | [TO FILL] | Could Have | |
+
+### 3.2 Non-Functional Requirements
+
+| ID | Category | Requirement | Target |
+|----|----------|-------------|--------|
+| NFR-001 | Performance | [TO FILL] | [TO FILL] |
+| NFR-002 | Security | [TO FILL] | [TO FILL] |
+| NFR-003 | Availability | [TO FILL] | [TO FILL] |
+
+### 3.3 Acceptance Criteria
+
+```gherkin
+Feature: [TO FILL: Feature Name]
+
+  Scenario: [TO FILL: Main Success Scenario]
+    Given [TO FILL: Initial context]
+    When [TO FILL: Action performed]
+    Then [TO FILL: Expected outcome]
+
+  Scenario: [TO FILL: Alternative Scenario]
+    Given [TO FILL]
+    When [TO FILL]
+    Then [TO FILL]
+```
+
+---
+
+## 4. User Experience
+
+### 4.1 User Personas
+
+**Persona 1: [TO FILL: Name]**
+- Role: [TO FILL]
+- Goals: [TO FILL]
+- Pain Points: [TO FILL]
+
+### 4.2 User Stories
+
+| ID | As a... | I want to... | So that... | Priority |
+|----|---------|--------------|------------|----------|
+| US-001 | [TO FILL] | [TO FILL] | [TO FILL] | P1 |
+| US-002 | [TO FILL] | [TO FILL] | [TO FILL] | P2 |
+
+### 4.3 User Flow
+
+```
+[TO FILL: Describe or link to user flow diagram]
+┌─────────┐    ┌─────────┐    ┌─────────┐
+│ Step 1  │───▶│ Step 2  │───▶│ Step 3  │
+└─────────┘    └─────────┘    └─────────┘
+```
+
+---
+
+## 5. Technical Considerations
+
+### 5.1 Dependencies
+- [TO FILL: External systems, services, or components this feature depends on]
+
+### 5.2 Constraints
+- [TO FILL: Technical or business constraints]
+
+### 5.3 Data Requirements
+- [TO FILL: Data entities, storage, and access patterns]
+
+---
+
+## 6. Assumptions & Risks
+
+### 6.1 Assumptions
+| ID | Assumption | Impact if Wrong |
+|----|------------|-----------------|
+| A-001 | [TO FILL] | [TO FILL] |
+
+### 6.2 Risks
+| ID | Risk | Probability | Impact | Mitigation |
+|----|------|-------------|--------|------------|
+| R-001 | [TO FILL] | Medium | High | [TO FILL] |
+
+---
+
+## 7. Clarifications
+
+| # | Topic | Question | Answer | Date |
+|---|-------|----------|--------|------|
+| | | | | |
+
+---
+
+## 8. Approval
+
+| Role | Name | Date | Status |
+|------|------|------|--------|
+| Product Owner | | | ⬜ Pending |
+| Tech Lead | | | ⬜ Pending |

package/starter-kit/templates/plan-template.md

@@ -0,0 +1,126 @@
+# Implementation Plan: [FEATURE NAME]
+
+**Branch**: `[###-feature-name]` | **Date**: [DATE] | **Spec**: [link to spec.md]
+
+## Summary
+
+[TO FILL: Brief description of the implementation approach]
+
+## Technical Context
+
+### Tech Stack
+| Component | Technology | Version |
+|-----------|------------|---------|
+| Language | [TO FILL] | |
+| Framework | [TO FILL] | |
+| Database | [TO FILL] | |
+| Testing | [TO FILL] | |
+
+### Architecture Overview
+
+```
+[TO FILL: ASCII diagram or description of architecture]
+
+┌─────────────┐    ┌─────────────┐    ┌─────────────┐
+│   Client    │───▶│     API     │───▶│  Database   │
+└─────────────┘    └─────────────┘    └─────────────┘
+```
+
+---
+
+## Project Structure
+
+```text
+[TO FILL: Project directory structure]
+
+src/
+├── models/
+├── services/
+├── api/
+└── utils/
+
+tests/
+├── unit/
+├── integration/
+└── e2e/
+```
+
+---
+
+## Implementation Phases
+
+### Phase 0: Research & Design
+**Duration**: [X days]
+**Output**: research.md, data-model.md
+
+- [ ] Validate tech stack choices
+- [ ] Research key libraries/patterns
+- [ ] Design data model
+- [ ] Define API contracts
+
+### Phase 1: Foundation
+**Duration**: [X days]
+**Dependencies**: Phase 0
+
+- [ ] Set up project structure
+- [ ] Configure build/test pipeline
+- [ ] Create base models
+- [ ] Set up database schema
+
+### Phase 2: Core Implementation
+**Duration**: [X days]
+**Dependencies**: Phase 1
+
+- [ ] Implement core services
+- [ ] Create API endpoints
+- [ ] Add unit tests
+
+### Phase 3: Integration & Polish
+**Duration**: [X days]
+**Dependencies**: Phase 2
+
+- [ ] Integration testing
+- [ ] Error handling improvements
+- [ ] Documentation
+- [ ] Performance optimization
+
+---
+
+## Quality Gates
+
+| Gate | Criteria | Status |
+|------|----------|--------|
+| Code Review | All PRs reviewed | ⬜ |
+| Unit Tests | >80% coverage | ⬜ |
+| Integration Tests | All scenarios pass | ⬜ |
+| Documentation | README updated | ⬜ |
+
+---
+
+## Risks & Mitigations
+
+| Risk | Probability | Impact | Mitigation |
+|------|-------------|--------|------------|
+| [TO FILL] | Medium | High | [TO FILL] |
+
+---
+
+## Technical Decisions
+
+| Decision | Options Considered | Choice | Rationale |
+|----------|-------------------|--------|-----------|
+| [TO FILL] | [TO FILL] | [TO FILL] | [TO FILL] |
+
+---
+
+## Dependencies
+
+| Dependency | Version | Purpose | Notes |
+|------------|---------|---------|-------|
+| [TO FILL] | | | |
+
+---
+
+## Notes
+
+[TO FILL: Additional implementation notes, gotchas, or considerations]

package/starter-kit/templates/tasks-template.md

@@ -0,0 +1,153 @@
+# Tasks: [FEATURE NAME]
+
+**Input**: Design documents from `/specs/[feature]/`
+**Generated**: [DATE]
+**Total Tasks**: [COUNT]
+
+---
+
+## Task Format
+
+```
+- [ ] T### [P?] [Story?] Description - `path/to/file.ext`
+```
+
+**Legend**:
+- `T###`: Task ID (sequential)
+- `[P]`: Can be executed in parallel with other `[P]` tasks in same phase
+- `[Story?]`: Associated user story ID (optional)
+- File path in backticks shows primary file(s) affected
+
+---
+
+## Phase 1: Setup (Shared Infrastructure)
+
+**Purpose**: Project initialization and basic structure
+**Duration**: [X days]
+
+- [ ] T001 Initialize project with package manager - `package.json`
+- [ ] T002 Configure TypeScript/linting - `tsconfig.json`, `.eslintrc`
+- [ ] T003 [P] Set up testing framework - `jest.config.js`
+- [ ] T004 [P] Create project directory structure - `src/`
+
+---
+
+## Phase 2: Foundational (Blocking Prerequisites)
+
+**Purpose**: Core infrastructure that MUST be complete before ANY user story
+**Duration**: [X days]
+
+⚠️ **CRITICAL**: No user story work begins until this phase is complete.
+
+- [ ] T005 Create database schema - `src/db/schema.sql`
+- [ ] T006 [P] Set up database migrations - `src/db/migrations/`
+- [ ] T007 [P] Implement base entity models - `src/models/`
+- [ ] T008 Create error handling utilities - `src/utils/errors.ts`
+- [ ] T009 Set up logging infrastructure - `src/utils/logger.ts`
+
+**Checkpoint**: Foundation ready - run `npm run test:setup` to verify
+
+---
+
+## Phase 3: User Story 1 - [Title] (Priority: P1) 🎯 MVP
+
+**Goal**: [User story goal from spec]
+**Independent Test**: [How to verify this story works alone]
+**Duration**: [X days]
+
+- [ ] T010 [US-1] Create [entity] model - `src/models/entity.ts`
+- [ ] T011 [P] [US-1] Create [entity] repository - `src/repositories/entity.ts`
+- [ ] T012 [P] [US-1] Create [entity] service - `src/services/entity.ts`
+- [ ] T013 [US-1] Create [endpoint] API route - `src/api/routes/entity.ts`
+- [ ] T014 [US-1] Add unit tests for service - `tests/unit/entity.test.ts`
+- [ ] T015 [US-1] Add integration tests - `tests/integration/entity.test.ts`
+
+**Checkpoint**: Story 1 complete - run `npm test && npm run test:integration`
+
+---
+
+## Phase 4: User Story 2 - [Title] (Priority: P2)
+
+**Goal**: [User story goal from spec]
+**Independent Test**: [How to verify this story works alone]
+**Duration**: [X days]
+
+- [ ] T020 [US-2] [Description] - `path/to/file`
+- [ ] T021 [P] [US-2] [Description] - `path/to/file`
+- [ ] T022 [US-2] [Description] - `path/to/file`
+
+**Checkpoint**: Story 2 complete - [verification command]
+
+---
+
+## Phase 5: User Story 3 - [Title] (Priority: P3)
+
+**Goal**: [User story goal from spec]
+**Duration**: [X days]
+
+- [ ] T030 [US-3] [Description] - `path/to/file`
+
+**Checkpoint**: Story 3 complete - [verification command]
+
+---
+
+## Phase N: Polish & Cross-Cutting Concerns
+
+**Purpose**: Final quality improvements
+**Duration**: [X days]
+
+- [ ] T090 Code cleanup and refactoring
+- [ ] T091 [P] Update documentation - `README.md`
+- [ ] T092 [P] Add inline code comments
+- [ ] T093 Performance profiling and optimization
+- [ ] T094 Security review and hardening
+- [ ] T095 Final integration test pass
+
+---
+
+## Dependencies & Execution Order
+
+```
+Phase 1 (Setup)
+    │
+    ▼
+Phase 2 (Foundation)
+    │
+    ├──────────────┬──────────────┐
+    ▼              ▼              ▼
+Phase 3 (US-1)  Phase 4 (US-2)  Phase 5 (US-3)  ← Can run in parallel
+    │              │              │
+    └──────────────┴──────────────┘
+                   │
+                   ▼
+            Phase N (Polish)
+```
+
+---
+
+## Parallel Execution Example
+
+Tasks marked `[P]` within the same phase can run simultaneously:
+
+```
+Phase 3, Story 1:
+├── T010 Create model (sequential - others depend on this)
+│
+├── T011 [P] Create repository  ─┐
+├── T012 [P] Create service     ─┼── Run in parallel
+└── T013 Create API route (waits for T011, T012)
+```
+
+---
+
+## Task Statistics
+
+| Phase | Tasks | Parallel | Duration |
+|-------|-------|----------|----------|
+| Setup | 4 | 2 | [X days] |
+| Foundation | 5 | 3 | [X days] |
+| Story 1 | 6 | 2 | [X days] |
+| Story 2 | 3 | 1 | [X days] |
+| Story 3 | 1 | 0 | [X days] |
+| Polish | 6 | 3 | [X days] |
+| **Total** | **25** | **11** | **[X days]** |

package/.github/copilot/prompts/spec-kit-abort.prompt.md

@@ -1,22 +0,0 @@
----
-description: "Annule le workflow Spec-Kit en cours"
----
-
-# Annuler le workflow Spec-Kit
-
-Tu dois annuler le workflow Spec-Kit actuellement en cours.
-
-## Action requise
-
-Utilise l'outil `abort_workflow` du serveur MCP `spec-kit`.
-
-## Comportement
-
-Cette action:
-1. Annule le workflow en cours
-2. Supprime la session
-3. Nettoie l'état
-
-⚠️ Les données collectées seront perdues.
-
-Exécute maintenant l'outil `abort_workflow` de spec-kit.

package/.github/copilot/prompts/spec-kit-config.prompt.md

@@ -1,20 +0,0 @@
----
-description: "Affiche la configuration Spec-Kit actuelle"
----
-
-# Configuration Spec-Kit
-
-Tu dois afficher la configuration actuelle de Spec-Kit.
-
-## Action requise
-
-Utilise l'outil `show_config` du serveur MCP `spec-kit`.
-
-## Informations affichées
-
-- Chemins de recherche des workflows
-- Chemins de recherche des templates
-- Liste des workflows disponibles (locaux vs package)
-- Projet courant
-
-Exécute maintenant l'outil `show_config` de spec-kit.

package/.github/copilot/prompts/spec-kit-continue.prompt.md

@@ -1,25 +0,0 @@
----
-description: "Continue le workflow Spec-Kit à l'étape suivante"
----
-
-# Continuer le workflow Spec-Kit
-
-Tu dois continuer le workflow Spec-Kit en cours à l'étape suivante.
-
-## Action requise
-
-Utilise l'outil `execute_step` du serveur MCP `spec-kit`.
-
-## Paramètres optionnels
-
-- `session_id` - ID de session (optionnel, utilise la session active par défaut)
-- `previous_output` - Données de l'étape précédente si nécessaire
-
-## Comportement
-
-Le serveur:
-1. Exécute l'étape suivante du workflow
-2. Retourne les instructions pour Copilot
-3. Attend la validation de l'utilisateur
-
-Exécute maintenant l'outil `execute_step` de spec-kit.

package/.github/copilot/prompts/spec-kit-init.prompt.md

@@ -1,19 +0,0 @@
----
-description: "Initialise Spec-Kit dans le projet pour créer des workflows personnalisés"
----
-
-# Initialisation de Spec-Kit
-
-Tu dois initialiser Spec-Kit dans le projet courant.
-
-## Action requise
-
-Utilise l'outil `init_project` du serveur MCP `spec-kit` pour créer la configuration locale.
-
-## Résultat attendu
-
-Après l'exécution, le dossier `.spec-kit/` sera créé avec:
-- `workflows/` - Pour les workflows personnalisés
-- `templates/` - Pour les templates personnalisés
-
-Exécute maintenant l'outil `init_project` de spec-kit.

package/.github/copilot/prompts/spec-kit-list.prompt.md

@@ -1,19 +0,0 @@
----
-description: "Liste les workflows Spec-Kit disponibles"
----
-
-# Liste des workflows Spec-Kit
-
-Tu dois lister les workflows disponibles dans Spec-Kit.
-
-## Action requise
-
-Utilise l'outil `list_workflows` du serveur MCP `spec-kit`.
-
-## Workflows par défaut
-
-- `feature-standard` - Spécification fonctionnelle (5 étapes)
-- `feature-full` - Spec + gouvernance complète (10 étapes)
-- `bugfix` - Rapport de correction de bug (5 étapes)
-
-Exécute maintenant l'outil `list_workflows` de spec-kit.

package/.github/copilot/prompts/spec-kit-ping.prompt.md

@@ -1,17 +0,0 @@
----
-description: "Vérifie que le serveur Spec-Kit fonctionne"
----
-
-# Ping Spec-Kit
-
-Tu dois vérifier que le serveur Spec-Kit est opérationnel.
-
-## Action requise
-
-Utilise l'outil `ping` du serveur MCP `spec-kit`.
-
-## Résultat attendu
-
-Si le serveur fonctionne, tu recevras "pong" avec la version et les capacités.
-
-Exécute maintenant l'outil `ping` de spec-kit.

package/.github/copilot/prompts/spec-kit-start.prompt.md

@@ -1,30 +0,0 @@
----
-description: "Démarre un workflow Spec-Kit pour générer une spécification"
----
-
-# Démarrer un workflow Spec-Kit
-
-Tu dois démarrer un workflow Spec-Kit pour générer une spécification.
-
-## Paramètres requis
-
-Demande à l'utilisateur s'il n'a pas précisé:
-
-1. **workflow_name** - Le nom du workflow à utiliser:
-   - `feature-standard` - Spécification fonctionnelle simple (5 étapes)
-   - `feature-full` - Spécification avec gouvernance complète (10 étapes)
-   - `bugfix` - Rapport de correction de bug (5 étapes)
-
-2. **context_id** - L'identifiant du contexte (généralement l'ID du work item Azure DevOps)
-
-## Action requise
-
-Utilise l'outil `start_workflow` du serveur MCP `spec-kit` avec les paramètres:
-- `workflow_name`: le workflow choisi
-- `context_id`: l'ID fourni par l'utilisateur
-
-## Flux automatique
-
-Une fois démarré, le serveur orchestre automatiquement les étapes. L'utilisateur n'a qu'à valider chaque action avec "OK" ou "Continue".
-
-Demande les paramètres manquants puis exécute `start_workflow`.

package/.github/copilot/prompts/spec-kit-status.prompt.md

@@ -1,21 +0,0 @@
----
-description: "Affiche le statut du workflow Spec-Kit en cours"
----
-
-# Statut du workflow Spec-Kit
-
-Tu dois afficher le statut du workflow Spec-Kit actuellement en cours.
-
-## Action requise
-
-Utilise l'outil `workflow_status` du serveur MCP `spec-kit`.
-
-## Informations affichées
-
-- Session ID
-- Workflow en cours
-- Étape actuelle
-- Historique des étapes complétées
-- Données collectées
-
-Exécute maintenant l'outil `workflow_status` de spec-kit.