smart-spec-kit-mcp 2.2.4 → 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.
@@ -127,37 +127,37 @@ For multi-step automation, use `start_workflow`:
127
127
 
128
128
  ## Example Interactions
129
129
 
130
- **User**: "speckit: créer une spec pour un système de notifications push"
130
+ **User**: `/speckit.specify pour un système de notifications push`
131
131
  **Action**: Call `speckit_specify` with `requirements: "système de notifications push"`
132
132
 
133
- **User**: "speckit: planifier l'implémentation"
133
+ **User**: `/speckit.plan`
134
134
  **Action**: Call `speckit_plan` (will find the most recent spec automatically)
135
135
 
136
- **User**: "speckit: implement task 3"
136
+ **User**: `/speckit.implement task 3`
137
137
  **Action**: Call `speckit_implement` with `taskId: "3"`
138
138
 
139
- **User**: "speckit: memory list"
139
+ **User**: `/speckit.memory list`
140
140
  **Action**: Call `speckit_memory` with `action: "list"`
141
141
 
142
- **User**: "speckit: memory ajouter une décision technique"
142
+ **User**: `/speckit.memory ajouter une décision technique`
143
143
  **Action**: Call `speckit_memory` with `action: "add"`, `category: "decisions"`
144
144
 
145
- **User**: "speckit: memory auto"
145
+ **User**: `/speckit.memory auto`
146
146
  **Action**: Call `speckit_memory` with `action: "auto"` to auto-enrich from context
147
147
 
148
- **User**: "speckit: validate security"
148
+ **User**: `/speckit.validate security`
149
149
  **Action**: Call `speckit_validate` with `ruleType: "security"`
150
150
 
151
- **User**: "speckit: valider la conformité RGPD de la spec"
151
+ **User**: `/speckit.validate rgpd phase=spec`
152
152
  **Action**: Call `speckit_validate` with `ruleType: "rgpd"`, `phase: "spec"`
153
153
 
154
- **User**: "speckit: validate architecture-rules"
154
+ **User**: `/speckit.validate architecture-rules`
155
155
  **Action**: Call `speckit_validate` with `ruleType: "architecture"` (uses custom rules file)
156
156
 
157
- **User**: "speckit: start_workflow workflow_name="feature-standard" PiP Support auto=true"
157
+ **User**: `speckit: start_workflow workflow_name="feature-standard" PiP Support auto=true`
158
158
  **Action**: Call `start_workflow` with `workflow_name: "feature-standard"`, `context_id: "PiP Support"`, `auto: true`
159
159
 
160
- **User**: "speckit: help comment créer un nouveau workflow ?"
160
+ **User**: `/speckit.help comment créer un nouveau workflow ?`
161
161
  **Action**: Call `speckit_help` with `topic: "workflows"`
162
162
 
163
163
  **User**: "Comment fonctionne spec-kit ?"
@@ -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
@@ -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