smart-spec-kit-mcp 2.2.7 → 2.2.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,46 +1,73 @@
1
+ ````prompt
1
2
  ---
2
- description: "Obtenir de l'aide sur l'utilisation de Spec-Kit"
3
+ description: "Afficher l'aide et les commandes Spec-Kit disponibles"
3
4
  mode: "agent"
4
5
  tools: ["mcp_spec-kit_speckit_help"]
5
6
  ---
6
7
 
7
8
  # Spec-Kit: Aide
8
9
 
9
- Vous utilisez **Spec-Kit** pour obtenir de l'aide sur le framework.
10
-
11
- ## Instructions
12
-
13
- Appelez l'outil MCP `speckit_help` pour obtenir de l'aide.
10
+ ## Arguments utilisateur
14
11
 
15
12
  ```
16
13
  $ARGUMENTS
17
14
  ```
18
15
 
19
- ## Sujets d'aide disponibles
16
+ ## Instructions
20
17
 
21
- - **workflows** : Comment créer et personnaliser des workflows
22
- - **templates** : Comment utiliser et personnaliser les templates
23
- - **prompts** : Comment modifier les prompts des commandes
24
- - **customization** : Personnalisation avancée de Spec-Kit
25
- - **troubleshooting** : Résolution de problèmes courants
18
+ Affiche l'aide Spec-Kit. Si un sujet est fourni, donne des détails sur ce sujet.
26
19
 
27
- ## Commandes Spec-Kit
20
+ ## 🚀 Commandes Slash Disponibles
28
21
 
29
- | Commande | Description |
22
+ | Commande | Description | Exemple |
23
+ |----------|-------------|---------|
24
+ | `/speckit.specify` | Créer une spécification | `/speckit.specify système de login` |
25
+ | `/speckit.plan` | Créer un plan d'implémentation | `/speckit.plan` |
26
+ | `/speckit.tasks` | Générer les tâches | `/speckit.tasks` |
27
+ | `/speckit.implement` | Implémenter les tâches | `/speckit.implement` ou `/speckit.implement task 3` |
28
+ | `/speckit.clarify` | Clarifier les exigences | `/speckit.clarify` |
29
+ | `/speckit.validate` | Valider conformité (sécurité, RGPD) | `/speckit.validate security` |
30
+ | `/speckit.memory` | Gérer la mémoire projet | `/speckit.memory list` |
31
+ | `/speckit.workflow` | Démarrer un workflow automatisé | `/speckit.workflow feature-standard` |
32
+ | `/speckit.help` | Cette aide | `/speckit.help workflows` |
33
+
34
+ ## 📋 Workflows Automatisés
35
+
36
+ | Workflow | Description |
30
37
  |----------|-------------|
31
- | `/speckit.specify` | Créer une spécification |
32
- | `/speckit.plan` | Créer un plan d'implémentation |
33
- | `/speckit.tasks` | Générer les tâches |
34
- | `/speckit.implement` | Implémenter les tâches |
35
- | `/speckit.clarify` | Clarifier les exigences |
36
- | `/speckit.validate` | Valider la conformité |
37
- | `/speckit.memory` | Gérer la mémoire projet |
38
- | `/speckit.help` | Cette aide |
38
+ | `feature-quick` | Rapide: spec implement |
39
+ | `feature-standard` | Standard: spec plan tasks → implement |
40
+ | `feature-full` | Complet avec validations sécurité/RGPD |
41
+ | `bugfix` | Correction de bug |
42
+
43
+ **Usage:** `/speckit.workflow feature-standard Mon Feature`
39
44
 
40
- ## Workflow typique
45
+ ## 🔄 Workflow Typique
41
46
 
42
47
  ```
43
48
  specify → plan → tasks → implement
44
49
 
45
50
  clarify (si nécessaire)
46
51
  ```
