smart-spec-kit-mcp 2.2.5 → 2.2.6
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.
- package/README.md +43 -26
- package/dist/utils/workflowLoader.d.ts +1 -1
- package/dist/utils/workflowLoader.js +3 -3
- package/dist/utils/workflowLoader.js.map +1 -1
- package/package.json +1 -1
- package/templates/bugfix-report.md +0 -184
- package/templates/functional-spec.md +0 -191
- package/workflows/bugfix-quick.yaml +0 -53
- package/workflows/bugfix.yaml +0 -99
- package/workflows/feature-full.yaml +0 -344
- package/workflows/feature-quick.yaml +0 -69
- package/workflows/feature-standard.yaml +0 -92
package/README.md
CHANGED
|
@@ -76,47 +76,60 @@ Puis rechargez VS Code: `Ctrl+Shift+P` → "Developer: Reload Window"
|
|
|
76
76
|
|
|
77
77
|
## 📁 Structure du Projet
|
|
78
78
|
|
|
79
|
-
|
|
79
|
+
### Structure interne du package Spec-Kit
|
|
80
80
|
|
|
81
81
|
```text
|
|
82
|
-
|
|
83
|
-
├──
|
|
84
|
-
│ ├── prompts/ #
|
|
85
|
-
│ │ ├── speckit.specify.prompt.md
|
|
86
|
-
│ │ ├── speckit.plan.prompt.md
|
|
87
|
-
│ │ ├── speckit.tasks.prompt.md
|
|
88
|
-
│ │ ├── speckit.implement.prompt.md
|
|
89
|
-
│ │ ├── speckit.clarify.prompt.md
|
|
90
|
-
│ │ ├── speckit.validate.prompt.md
|
|
91
|
-
│ │ ├── speckit.memory.prompt.md
|
|
92
|
-
│ │ └── speckit.help.prompt.md
|
|
93
|
-
│ └── copilot-instructions.md # Guide Copilot sur l'utilisation de Spec-Kit
|
|
94
|
-
├── .spec-kit/
|
|
95
|
-
│ ├── prompts/ # Prompts (lus par les outils MCP)
|
|
82
|
+
smart-spec-kit-mcp/
|
|
83
|
+
├── starter-kit/ # Source unique de la configuration
|
|
84
|
+
│ ├── prompts/ # Prompts MCP (specify, plan, implement, etc.)
|
|
96
85
|
│ │ ├── specify.md
|
|
97
86
|
│ │ ├── plan.md
|
|
98
87
|
│ │ ├── tasks.md
|
|
99
88
|
│ │ ├── implement.md
|
|
100
89
|
│ │ ├── clarify.md
|
|
101
|
-
│ │
|
|
90
|
+
│ │ ├── validate.md
|
|
91
|
+
│ │ └── memory.md
|
|
102
92
|
│ ├── templates/ # Templates de documents
|
|
103
93
|
│ │ ├── functional-spec.md
|
|
94
|
+
│ │ ├── bugfix-report.md
|
|
104
95
|
│ │ ├── plan-template.md
|
|
105
96
|
│ │ └── tasks-template.md
|
|
97
|
+
│ ├── workflows/ # Workflows YAML prédéfinis
|
|
98
|
+
│ │ ├── feature-quick.yaml # 3-step (spécification rapide)
|
|
99
|
+
│ │ ├── feature-standard.yaml # 4-step (complet)
|
|
100
|
+
│ │ ├── feature-full.yaml # 5-step (détaillé)
|
|
101
|
+
│ │ ├── bugfix-quick.yaml # 2-step (bugfix rapide)
|
|
102
|
+
│ │ └── bugfix.yaml
|
|
106
103
|
│ ├── rules/ # Règles de validation
|
|
107
|
-
│ │ ├── security-rules.md # Règles
|
|
108
|
-
│ │ └── rgpd-rules.md # Conformité
|
|
104
|
+
│ │ ├── security-rules.md # Règles OWASP
|
|
105
|
+
│ │ └── rgpd-rules.md # Conformité GDPR
|
|
109
106
|
│ ├── memory/ # Contexte projet
|
|
110
107
|
│ │ └── constitution.md # Principes du projet
|
|
111
|
-
│
|
|
112
|
-
│
|
|
113
|
-
│
|
|
114
|
-
|
|
115
|
-
|
|
108
|
+
│ ├── github-prompts/ # Slash commands pour Copilot
|
|
109
|
+
│ │ └── speckit.*.prompt.md
|
|
110
|
+
│ └── copilot-instructions.md # Guide Copilot
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
### Structure après installation dans votre projet
|
|
114
|
+
|
|
115
|
+
```text
|
|
116
|
+
votre-projet/
|
|
117
|
+
├── .github/
|
|
118
|
+
│ └── copilot-instructions.md # Copié lors du setup
|
|
119
|
+
├── .spec-kit/ # Configuration locale (personnalisations)
|
|
120
|
+
│ ├── prompts/ # Override les prompts par défaut
|
|
121
|
+
│ ├── templates/ # Override les templates par défaut
|
|
122
|
+
│ ├── workflows/ # Vos workflows personnalisés
|
|
123
|
+
│ ├── rules/ # Vos règles de validation
|
|
124
|
+
│ └── memory/
|
|
125
|
+
│ └── constitution.md # Principes de votre projet
|
|
116
126
|
└── specs/ # Spécifications générées
|
|
117
127
|
└── validations/ # Rapports de validation
|
|
118
128
|
```
|
|
119
129
|
|
|
130
|
+
**Note**: Les workflows et templates par défaut viennent de `starter-kit/` du package.
|
|
131
|
+
Vous pouvez personnaliser en créant des fichiers dans `.spec-kit/`.
|
|
132
|
+
|
|
120
133
|
---
|
|
121
134
|
|
|
122
135
|
## 🎮 Commandes Disponibles
|
|
@@ -180,6 +193,7 @@ Vous pouvez aussi utiliser ces phrases dans Copilot Chat:
|
|
|
180
193
|
```
|
|
181
194
|
|
|
182
195
|
Ou avec la commande par mots-clés:
|
|
196
|
+
|
|
183
197
|
```text
|
|
184
198
|
speckit: spec pour un système de notifications push
|
|
185
199
|
```
|
|
@@ -283,9 +297,12 @@ Pour récupérer automatiquement les work items:
|
|
|
283
297
|
},
|
|
284
298
|
"azure-devops": {
|
|
285
299
|
"command": "npx",
|
|
286
|
-
"args": [
|
|
300
|
+
"args": [
|
|
301
|
+
"-y",
|
|
302
|
+
"@azure-devops/mcp",
|
|
303
|
+
"your-org",
|
|
304
|
+
],
|
|
287
305
|
"env": {
|
|
288
|
-
"AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-org",
|
|
289
306
|
"AZURE_DEVOPS_PAT": "your-token"
|
|
290
307
|
}
|
|
291
308
|
}
|
|
@@ -326,7 +343,7 @@ Pour une documentation détaillée sur tous les outils et fonctionnalités:
|
|
|
326
343
|
- **[docs/DOCUMENTATION.md](docs/DOCUMENTATION.md)** - Documentation complète des outils MCP et workflows
|
|
327
344
|
- **[docs/PACKAGING.md](docs/PACKAGING.md)** - Guide de packaging et distribution
|
|
328
345
|
- **[PROJECT_CONTEXT.md](PROJECT_CONTEXT.md)** - Contexte du projet Spec-Kit
|
|
329
|
-
- **[
|
|
346
|
+
- **[TODO.md](TODO.md)** - Tâches en cours et prévues
|
|
330
347
|
- **[TROUBLESHOOTING.md](TROUBLESHOOTING.md)** - Guide de dépannage complet
|
|
331
348
|
|
|
332
349
|
---
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
*
|
|
6
6
|
* Resolution order:
|
|
7
7
|
* 1. Local project: .spec-kit/workflows/ and .spec-kit/templates/
|
|
8
|
-
* 2. Package defaults: /workflows and /templates
|
|
8
|
+
* 2. Package defaults: starter-kit/workflows and starter-kit/templates
|
|
9
9
|
*
|
|
10
10
|
* This allows any project to customize workflows while using defaults.
|
|
11
11
|
*/
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
*
|
|
6
6
|
* Resolution order:
|
|
7
7
|
* 1. Local project: .spec-kit/workflows/ and .spec-kit/templates/
|
|
8
|
-
* 2. Package defaults: /workflows and /templates
|
|
8
|
+
* 2. Package defaults: starter-kit/workflows and starter-kit/templates
|
|
9
9
|
*
|
|
10
10
|
* This allows any project to customize workflows while using defaults.
|
|
11
11
|
*/
|
|
@@ -57,8 +57,8 @@ function getSearchPaths(assetType) {
|
|
|
57
57
|
path.join(projectRoot, LOCAL_CONFIG_DIR, dir),
|
|
58
58
|
// 2. Local project root: workflows/ or templates/ (for dedicated spec projects)
|
|
59
59
|
path.join(projectRoot, dir),
|
|
60
|
-
// 3. Package defaults
|
|
61
|
-
path.join(packageRoot, dir),
|
|
60
|
+
// 3. Package defaults (starter-kit/)
|
|
61
|
+
path.join(packageRoot, "starter-kit", dir),
|
|
62
62
|
];
|
|
63
63
|
}
|
|
64
64
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workflowLoader.js","sourceRoot":"","sources":["../../src/utils/workflowLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAiB,MAAM,8BAA8B,CAAC;AAK7E,kBAAkB;AAClB,MAAM,aAAa,GAAG,WAAW,CAAC;AAClC,MAAM,aAAa,GAAG,WAAW,CAAC;AAClC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAErC;;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,SAAS,cAAc;IACrB,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,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,SAAS,cAAc,CAAC,SAAoC;IAC1D,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,GAAG,GAAG,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC;IAEtE,OAAO;QACL,0EAA0E;QAC1E,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,CAAC;QAC7C,gFAAgF;QAChF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC;QAC3B,
|
|
1
|
+
{"version":3,"file":"workflowLoader.js","sourceRoot":"","sources":["../../src/utils/workflowLoader.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,184 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "[TO FILL: Bug Title]"
|
|
3
|
-
workitem_id: "[TO FILL]"
|
|
4
|
-
type: Bug Fix Report
|
|
5
|
-
version: "1.0"
|
|
6
|
-
status: Draft
|
|
7
|
-
author: "[TO FILL]"
|
|
8
|
-
created: "[TO FILL: Date]"
|
|
9
|
-
severity: "[TO FILL: Critical/High/Medium/Low]"
|
|
10
|
-
azure_devops_link: "[TO FILL: Link to ADO Bug]"
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
# Bug Fix Report: [TO FILL: Bug Title]
|
|
14
|
-
|
|
15
|
-
## 1. Bug Summary
|
|
16
|
-
|
|
17
|
-
| Field | Value |
|
|
18
|
-
|-------|-------|
|
|
19
|
-
| **Bug ID** | [TO FILL] |
|
|
20
|
-
| **Severity** | [TO FILL: Critical/High/Medium/Low] |
|
|
21
|
-
| **Priority** | [TO FILL: P1/P2/P3/P4] |
|
|
22
|
-
| **Reported By** | [TO FILL] |
|
|
23
|
-
| **Reported Date** | [TO FILL] |
|
|
24
|
-
| **Environment** | [TO FILL: Production/Staging/Dev] |
|
|
25
|
-
| **Affected Version** | [TO FILL] |
|
|
26
|
-
|
|
27
|
-
---
|
|
28
|
-
|
|
29
|
-
## 2. Problem Description
|
|
30
|
-
|
|
31
|
-
### 2.1 Expected Behavior
|
|
32
|
-
|
|
33
|
-
[TO FILL: What should happen]
|
|
34
|
-
|
|
35
|
-
### 2.2 Actual Behavior
|
|
36
|
-
|
|
37
|
-
[TO FILL: What actually happens]
|
|
38
|
-
|
|
39
|
-
### 2.3 Reproduction Steps
|
|
40
|
-
|
|
41
|
-
1. [TO FILL: Step 1]
|
|
42
|
-
2. [TO FILL: Step 2]
|
|
43
|
-
3. [TO FILL: Step 3]
|
|
44
|
-
4. [TO FILL: Observe error]
|
|
45
|
-
|
|
46
|
-
### 2.4 Error Details
|
|
47
|
-
|
|
48
|
-
```
|
|
49
|
-
[TO FILL: Error message, stack trace, logs]
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
### 2.5 Screenshots/Evidence
|
|
53
|
-
|
|
54
|
-
[TO FILL: Attach or link screenshots]
|
|
55
|
-
|
|
56
|
-
---
|
|
57
|
-
|
|
58
|
-
## 3. Impact Assessment
|
|
59
|
-
|
|
60
|
-
### 3.1 User Impact
|
|
61
|
-
|
|
62
|
-
| Aspect | Assessment |
|
|
63
|
-
|--------|------------|
|
|
64
|
-
| Users Affected | [TO FILL: All/Subset/Specific role] |
|
|
65
|
-
| Frequency | [TO FILL: Always/Sometimes/Rare] |
|
|
66
|
-
| Workaround Available | [TO FILL: Yes/No] |
|
|
67
|
-
| Business Impact | [TO FILL: Description] |
|
|
68
|
-
|
|
69
|
-
### 3.2 Affected Components
|
|
70
|
-
|
|
71
|
-
- [ ] Frontend
|
|
72
|
-
- [ ] Backend API
|
|
73
|
-
- [ ] Database
|
|
74
|
-
- [ ] External Service
|
|
75
|
-
- [ ] Infrastructure
|
|
76
|
-
|
|
77
|
-
Component details: [TO FILL]
|
|
78
|
-
|
|
79
|
-
---
|
|
80
|
-
|
|
81
|
-
## 4. Root Cause Analysis
|
|
82
|
-
|
|
83
|
-
### 4.1 Investigation Summary
|
|
84
|
-
|
|
85
|
-
[TO FILL: Summary of investigation steps taken]
|
|
86
|
-
|
|
87
|
-
### 4.2 Root Cause
|
|
88
|
-
|
|
89
|
-
[TO FILL: Identified root cause of the bug]
|
|
90
|
-
|
|
91
|
-
### 4.3 Why It Wasn't Caught
|
|
92
|
-
|
|
93
|
-
[TO FILL: Gap in testing/review that allowed this bug]
|
|
94
|
-
|
|
95
|
-
---
|
|
96
|
-
|
|
97
|
-
## 5. Fix Proposal
|
|
98
|
-
|
|
99
|
-
### 5.1 Proposed Solution
|
|
100
|
-
|
|
101
|
-
[TO FILL: Description of the fix]
|
|
102
|
-
|
|
103
|
-
### 5.2 Files/Components to Modify
|
|
104
|
-
|
|
105
|
-
| File/Component | Change Type | Description |
|
|
106
|
-
|----------------|-------------|-------------|
|
|
107
|
-
| [TO FILL] | Modify | [TO FILL] |
|
|
108
|
-
| [TO FILL] | Add | [TO FILL] |
|
|
109
|
-
|
|
110
|
-
### 5.3 Risk Assessment
|
|
111
|
-
|
|
112
|
-
| Risk | Probability | Impact | Mitigation |
|
|
113
|
-
|------|-------------|--------|------------|
|
|
114
|
-
| Regression in X | [TO FILL] | [TO FILL] | [TO FILL] |
|
|
115
|
-
|
|
116
|
-
### 5.4 Rollback Plan
|
|
117
|
-
|
|
118
|
-
[TO FILL: How to rollback if the fix causes issues]
|
|
119
|
-
|
|
120
|
-
---
|
|
121
|
-
|
|
122
|
-
## 6. Validation Checklist
|
|
123
|
-
|
|
124
|
-
### 6.1 Security Review
|
|
125
|
-
|
|
126
|
-
- [ ] No new vulnerabilities introduced
|
|
127
|
-
- [ ] Input validation maintained
|
|
128
|
-
- [ ] No sensitive data exposure
|
|
129
|
-
- [ ] Auth/Authz intact
|
|
130
|
-
|
|
131
|
-
### 6.2 Testing
|
|
132
|
-
|
|
133
|
-
- [ ] Unit test for bug scenario added
|
|
134
|
-
- [ ] Regression tests pass
|
|
135
|
-
- [ ] Manual testing completed
|
|
136
|
-
- [ ] Edge cases covered
|
|
137
|
-
|
|
138
|
-
### 6.3 Code Quality
|
|
139
|
-
|
|
140
|
-
- [ ] Code review completed
|
|
141
|
-
- [ ] No new technical debt
|
|
142
|
-
- [ ] Follows coding standards
|
|
143
|
-
- [ ] Documentation updated
|
|
144
|
-
|
|
145
|
-
---
|
|
146
|
-
|
|
147
|
-
## 7. Resolution
|
|
148
|
-
|
|
149
|
-
### 7.1 Fix Implementation
|
|
150
|
-
|
|
151
|
-
| Field | Value |
|
|
152
|
-
|-------|-------|
|
|
153
|
-
| **Fix Branch** | [TO FILL] |
|
|
154
|
-
| **PR Link** | [TO FILL] |
|
|
155
|
-
| **Deployed To** | [TO FILL] |
|
|
156
|
-
| **Deployed Date** | [TO FILL] |
|
|
157
|
-
| **Verified By** | [TO FILL] |
|
|
158
|
-
|
|
159
|
-
### 7.2 Lessons Learned
|
|
160
|
-
|
|
161
|
-
[TO FILL: What can be improved to prevent similar bugs]
|
|
162
|
-
|
|
163
|
-
### 7.3 Follow-up Actions
|
|
164
|
-
|
|
165
|
-
- [ ] [TO FILL: Action item 1]
|
|
166
|
-
- [ ] [TO FILL: Action item 2]
|
|
167
|
-
|
|
168
|
-
---
|
|
169
|
-
|
|
170
|
-
## 8. Approval
|
|
171
|
-
|
|
172
|
-
| Role | Name | Date | Status |
|
|
173
|
-
|------|------|------|--------|
|
|
174
|
-
| Developer | [TO FILL] | | ☐ Completed |
|
|
175
|
-
| Code Reviewer | [TO FILL] | | ☐ Approved |
|
|
176
|
-
| QA | [TO FILL] | | ☐ Verified |
|
|
177
|
-
|
|
178
|
-
---
|
|
179
|
-
|
|
180
|
-
## Revision History
|
|
181
|
-
|
|
182
|
-
| Version | Date | Author | Changes |
|
|
183
|
-
|---------|------|--------|---------|
|
|
184
|
-
| 1.0 | [TO FILL] | [TO FILL] | Initial report |
|
|
@@ -1,191 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "[TO FILL: Feature Title]"
|
|
3
|
-
workitem_id: "[TO FILL]"
|
|
4
|
-
type: Functional Specification
|
|
5
|
-
version: "1.0"
|
|
6
|
-
status: Draft
|
|
7
|
-
author: "[TO FILL]"
|
|
8
|
-
created: "[TO FILL: Date]"
|
|
9
|
-
last_updated: "[TO FILL: Date]"
|
|
10
|
-
azure_devops_link: "[TO FILL: Link to ADO Work Item]"
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
# Functional Specification: [TO FILL: Feature Title]
|
|
14
|
-
|
|
15
|
-
## 1. Overview
|
|
16
|
-
|
|
17
|
-
### 1.1 Purpose
|
|
18
|
-
[TO FILL: Brief description of the feature's purpose and the problem it solves]
|
|
19
|
-
|
|
20
|
-
### 1.2 Scope
|
|
21
|
-
[TO FILL: What is included and explicitly excluded from this feature]
|
|
22
|
-
|
|
23
|
-
### 1.3 Background
|
|
24
|
-
[TO FILL: Context and history leading to this feature request]
|
|
25
|
-
|
|
26
|
-
---
|
|
27
|
-
|
|
28
|
-
## 2. Stakeholders
|
|
29
|
-
|
|
30
|
-
| Role | Name | Responsibility |
|
|
31
|
-
|------|------|----------------|
|
|
32
|
-
| Product Owner | [TO FILL] | Requirements validation |
|
|
33
|
-
| Tech Lead | [TO FILL] | Technical decisions |
|
|
34
|
-
| QA Lead | [TO FILL] | Test strategy |
|
|
35
|
-
| UX Designer | [TO FILL] | User experience |
|
|
36
|
-
|
|
37
|
-
---
|
|
38
|
-
|
|
39
|
-
## 3. Requirements
|
|
40
|
-
|
|
41
|
-
### 3.1 Functional Requirements
|
|
42
|
-
|
|
43
|
-
| ID | Requirement | Priority | Source |
|
|
44
|
-
|----|-------------|----------|--------|
|
|
45
|
-
| FR-001 | [TO FILL] | Must Have | ADO #{workitem_id} |
|
|
46
|
-
| FR-002 | [TO FILL] | Should Have | |
|
|
47
|
-
| FR-003 | [TO FILL] | Could Have | |
|
|
48
|
-
|
|
49
|
-
### 3.2 Non-Functional Requirements
|
|
50
|
-
|
|
51
|
-
| ID | Category | Requirement | Target |
|
|
52
|
-
|----|----------|-------------|--------|
|
|
53
|
-
| NFR-001 | Performance | [TO FILL] | [TO FILL] |
|
|
54
|
-
| NFR-002 | Security | [TO FILL] | [TO FILL] |
|
|
55
|
-
| NFR-003 | Availability | [TO FILL] | [TO FILL] |
|
|
56
|
-
| NFR-004 | Scalability | [TO FILL] | [TO FILL] |
|
|
57
|
-
|
|
58
|
-
### 3.3 Acceptance Criteria
|
|
59
|
-
|
|
60
|
-
```gherkin
|
|
61
|
-
Feature: [TO FILL: Feature Name]
|
|
62
|
-
|
|
63
|
-
Scenario: [TO FILL: Main Success Scenario]
|
|
64
|
-
Given [TO FILL: Initial context]
|
|
65
|
-
When [TO FILL: Action performed]
|
|
66
|
-
Then [TO FILL: Expected outcome]
|
|
67
|
-
|
|
68
|
-
Scenario: [TO FILL: Alternative Scenario]
|
|
69
|
-
Given [TO FILL]
|
|
70
|
-
When [TO FILL]
|
|
71
|
-
Then [TO FILL]
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
---
|
|
75
|
-
|
|
76
|
-
## 4. User Experience
|
|
77
|
-
|
|
78
|
-
### 4.1 User Personas
|
|
79
|
-
|
|
80
|
-
**Persona 1: [TO FILL: Name]**
|
|
81
|
-
- Role: [TO FILL]
|
|
82
|
-
- Goals: [TO FILL]
|
|
83
|
-
- Pain Points: [TO FILL]
|
|
84
|
-
|
|
85
|
-
### 4.2 User Stories
|
|
86
|
-
|
|
87
|
-
| ID | As a... | I want to... | So that... |
|
|
88
|
-
|----|---------|--------------|------------|
|
|
89
|
-
| US-001 | [TO FILL] | [TO FILL] | [TO FILL] |
|
|
90
|
-
| US-002 | [TO FILL] | [TO FILL] | [TO FILL] |
|
|
91
|
-
|
|
92
|
-
### 4.3 User Flow
|
|
93
|
-
|
|
94
|
-
```
|
|
95
|
-
[TO FILL: Describe or link to user flow diagram]
|
|
96
|
-
┌─────────┐ ┌─────────┐ ┌─────────┐
|
|
97
|
-
│ Step 1 │───▶│ Step 2 │───▶│ Step 3 │
|
|
98
|
-
└─────────┘ └─────────┘ └─────────┘
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
---
|
|
102
|
-
|
|
103
|
-
## 5. Technical Considerations
|
|
104
|
-
|
|
105
|
-
### 5.1 Architecture Impact
|
|
106
|
-
[TO FILL: How this feature affects the existing architecture]
|
|
107
|
-
|
|
108
|
-
### 5.2 Dependencies
|
|
109
|
-
|
|
110
|
-
| Dependency | Type | Status | Notes |
|
|
111
|
-
|------------|------|--------|-------|
|
|
112
|
-
| [TO FILL] | Service/API | [TO FILL] | |
|
|
113
|
-
| [TO FILL] | Library | [TO FILL] | |
|
|
114
|
-
|
|
115
|
-
### 5.3 Data Model Changes
|
|
116
|
-
[TO FILL: New entities, modified schemas, migrations needed]
|
|
117
|
-
|
|
118
|
-
### 5.4 API Changes
|
|
119
|
-
[TO FILL: New endpoints, modified contracts]
|
|
120
|
-
|
|
121
|
-
---
|
|
122
|
-
|
|
123
|
-
## 6. Risks & Assumptions
|
|
124
|
-
|
|
125
|
-
### 6.1 Assumptions
|
|
126
|
-
|
|
127
|
-
| ID | Assumption | Impact if Wrong |
|
|
128
|
-
|----|------------|-----------------|
|
|
129
|
-
| A-001 | [TO FILL] | [TO FILL] |
|
|
130
|
-
|
|
131
|
-
### 6.2 Risks
|
|
132
|
-
|
|
133
|
-
| ID | Risk | Probability | Impact | Mitigation |
|
|
134
|
-
|----|------|-------------|--------|------------|
|
|
135
|
-
| R-001 | [TO FILL] | Medium | High | [TO FILL] |
|
|
136
|
-
|
|
137
|
-
### 6.3 Open Questions
|
|
138
|
-
|
|
139
|
-
- [ ] [TO FILL: Question 1]
|
|
140
|
-
- [ ] [TO FILL: Question 2]
|
|
141
|
-
|
|
142
|
-
---
|
|
143
|
-
|
|
144
|
-
## 7. Implementation Notes
|
|
145
|
-
|
|
146
|
-
### 7.1 Suggested Approach
|
|
147
|
-
[TO FILL: High-level implementation strategy]
|
|
148
|
-
|
|
149
|
-
### 7.2 Phasing (if applicable)
|
|
150
|
-
|
|
151
|
-
| Phase | Scope | Target Date |
|
|
152
|
-
|-------|-------|-------------|
|
|
153
|
-
| Phase 1 | [TO FILL] | [TO FILL] |
|
|
154
|
-
| Phase 2 | [TO FILL] | [TO FILL] |
|
|
155
|
-
|
|
156
|
-
---
|
|
157
|
-
|
|
158
|
-
## 8. Testing Strategy
|
|
159
|
-
|
|
160
|
-
### 8.1 Test Scenarios
|
|
161
|
-
[TO FILL: Key scenarios to test]
|
|
162
|
-
|
|
163
|
-
### 8.2 Test Data Requirements
|
|
164
|
-
[TO FILL: Special data needed for testing]
|
|
165
|
-
|
|
166
|
-
---
|
|
167
|
-
|
|
168
|
-
## 9. Documentation & Training
|
|
169
|
-
|
|
170
|
-
- [ ] User documentation required
|
|
171
|
-
- [ ] Admin documentation required
|
|
172
|
-
- [ ] Training materials needed
|
|
173
|
-
- [ ] Release notes entry
|
|
174
|
-
|
|
175
|
-
---
|
|
176
|
-
|
|
177
|
-
## 10. Approval
|
|
178
|
-
|
|
179
|
-
| Role | Name | Date | Signature |
|
|
180
|
-
|------|------|------|-----------|
|
|
181
|
-
| Product Owner | | | ☐ Approved |
|
|
182
|
-
| Tech Lead | | | ☐ Approved |
|
|
183
|
-
| QA Lead | | | ☐ Approved |
|
|
184
|
-
|
|
185
|
-
---
|
|
186
|
-
|
|
187
|
-
## Revision History
|
|
188
|
-
|
|
189
|
-
| Version | Date | Author | Changes |
|
|
190
|
-
|---------|------|--------|---------|
|
|
191
|
-
| 1.0 | [TO FILL] | [TO FILL] | Initial draft |
|
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
# Bugfix Quick Workflow
|
|
2
|
-
# Lightweight workflow for simple bug fixes
|
|
3
|
-
|
|
4
|
-
name: bugfix-quick
|
|
5
|
-
displayName: "Quick Bug Fix"
|
|
6
|
-
description: "Fast track workflow for simple bug fixes - analyze, fix, verify"
|
|
7
|
-
|
|
8
|
-
metadata:
|
|
9
|
-
version: "1.0"
|
|
10
|
-
author: "Spec-Kit"
|
|
11
|
-
tags:
|
|
12
|
-
- bugfix
|
|
13
|
-
- quick
|
|
14
|
-
- hotfix
|
|
15
|
-
|
|
16
|
-
template: bugfix-report.md
|
|
17
|
-
defaultAgent: SpecAgent
|
|
18
|
-
|
|
19
|
-
steps:
|
|
20
|
-
- id: analyze-fix
|
|
21
|
-
name: "Analyze & Fix"
|
|
22
|
-
action: call_agent
|
|
23
|
-
agent: SpecAgent
|
|
24
|
-
description: |
|
|
25
|
-
Quick bug analysis and fix:
|
|
26
|
-
|
|
27
|
-
1. **Identify the bug**: Understand what's broken
|
|
28
|
-
2. **Find root cause**: Locate the problematic code
|
|
29
|
-
3. **Implement fix**: Make minimal, focused changes
|
|
30
|
-
4. **Verify**: Confirm the fix works
|
|
31
|
-
|
|
32
|
-
Keep it simple - no lengthy documentation needed.
|
|
33
|
-
outputs:
|
|
34
|
-
- bug_analysis
|
|
35
|
-
- code_fix
|
|
36
|
-
|
|
37
|
-
- id: auto-memory
|
|
38
|
-
name: "Update Memory"
|
|
39
|
-
action: call_agent
|
|
40
|
-
agent: SpecAgent
|
|
41
|
-
description: |
|
|
42
|
-
Save learnings from this bugfix to project memory:
|
|
43
|
-
|
|
44
|
-
- **What was the bug?** (brief description)
|
|
45
|
-
- **Root cause** (why it happened)
|
|
46
|
-
- **Solution** (how it was fixed)
|
|
47
|
-
- **Prevention** (how to avoid in future)
|
|
48
|
-
|
|
49
|
-
Save to `.spec-kit/memory/learnings.md`
|
|
50
|
-
inputs:
|
|
51
|
-
source: "code_fix"
|
|
52
|
-
outputs:
|
|
53
|
-
- memory_update
|
package/workflows/bugfix.yaml
DELETED
|
@@ -1,99 +0,0 @@
|
|
|
1
|
-
# Bugfix Workflow
|
|
2
|
-
# Streamlined process for bug fixes with validation checkpoints
|
|
3
|
-
|
|
4
|
-
name: bugfix
|
|
5
|
-
displayName: "Bug Fix"
|
|
6
|
-
description: "Structured workflow for analyzing, fixing, and validating bug corrections"
|
|
7
|
-
|
|
8
|
-
metadata:
|
|
9
|
-
version: "1.0"
|
|
10
|
-
author: "Spec-Kit"
|
|
11
|
-
tags:
|
|
12
|
-
- bugfix
|
|
13
|
-
- hotfix
|
|
14
|
-
- correction
|
|
15
|
-
|
|
16
|
-
template: bugfix-report.md
|
|
17
|
-
defaultAgent: SpecAgent
|
|
18
|
-
|
|
19
|
-
steps:
|
|
20
|
-
- id: analyze-bug
|
|
21
|
-
name: "Analyze Bug & Root Cause"
|
|
22
|
-
action: fetch_ado
|
|
23
|
-
description: |
|
|
24
|
-
Retrieve the bug work item from Azure DevOps and analyze:
|
|
25
|
-
- Reproduction steps
|
|
26
|
-
- Error logs and stack traces
|
|
27
|
-
- Affected components
|
|
28
|
-
- User impact assessment
|
|
29
|
-
|
|
30
|
-
Identify the root cause of the issue.
|
|
31
|
-
outputs:
|
|
32
|
-
- bug_data
|
|
33
|
-
- root_cause_analysis
|
|
34
|
-
|
|
35
|
-
- id: plan-fix
|
|
36
|
-
name: "Plan Correction"
|
|
37
|
-
action: call_agent
|
|
38
|
-
agent: PlanAgent
|
|
39
|
-
description: |
|
|
40
|
-
Create a correction plan including:
|
|
41
|
-
- Proposed fix approach
|
|
42
|
-
- Files/components to modify
|
|
43
|
-
- Potential side effects
|
|
44
|
-
- Rollback strategy if needed
|
|
45
|
-
|
|
46
|
-
Keep the fix minimal and focused.
|
|
47
|
-
inputs:
|
|
48
|
-
source: "root_cause_analysis"
|
|
49
|
-
outputs:
|
|
50
|
-
- fix_plan
|
|
51
|
-
|
|
52
|
-
- id: security-check
|
|
53
|
-
name: "Security Validation"
|
|
54
|
-
action: review
|
|
55
|
-
agent: GovAgent
|
|
56
|
-
description: |
|
|
57
|
-
Quick security review of the proposed fix:
|
|
58
|
-
- [ ] No new vulnerabilities introduced
|
|
59
|
-
- [ ] Input validation maintained
|
|
60
|
-
- [ ] No sensitive data exposure
|
|
61
|
-
- [ ] Authentication/Authorization intact
|
|
62
|
-
inputs:
|
|
63
|
-
document: "fix_plan"
|
|
64
|
-
outputs:
|
|
65
|
-
- security_clearance
|
|
66
|
-
|
|
67
|
-
- id: implement-fix
|
|
68
|
-
name: "Implement & Test"
|
|
69
|
-
action: generate_content
|
|
70
|
-
description: |
|
|
71
|
-
Implement the fix following the plan:
|
|
72
|
-
1. Write the code fix
|
|
73
|
-
2. Add unit tests for the bug scenario
|
|
74
|
-
3. Add regression tests
|
|
75
|
-
4. Update documentation if needed
|
|
76
|
-
|
|
77
|
-
Ensure test coverage for the fixed code path.
|
|
78
|
-
inputs:
|
|
79
|
-
plan: "fix_plan"
|
|
80
|
-
outputs:
|
|
81
|
-
- code_changes
|
|
82
|
-
- test_cases
|
|
83
|
-
|
|
84
|
-
- id: final-review
|
|
85
|
-
name: "Final Review"
|
|
86
|
-
action: review
|
|
87
|
-
agent: GovAgent
|
|
88
|
-
description: |
|
|
89
|
-
Final validation before merge:
|
|
90
|
-
- [ ] Fix addresses root cause
|
|
91
|
-
- [ ] No regression introduced
|
|
92
|
-
- [ ] Tests pass
|
|
93
|
-
- [ ] Code review approved
|
|
94
|
-
- [ ] Documentation updated
|
|
95
|
-
inputs:
|
|
96
|
-
changes: "code_changes"
|
|
97
|
-
tests: "test_cases"
|
|
98
|
-
outputs:
|
|
99
|
-
- approval_status
|
|
@@ -1,344 +0,0 @@
|
|
|
1
|
-
# Full Feature Workflow with Governance
|
|
2
|
-
# Complete workflow with all validation checkpoints
|
|
3
|
-
|
|
4
|
-
name: feature-full
|
|
5
|
-
displayName: "Feature with Full Governance"
|
|
6
|
-
description: "Complete feature workflow including RGPD, Security, Architecture, Design System, and Testing validations"
|
|
7
|
-
|
|
8
|
-
metadata:
|
|
9
|
-
version: "1.0"
|
|
10
|
-
author: "Spec-Kit"
|
|
11
|
-
tags:
|
|
12
|
-
- feature
|
|
13
|
-
- governance
|
|
14
|
-
- enterprise
|
|
15
|
-
|
|
16
|
-
template: functional-spec.md
|
|
17
|
-
defaultAgent: SpecAgent
|
|
18
|
-
|
|
19
|
-
steps:
|
|
20
|
-
# ═══════════════════════════════════════════════════════════════
|
|
21
|
-
# PHASE 1: SPECIFICATION
|
|
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
|
-
|
|
41
|
-
- id: write-spec
|
|
42
|
-
name: "1.2 Write Functional Specification"
|
|
43
|
-
action: call_agent
|
|
44
|
-
agent: SpecAgent
|
|
45
|
-
description: |
|
|
46
|
-
Generate a comprehensive functional specification including:
|
|
47
|
-
|
|
48
|
-
**Functional Requirements**
|
|
49
|
-
- User stories with acceptance criteria
|
|
50
|
-
- Business rules
|
|
51
|
-
- Data requirements
|
|
52
|
-
|
|
53
|
-
**Non-Functional Requirements**
|
|
54
|
-
- Performance targets
|
|
55
|
-
- Availability requirements
|
|
56
|
-
- Scalability needs
|
|
57
|
-
|
|
58
|
-
Mark uncertain sections with [TO FILL] for human review.
|
|
59
|
-
inputs:
|
|
60
|
-
source: "workitem_data"
|
|
61
|
-
outputs:
|
|
62
|
-
- functional_spec
|
|
63
|
-
|
|
64
|
-
# ═══════════════════════════════════════════════════════════════
|
|
65
|
-
# PHASE 2: VALIDATION GATES
|
|
66
|
-
# ═══════════════════════════════════════════════════════════════
|
|
67
|
-
|
|
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
|
-
- id: security-review
|
|
98
|
-
name: "2.2 🔒 Security Review"
|
|
99
|
-
action: review
|
|
100
|
-
agent: GovAgent
|
|
101
|
-
description: |
|
|
102
|
-
Security assessment checklist:
|
|
103
|
-
|
|
104
|
-
**Authentication & Authorization**
|
|
105
|
-
- [ ] Auth mechanism defined
|
|
106
|
-
- [ ] Role-based access control
|
|
107
|
-
- [ ] Session management
|
|
108
|
-
|
|
109
|
-
**Data Protection**
|
|
110
|
-
- [ ] Encryption at rest
|
|
111
|
-
- [ ] Encryption in transit (TLS)
|
|
112
|
-
- [ ] Sensitive data handling
|
|
113
|
-
|
|
114
|
-
**Input/Output Security**
|
|
115
|
-
- [ ] Input validation strategy
|
|
116
|
-
- [ ] Output encoding
|
|
117
|
-
- [ ] SQL injection prevention
|
|
118
|
-
- [ ] XSS prevention
|
|
119
|
-
- [ ] CSRF protection
|
|
120
|
-
|
|
121
|
-
**Infrastructure**
|
|
122
|
-
- [ ] Secrets management
|
|
123
|
-
- [ ] Logging (without PII)
|
|
124
|
-
- [ ] Rate limiting
|
|
125
|
-
- [ ] DDoS considerations
|
|
126
|
-
inputs:
|
|
127
|
-
spec: "functional_spec"
|
|
128
|
-
outputs:
|
|
129
|
-
- security_report
|
|
130
|
-
- security_status
|
|
131
|
-
|
|
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"
|
|
167
|
-
action: review
|
|
168
|
-
agent: GovAgent
|
|
169
|
-
description: |
|
|
170
|
-
Design System compliance (if UI involved):
|
|
171
|
-
|
|
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
|
|
188
|
-
|
|
189
|
-
**Responsive Design**
|
|
190
|
-
- [ ] Mobile breakpoints defined
|
|
191
|
-
- [ ] Touch targets adequate
|
|
192
|
-
- [ ] Dark mode support (if applicable)
|
|
193
|
-
inputs:
|
|
194
|
-
spec: "functional_spec"
|
|
195
|
-
outputs:
|
|
196
|
-
- design_report
|
|
197
|
-
- design_status
|
|
198
|
-
|
|
199
|
-
# ═══════════════════════════════════════════════════════════════
|
|
200
|
-
# PHASE 3: TECHNICAL PLANNING
|
|
201
|
-
# ═══════════════════════════════════════════════════════════════
|
|
202
|
-
|
|
203
|
-
- id: technical-plan
|
|
204
|
-
name: "3.1 Technical Planning"
|
|
205
|
-
action: call_agent
|
|
206
|
-
agent: PlanAgent
|
|
207
|
-
description: |
|
|
208
|
-
Create detailed technical plan:
|
|
209
|
-
|
|
210
|
-
**Architecture Decisions**
|
|
211
|
-
- 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
|
|
260
|
-
inputs:
|
|
261
|
-
spec: "functional_spec"
|
|
262
|
-
plan: "technical_plan"
|
|
263
|
-
outputs:
|
|
264
|
-
- test_strategy
|
|
265
|
-
- test_cases
|
|
266
|
-
|
|
267
|
-
# ═══════════════════════════════════════════════════════════════
|
|
268
|
-
# PHASE 4: DOCUMENTATION & FINALIZATION
|
|
269
|
-
# ═══════════════════════════════════════════════════════════════
|
|
270
|
-
|
|
271
|
-
- id: documentation
|
|
272
|
-
name: "4.1 📚 Documentation Plan"
|
|
273
|
-
action: generate_content
|
|
274
|
-
description: |
|
|
275
|
-
Identify documentation needs:
|
|
276
|
-
|
|
277
|
-
**User Documentation**
|
|
278
|
-
- [ ] User guide updates
|
|
279
|
-
- [ ] FAQ additions
|
|
280
|
-
- [ ] Tutorial/walkthrough
|
|
281
|
-
|
|
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)
|
|
292
|
-
inputs:
|
|
293
|
-
spec: "functional_spec"
|
|
294
|
-
plan: "technical_plan"
|
|
295
|
-
outputs:
|
|
296
|
-
- documentation_plan
|
|
297
|
-
|
|
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
|
|
328
|
-
|
|
329
|
-
- id: create-tasks
|
|
330
|
-
name: "4.3 Create ADO Work Items"
|
|
331
|
-
action: create_file
|
|
332
|
-
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.
|
|
340
|
-
inputs:
|
|
341
|
-
tasks: "task_list"
|
|
342
|
-
feature_id: "context_id"
|
|
343
|
-
outputs:
|
|
344
|
-
- ado_work_items
|
|
@@ -1,69 +0,0 @@
|
|
|
1
|
-
# Feature Quick Workflow
|
|
2
|
-
# Lightweight workflow for simple features / quick wins
|
|
3
|
-
|
|
4
|
-
name: feature-quick
|
|
5
|
-
displayName: "Quick Feature (Quick Win)"
|
|
6
|
-
description: "Lightweight workflow for simple features that don't need full specification"
|
|
7
|
-
|
|
8
|
-
metadata:
|
|
9
|
-
version: "1.0"
|
|
10
|
-
author: "Spec-Kit"
|
|
11
|
-
tags:
|
|
12
|
-
- feature
|
|
13
|
-
- quick-win
|
|
14
|
-
- lightweight
|
|
15
|
-
|
|
16
|
-
template: functional-spec.md
|
|
17
|
-
defaultAgent: SpecAgent
|
|
18
|
-
|
|
19
|
-
steps:
|
|
20
|
-
- id: quick-spec
|
|
21
|
-
name: "Quick Specification"
|
|
22
|
-
action: call_agent
|
|
23
|
-
agent: SpecAgent
|
|
24
|
-
description: |
|
|
25
|
-
Create a minimal specification with:
|
|
26
|
-
- Feature summary (2-3 sentences)
|
|
27
|
-
- User story (As a... I want... So that...)
|
|
28
|
-
- Acceptance criteria (3-5 bullet points)
|
|
29
|
-
- Technical notes (if any)
|
|
30
|
-
|
|
31
|
-
Keep it simple and actionable. No lengthy documentation needed.
|
|
32
|
-
inputs:
|
|
33
|
-
- name: requirements
|
|
34
|
-
description: "Feature description from user"
|
|
35
|
-
required: true
|
|
36
|
-
outputs:
|
|
37
|
-
- quick_spec
|
|
38
|
-
|
|
39
|
-
- id: implement
|
|
40
|
-
name: "Implement"
|
|
41
|
-
action: call_agent
|
|
42
|
-
agent: SpecAgent
|
|
43
|
-
description: |
|
|
44
|
-
Implement the feature directly based on the quick spec.
|
|
45
|
-
|
|
46
|
-
Guidelines:
|
|
47
|
-
- Follow project conventions from constitution
|
|
48
|
-
- Write clean, tested code
|
|
49
|
-
- Keep changes minimal and focused
|
|
50
|
-
inputs:
|
|
51
|
-
source: "quick_spec"
|
|
52
|
-
outputs:
|
|
53
|
-
- implementation
|
|
54
|
-
|
|
55
|
-
- id: auto-memory
|
|
56
|
-
name: "Update Memory"
|
|
57
|
-
action: call_agent
|
|
58
|
-
agent: SpecAgent
|
|
59
|
-
description: |
|
|
60
|
-
Automatically enrich project memory with:
|
|
61
|
-
- What was implemented (brief summary)
|
|
62
|
-
- Any technical decisions made
|
|
63
|
-
- Patterns or conventions used
|
|
64
|
-
|
|
65
|
-
Save to .spec-kit/memory/learnings.md or appropriate category.
|
|
66
|
-
inputs:
|
|
67
|
-
source: "implementation"
|
|
68
|
-
outputs:
|
|
69
|
-
- memory_update
|
|
@@ -1,92 +0,0 @@
|
|
|
1
|
-
# Feature Standard Workflow
|
|
2
|
-
# Used for creating functional specifications from Azure DevOps Feature work items
|
|
3
|
-
|
|
4
|
-
name: feature-standard
|
|
5
|
-
displayName: "Feature Specification"
|
|
6
|
-
description: "Creates a complete functional specification document from an Azure DevOps Feature work item"
|
|
7
|
-
|
|
8
|
-
metadata:
|
|
9
|
-
version: "1.0"
|
|
10
|
-
author: "Spec-Kit"
|
|
11
|
-
tags:
|
|
12
|
-
- feature
|
|
13
|
-
- specification
|
|
14
|
-
- functional
|
|
15
|
-
|
|
16
|
-
template: functional-spec.md
|
|
17
|
-
defaultAgent: SpecAgent
|
|
18
|
-
|
|
19
|
-
steps:
|
|
20
|
-
- id: fetch-workitem
|
|
21
|
-
name: "Fetch Azure DevOps Work Item"
|
|
22
|
-
action: fetch_ado
|
|
23
|
-
description: |
|
|
24
|
-
Retrieve the Feature work item from Azure DevOps.
|
|
25
|
-
Extract: Title, Description, Acceptance Criteria, Tags, Links, and Parent/Child relationships.
|
|
26
|
-
outputs:
|
|
27
|
-
- workitem_data
|
|
28
|
-
- linked_items
|
|
29
|
-
|
|
30
|
-
- id: analyze-requirements
|
|
31
|
-
name: "Analyze Requirements"
|
|
32
|
-
action: call_agent
|
|
33
|
-
agent: SpecAgent
|
|
34
|
-
description: |
|
|
35
|
-
Analyze the work item data to identify:
|
|
36
|
-
- Core functional requirements
|
|
37
|
-
- Non-functional requirements (performance, security, etc.)
|
|
38
|
-
- User personas and use cases
|
|
39
|
-
- Dependencies and constraints
|
|
40
|
-
- Risks and assumptions
|
|
41
|
-
inputs:
|
|
42
|
-
source: "workitem_data"
|
|
43
|
-
outputs:
|
|
44
|
-
- requirements_analysis
|
|
45
|
-
|
|
46
|
-
- id: generate-spec
|
|
47
|
-
name: "Generate Specification Document"
|
|
48
|
-
action: generate_content
|
|
49
|
-
agent: SpecAgent
|
|
50
|
-
description: |
|
|
51
|
-
Using the template and analyzed requirements, generate the functional specification.
|
|
52
|
-
|
|
53
|
-
Guidelines:
|
|
54
|
-
- Fill all sections with available data
|
|
55
|
-
- Mark unclear sections with [TO FILL] for human review
|
|
56
|
-
- Include traceability links to Azure DevOps
|
|
57
|
-
- Follow the template structure strictly
|
|
58
|
-
inputs:
|
|
59
|
-
template: "functional-spec.md"
|
|
60
|
-
data: "requirements_analysis"
|
|
61
|
-
outputs:
|
|
62
|
-
- spec_document
|
|
63
|
-
|
|
64
|
-
- id: review-spec
|
|
65
|
-
name: "Review & Validate"
|
|
66
|
-
action: review
|
|
67
|
-
agent: GovAgent
|
|
68
|
-
description: |
|
|
69
|
-
Review the generated specification for:
|
|
70
|
-
- Completeness (all required sections filled)
|
|
71
|
-
- Consistency (no contradictions)
|
|
72
|
-
- Clarity (understandable by all stakeholders)
|
|
73
|
-
- Traceability (links to source requirements)
|
|
74
|
-
|
|
75
|
-
Suggest improvements if needed.
|
|
76
|
-
inputs:
|
|
77
|
-
document: "spec_document"
|
|
78
|
-
outputs:
|
|
79
|
-
- review_feedback
|
|
80
|
-
- validated_spec
|
|
81
|
-
|
|
82
|
-
- id: create-file
|
|
83
|
-
name: "Save Specification"
|
|
84
|
-
action: create_file
|
|
85
|
-
description: |
|
|
86
|
-
Save the validated specification as a Markdown file.
|
|
87
|
-
Suggested location: `specs/{workitem_id}-functional-spec.md`
|
|
88
|
-
inputs:
|
|
89
|
-
content: "validated_spec"
|
|
90
|
-
filename_pattern: "{context_id}-functional-spec.md"
|
|
91
|
-
outputs:
|
|
92
|
-
- file_path
|