52
+
53
+ ## 📁 Structure du Projet
54
+
55
+ ```
56
+ .spec-kit/
57
+ ├── prompts/ # Personnaliser les commandes
58
+ ├── templates/ # Templates des documents
59
+ ├── memory/ # Constitution projet
60
+ ├── rules/ # Règles de validation
61
+ └── workflows/ # Workflows custom
62
+ specs/ # Specs générées
63
+ ```
64
+
65
+ ## 🎯 Sujets d'Aide
66
+
67
+ - **workflows** : Créer et personnaliser des workflows
68
+ - **templates** : Utiliser et modifier les templates
69
+ - **prompts** : Modifier le comportement des commandes
70
+ - **customization** : Personnalisation avancée
71
+ - **troubleshooting** : Résolution de problèmes
72
+
73
+ ````
@@ -0,0 +1,48 @@
1
+ ````prompt
2
+ ---
3
+ description: "Démarrer un workflow Spec-Kit automatisé"
4
+ mode: "agent"
5
+ tools: ["mcp_spec-kit_start_workflow", "mcp_spec-kit_workflow_status", "mcp_spec-kit_abort_workflow"]
6
+ ---
7
+
8
+ # Spec-Kit: Workflows
9
+
10
+ Démarre un workflow automatisé multi-étapes.
11
+
12
+ ## Arguments utilisateur
13
+
14
+ ```
15
+ $ARGUMENTS
16
+ ```
17
+
18
+ ## Comment interpréter
19
+
20
+ 1. **Si l'utilisateur donne un nom de workflow** → Démarrer ce workflow avec `start_workflow`
21
+ 2. **Si l'utilisateur dit "list"** → Lister les workflows disponibles
22
+ 3. **Si l'utilisateur dit "status"** → Vérifier le statut avec `workflow_status`
23
+ 4. **Si l'utilisateur dit "stop" ou "abort"** → Annuler avec `abort_workflow`
24
+
25
+ ## Workflows disponibles
26
+
27
+ | Nom | Description |
28
+ |-----|-------------|
29
+ | `feature-quick` | Quick win (spec → implement) |
30
+ | `feature-standard` | Standard (spec → plan → tasks → implement) |
31
+ | `feature-full` | Avec validations sécurité/RGPD |
32
+ | `bugfix` | Correction de bug |
33
+
34
+ ## Exemples
35
+
36
+ - `/speckit.workflow feature-standard Multi-View` → `start_workflow` avec `workflow_name="feature-standard"`, `context_id="Multi-View"`
37
+ - `/speckit.workflow list` → Afficher la liste des workflows
38
+ - `/speckit.workflow status` → Vérifier le statut
39
+
40
+ ## Simplification
41
+
42
+ Si l'utilisateur tape juste un nom de workflow sans "start":
43
+ - `/speckit.workflow feature-standard` → Démarrer feature-standard
44
+ - `/speckit.workflow bugfix` → Démarrer bugfix
45
+
46
+ Le texte après le nom du workflow devient le `context_id`.
47
+
48
+ ````
@@ -1,17 +1,17 @@
1
- # Full Feature Workflow with Governance
2
- # Complete workflow with all validation checkpoints
1
+ # Feature Full Workflow
2
+ # Complete workflow with validation checkpoints
3
3
 
4
4
  name: feature-full
5
- displayName: "Feature with Full Governance"
6
- description: "Complete feature workflow including RGPD, Security, Architecture, Design System, and Testing validations"
5
+ displayName: "Feature with Validation"
6
+ description: "Complete feature workflow with security and RGPD validations"
7
7
 
8
8
  metadata:
9
- version: "1.0"
9
+ version: "2.0"
10
10
  author: "Spec-Kit"
11
11
  tags:
12
12
  - feature
13
13
  - governance
14
- - enterprise
14
+ - validation
15
15
 
16
16
  template: functional-spec.md
17
17
  defaultAgent: SpecAgent
@@ -20,86 +20,40 @@ steps:
20
20
  # ═══════════════════════════════════════════════════════════════
21
21
  # PHASE 1: SPECIFICATION
22
22
  # ═══════════════════════════════════════════════════════════════
23
-
24
- - id: fetch-requirements
25
- name: "1.1 Fetch Requirements"
26
- action: fetch_ado
27
- description: |
28
- Retrieve the Feature work item and all linked items from Azure DevOps.
29
-
30
- Extract:
31
- - Title and description
32
- - Acceptance criteria
33
- - Parent Epic context
34
- - Linked User Stories
35
- - Attachments (mockups, documents)
36
- outputs:
37
- - workitem_data
38
- - linked_items
39
- - attachments
40
23
 
41
- - id: write-spec
42
- name: "1.2 Write Functional Specification"
24
+ - id: create-spec
25
+ name: "1. Create Specification"
43
26
  action: call_agent
44
27
  agent: SpecAgent
45
28
  description: |
46
- Generate a comprehensive functional specification including:
29
+ Create a comprehensive functional specification.
47
30
 
48
- **Functional Requirements**
31
+ Include:
32
+ - Feature summary and objectives
49
33
  - User stories with acceptance criteria
50
- - Business rules
34
+ - Functional requirements
35
+ - Non-functional requirements
51
36
  - Data requirements
37
+ - Dependencies and constraints
52
38
 
53
- **Non-Functional Requirements**
54
- - Performance targets
55
- - Availability requirements
56
- - Scalability needs
57
-
58
- Mark uncertain sections with [TO FILL] for human review.
39
+ Mark unclear sections with [NEEDS CLARIFICATION] for review.
59
40
  inputs:
60
- source: "workitem_data"
41
+ - name: requirements
42
+ description: "Feature description from user"
43
+ required: true
61
44
  outputs:
62
- - functional_spec
45
+ - spec_document
63
46
 
64
47
  # ═══════════════════════════════════════════════════════════════
65
- # PHASE 2: VALIDATION GATES
48
+ # PHASE 2: VALIDATION
66
49
  # ═══════════════════════════════════════════════════════════════
67
50
 
68
- - id: rgpd-review
69
- name: "2.1 🛡️ RGPD Compliance Review"
70
- action: review
71
- agent: GovAgent
72
- description: |
73
- Validate GDPR/RGPD compliance:
74
-
75
- **Data Collection**
76
- - [ ] Personal data identified and documented
77
- - [ ] Legal basis for processing defined
78
- - [ ] Data minimization principle applied
79
-
80
- **User Rights**
81
- - [ ] Right to access implemented
82
- - [ ] Right to rectification supported
83
- - [ ] Right to erasure (RTBF) supported
84
- - [ ] Data portability considered
85
-
86
- **Security & Governance**
87
- - [ ] Data retention period defined
88
- - [ ] Third-party processors identified
89
- - [ ] Privacy by design applied
90
- - [ ] DPIA required? (if high risk)
91
- inputs:
92
- spec: "functional_spec"
93
- outputs:
94
- - rgpd_report
95
- - rgpd_status
96
-
97
51
  - id: security-review
98
- name: "2.2 🔒 Security Review"
52
+ name: "2.1 🔒 Security Review"
99
53
  action: review
100
54
  agent: GovAgent
101
55
  description: |
102
- Security assessment checklist:
56
+ Security assessment based on the specification:
103
57
 
104
58
  **Authentication & Authorization**
105
59
  - [ ] Auth mechanism defined
@@ -107,238 +61,109 @@ steps:
107
61
  - [ ] Session management
108
62
 
109
63
  **Data Protection**
110
- - [ ] Encryption at rest
111
- - [ ] Encryption in transit (TLS)
64
+ - [ ] Encryption requirements
112
65
  - [ ] Sensitive data handling
113
66
 
114
67
  **Input/Output Security**
115
68
  - [ ] Input validation strategy
116
69
  - [ ] Output encoding
117
- - [ ] SQL injection prevention
118
- - [ ] XSS prevention
119
- - [ ] CSRF protection
70
+ - [ ] Injection prevention
120
71
 
121
- **Infrastructure**
122
- - [ ] Secrets management
123
- - [ ] Logging (without PII)
124
- - [ ] Rate limiting
125
- - [ ] DDoS considerations
72
+ Identify any security concerns and recommendations.
126
73
  inputs:
127
- spec: "functional_spec"
74
+ spec: "spec_document"
128
75
  outputs:
129
76
  - security_report
130
- - security_status
131
77
 
132
- - id: architecture-review
133
- name: "2.3 🏗️ Architecture Review"
134
- action: review
135
- agent: GovAgent
136
- description: |
137
- Architecture validation:
138
-
139
- **Consistency**
140
- - [ ] Aligns with existing architecture
141
- - [ ] Follows established patterns
142
- - [ ] Uses approved technologies
143
-
144
- **Quality Attributes**
145
- - [ ] Scalability addressed
146
- - [ ] Performance requirements met
147
- - [ ] Reliability/Availability design
148
- - [ ] Maintainability considered
149
-
150
- **Technical Debt**
151
- - [ ] No unnecessary complexity
152
- - [ ] Reuses existing components
153
- - [ ] Technical debt acceptable
154
-
155
- **Integration**
156
- - [ ] API contracts defined
157
- - [ ] Event/message schemas
158
- - [ ] Database changes documented
159
- inputs:
160
- spec: "functional_spec"
161
- outputs:
162
- - architecture_report
163
- - architecture_status
164
-
165
- - id: design-review
166
- name: "2.4 🎨 Design System Review"
78
+ - id: rgpd-review
79
+ name: "2.2 🛡️ RGPD Review"
167
80
  action: review
168
81
  agent: GovAgent
169
82
  description: |
170
- Design System compliance (if UI involved):
83
+ GDPR/RGPD compliance check:
171
84
 
172
- **Components**
173
- - [ ] Uses Design System components
174
- - [ ] No unauthorized custom components
175
- - [ ] Proper component composition
176
-
177
- **Visual Consistency**
178
- - [ ] Color tokens used correctly
179
- - [ ] Typography follows guidelines
180
- - [ ] Spacing uses standard scale
181
- - [ ] Icons from approved library
182
-
183
- **Accessibility (WCAG 2.1 AA)**
184
- - [ ] Color contrast ratios
185
- - [ ] Keyboard navigation
186
- - [ ] Screen reader support
187
- - [ ] Focus indicators
85
+ **Data Collection**
86
+ - [ ] Personal data identified
87
+ - [ ] Legal basis for processing
88
+ - [ ] Data minimization applied
188
89
 
189
- **Responsive Design**
190
- - [ ] Mobile breakpoints defined
191
- - [ ] Touch targets adequate
192
- - [ ] Dark mode support (if applicable)
90
+ **User Rights**
91
+ - [ ] Right to access
92
+ - [ ] Right to rectification
93
+ - [ ] Right to erasure
94
+
95
+ **Governance**
96
+ - [ ] Data retention period
97
+ - [ ] Third-party processors
98
+ - [ ] Privacy by design
193
99
  inputs:
194
- spec: "functional_spec"
100
+ spec: "spec_document"
195
101
  outputs:
196
- - design_report
197
- - design_status
102
+ - rgpd_report
198
103
 
199
104
  # ═══════════════════════════════════════════════════════════════
200
- # PHASE 3: TECHNICAL PLANNING
105
+ # PHASE 3: PLANNING
201
106
  # ═══════════════════════════════════════════════════════════════
202
107
 
203
- - id: technical-plan
204
- name: "3.1 Technical Planning"
108
+ - id: create-plan
109
+ name: "3. Create Implementation Plan"
205
110
  action: call_agent
206
111
  agent: PlanAgent
207
112
  description: |
208
- Create detailed technical plan:
113
+ Create a detailed implementation plan incorporating validation feedback.
209
114
 
210
- **Architecture Decisions**
115
+ Include:
116
+ - Technical approach
211
117
  - Components to create/modify
212
- - Database schema changes
213
- - API endpoints
214
- - Integration points
215
-
216
- **Task Breakdown**
217
- - Granular tasks (1-3 days each)
218
- - Clear acceptance criteria
219
- - Dependencies mapped
220
- - Effort estimates (S/M/L/XL)
221
-
222
- **Risk Mitigation**
223
- - Technical risks identified
224
- - Mitigation strategies
225
- - Spike tasks if needed
226
- inputs:
227
- spec: "functional_spec"
228
- reviews: ["rgpd_report", "security_report", "architecture_report"]
229
- outputs:
230
- - technical_plan
231
- - task_list
232
-
233
- - id: test-strategy
234
- name: "3.2 🧪 Test Strategy"
235
- action: call_agent
236
- agent: TestAgent
237
- description: |
238
- Define comprehensive test strategy:
239
-
240
- **Unit Tests**
241
- - Critical business logic
242
- - Edge cases
243
- - Error handling
244
- - Target: >80% coverage
245
-
246
- **Integration Tests**
247
- - API contracts
248
- - Database operations
249
- - External service mocks
250
-
251
- **E2E Tests**
252
- - Critical user journeys
253
- - Happy path scenarios
254
- - Key error scenarios
255
-
256
- **Non-Functional Tests**
257
- - Performance benchmarks
258
- - Load testing thresholds
259
- - Security scan requirements
118
+ - Security measures to implement
119
+ - RGPD compliance measures
120
+ - Dependencies and order
121
+ - Risk assessment
260
122
  inputs:
261
- spec: "functional_spec"
262
- plan: "technical_plan"
123
+ spec: "spec_document"
124
+ reviews: ["security_report", "rgpd_report"]
263
125
  outputs:
264
- - test_strategy
265
- - test_cases
126
+ - plan_document
266
127
 
267
128
  # ═══════════════════════════════════════════════════════════════
268
- # PHASE 4: DOCUMENTATION & FINALIZATION
129
+ # PHASE 4: TASKS
269
130
  # ═══════════════════════════════════════════════════════════════
270
131
 
271
- - id: documentation
272
- name: "4.1 📚 Documentation Plan"
273
- action: generate_content
132
+ - id: generate-tasks
133
+ name: "4. Generate Tasks"
134
+ action: call_agent
135
+ agent: PlanAgent
274
136
  description: |
275
- Identify documentation needs:
276
-
277
- **User Documentation**
278
- - [ ] User guide updates
279
- - [ ] FAQ additions
280
- - [ ] Tutorial/walkthrough
137
+ Break down the plan into atomic tasks.
281
138
 
282
- **Technical Documentation**
283
- - [ ] API documentation
284
- - [ ] Architecture Decision Record (ADR)
285
- - [ ] Runbook updates
286
- - [ ] README updates
287
-
288
- **Release Documentation**
289
- - [ ] Changelog entry
290
- - [ ] Release notes
291
- - [ ] Migration guide (if breaking changes)
139
+ Each task should:
140
+ - Be completable in 1-2 hours
141
+ - Have clear acceptance criteria
142
+ - Include security/RGPD considerations
143
+ - Be independently testable
292
144
  inputs:
293
- spec: "functional_spec"
294
- plan: "technical_plan"
145
+ source: "plan_document"
295
146
  outputs:
296
- - documentation_plan
147
+ - tasks_document
297
148
 
298
- - id: final-approval
299
- name: "4.2 Final Approval Gate"
300
- action: review
301
- agent: GovAgent
302
- description: |
303
- Final checklist before development starts:
304
-
305
- **Specification**
306
- - [ ] Functional spec complete and approved
307
- - [ ] All [TO FILL] sections resolved
308
- - [ ] Stakeholder sign-off obtained
309
-
310
- **Compliance**
311
- - [ ] RGPD review: PASSED
312
- - [ ] Security review: PASSED
313
- - [ ] Architecture review: PASSED
314
- - [ ] Design review: PASSED (if applicable)
315
-
316
- **Planning**
317
- - [ ] Technical plan approved
318
- - [ ] Tasks created in ADO
319
- - [ ] Test strategy defined
320
- - [ ] Documentation plan ready
321
-
322
- **Ready for Development** ✅
323
- inputs:
324
- all_artifacts: true
325
- outputs:
326
- - final_approval
327
- - development_ready
149
+ # ═══════════════════════════════════════════════════════════════
150
+ # PHASE 5: IMPLEMENTATION
151
+ # ═══════════════════════════════════════════════════════════════
328
152
 
329
- - id: create-tasks
330
- name: "4.3 Create ADO Work Items"
331
- action: create_file
153
+ - id: implement
154
+ name: "5. Implement"
155
+ action: call_agent
156
+ agent: SpecAgent
332
157
  description: |
333
- Generate Azure DevOps work items:
334
- - Create Tasks from technical plan
335
- - Link to parent Feature
336
- - Set estimates and priorities
337
- - Assign to sprint
338
-
339
- Output format ready for ADO import or manual creation.
158
+ Implement the tasks following security and RGPD guidelines.
159
+
160
+ For each task:
161
+ - Implement following project conventions
162
+ - Apply security measures
163
+ - Ensure RGPD compliance
164
+ - Write appropriate tests
165
+ - Update task status when complete
340
166
  inputs:
341
- tasks: "task_list"
342
- feature_id: "context_id"
167
+ source: "tasks_document"
343
168
  outputs:
344
- - ado_work_items
169
+ - implementation