specflow-cc 1.0.0 → 1.2.0
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/CHANGELOG.md +29 -0
- package/README.md +50 -43
- package/agents/codebase-scanner.md +243 -0
- package/agents/impl-reviewer.md +6 -6
- package/agents/spec-auditor.md +5 -5
- package/agents/spec-creator.md +5 -5
- package/agents/spec-executor.md +2 -2
- package/agents/spec-reviser.md +2 -2
- package/agents/spec-splitter.md +1 -1
- package/commands/sf/audit.md +35 -11
- package/commands/sf/deps.md +9 -9
- package/commands/sf/done.md +8 -8
- package/commands/sf/fix.md +7 -7
- package/commands/sf/help.md +63 -63
- package/commands/sf/history.md +8 -8
- package/commands/sf/init.md +4 -4
- package/commands/sf/list.md +5 -5
- package/commands/sf/metrics.md +5 -5
- package/commands/sf/new.md +5 -5
- package/commands/sf/next.md +13 -13
- package/commands/sf/pause.md +2 -2
- package/commands/sf/plan.md +8 -8
- package/commands/sf/priority.md +2 -2
- package/commands/sf/resume.md +5 -5
- package/commands/sf/review.md +44 -13
- package/commands/sf/revise.md +6 -6
- package/commands/sf/run.md +5 -5
- package/commands/sf/scan.md +164 -0
- package/commands/sf/show.md +13 -13
- package/commands/sf/split.md +7 -7
- package/commands/sf/status.md +10 -10
- package/commands/sf/todo.md +5 -5
- package/commands/sf/todos.md +6 -6
- package/package.json +1 -1
- package/templates/audit.md +1 -1
- package/templates/scan.md +96 -0
- package/templates/spec.md +1 -1
- package/templates/state.md +1 -1
package/commands/sf/split.md
CHANGED
|
@@ -37,7 +37,7 @@ Analyze a specification's complexity and split it into smaller, manageable sub-s
|
|
|
37
37
|
```
|
|
38
38
|
SpecFlow not initialized.
|
|
39
39
|
|
|
40
|
-
Run `/sf
|
|
40
|
+
Run `/sf:init` first.
|
|
41
41
|
```
|
|
42
42
|
Exit.
|
|
43
43
|
|
|
@@ -52,7 +52,7 @@ Exit.
|
|
|
52
52
|
```
|
|
53
53
|
Specification {ID} not found.
|
|
54
54
|
|
|
55
|
-
Use `/sf
|
|
55
|
+
Use `/sf:list` to see available specifications.
|
|
56
56
|
```
|
|
57
57
|
Exit.
|
|
58
58
|
|
|
@@ -65,8 +65,8 @@ Read active specification from `.specflow/STATE.md`:
|
|
|
65
65
|
```
|
|
66
66
|
No specification specified and no active specification.
|
|
67
67
|
|
|
68
|
-
Usage: `/sf
|
|
69
|
-
or: Set active spec with `/sf
|
|
68
|
+
Usage: `/sf:split SPEC-001`
|
|
69
|
+
or: Set active spec with `/sf:show SPEC-001`
|
|
70
70
|
```
|
|
71
71
|
Exit.
|
|
72
72
|
|
|
@@ -88,7 +88,7 @@ Read the specification and assess complexity:
|
|
|
88
88
|
|
|
89
89
|
This specification is small enough to implement directly.
|
|
90
90
|
|
|
91
|
-
**Next Step:** `/sf
|
|
91
|
+
**Next Step:** `/sf:audit {ID}` — audit before implementation
|
|
92
92
|
```
|
|
93
93
|
Exit.
|
|
94
94
|
|
|
@@ -241,9 +241,9 @@ Exit.
|
|
|
241
241
|
|
|
242
242
|
## Next Step
|
|
243
243
|
|
|
244
|
-
`/sf
|
|
244
|
+
`/sf:audit {ID}a` — start with first sub-specification (no dependencies)
|
|
245
245
|
|
|
246
|
-
**Tip:** Use `/sf
|
|
246
|
+
**Tip:** Use `/sf:deps` to see the full dependency graph.
|
|
247
247
|
```
|
|
248
248
|
|
|
249
249
|
</workflow>
|
package/commands/sf/status.md
CHANGED
|
@@ -28,7 +28,7 @@ Display the current SpecFlow state including active specification, queue, and re
|
|
|
28
28
|
```
|
|
29
29
|
SpecFlow not initialized.
|
|
30
30
|
|
|
31
|
-
Run `/sf
|
|
31
|
+
Run `/sf:init` to start.
|
|
32
32
|
```
|
|
33
33
|
Exit.
|
|
34
34
|
|
|
@@ -67,12 +67,12 @@ Based on current status:
|
|
|
67
67
|
|
|
68
68
|
| Status | Next Action |
|
|
69
69
|
|--------|-------------|
|
|
70
|
-
| idle | `/sf
|
|
71
|
-
| drafting | `/sf
|
|
72
|
-
| revision_requested | `/sf
|
|
73
|
-
| audited | `/sf
|
|
74
|
-
| running | Continue implementation or `/sf
|
|
75
|
-
| reviewing | `/sf
|
|
70
|
+
| idle | `/sf:new "task"` — create specification |
|
|
71
|
+
| drafting | `/sf:audit` — audit specification |
|
|
72
|
+
| revision_requested | `/sf:revise` — fix issues |
|
|
73
|
+
| audited | `/sf:run` — implement |
|
|
74
|
+
| running | Continue implementation or `/sf:review` |
|
|
75
|
+
| reviewing | `/sf:fix` or `/sf:done` |
|
|
76
76
|
|
|
77
77
|
## Step 6: Display Status
|
|
78
78
|
|
|
@@ -138,17 +138,17 @@ Based on state, provide additional guidance:
|
|
|
138
138
|
|
|
139
139
|
**If idle for long time:**
|
|
140
140
|
```
|
|
141
|
-
**Tip:** Have ideas? Use `/sf
|
|
141
|
+
**Tip:** Have ideas? Use `/sf:todo "idea"` to capture for later.
|
|
142
142
|
```
|
|
143
143
|
|
|
144
144
|
**If spec is large:**
|
|
145
145
|
```
|
|
146
|
-
**Tip:** Consider `/sf
|
|
146
|
+
**Tip:** Consider `/sf:split SPEC-XXX` to break into smaller specs.
|
|
147
147
|
```
|
|
148
148
|
|
|
149
149
|
**If multiple specs in queue:**
|
|
150
150
|
```
|
|
151
|
-
**Tip:** Use `/sf
|
|
151
|
+
**Tip:** Use `/sf:next` to work on highest priority item.
|
|
152
152
|
```
|
|
153
153
|
|
|
154
154
|
**If warnings present:**
|
package/commands/sf/todo.md
CHANGED
|
@@ -9,7 +9,7 @@ allowed-tools:
|
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
<purpose>
|
|
12
|
-
Add a new to-do item to the backlog. To-dos are ideas or tasks that don't need immediate specification but should be captured for later. They can later be converted to specifications with `/sf
|
|
12
|
+
Add a new to-do item to the backlog. To-dos are ideas or tasks that don't need immediate specification but should be captured for later. They can later be converted to specifications with `/sf:plan`.
|
|
13
13
|
</purpose>
|
|
14
14
|
|
|
15
15
|
<context>
|
|
@@ -32,7 +32,7 @@ Add a new to-do item to the backlog. To-dos are ideas or tasks that don't need i
|
|
|
32
32
|
```
|
|
33
33
|
SpecFlow not initialized.
|
|
34
34
|
|
|
35
|
-
Run `/sf
|
|
35
|
+
Run `/sf:init` to start.
|
|
36
36
|
```
|
|
37
37
|
Exit.
|
|
38
38
|
|
|
@@ -111,9 +111,9 @@ Also update `*Last updated:` line at the bottom.
|
|
|
111
111
|
---
|
|
112
112
|
|
|
113
113
|
**Actions:**
|
|
114
|
-
- `/sf
|
|
115
|
-
- `/sf
|
|
116
|
-
- `/sf
|
|
114
|
+
- `/sf:todos` — view all to-do items
|
|
115
|
+
- `/sf:plan TODO-{XXX}` — convert to specification
|
|
116
|
+
- `/sf:priority` — set priorities
|
|
117
117
|
```
|
|
118
118
|
|
|
119
119
|
</workflow>
|
package/commands/sf/todos.md
CHANGED
|
@@ -26,7 +26,7 @@ Display all to-do items from the backlog, sorted by priority. Shows ID, descript
|
|
|
26
26
|
```
|
|
27
27
|
SpecFlow not initialized.
|
|
28
28
|
|
|
29
|
-
Run `/sf
|
|
29
|
+
Run `/sf:init` to start.
|
|
30
30
|
```
|
|
31
31
|
Exit.
|
|
32
32
|
|
|
@@ -45,7 +45,7 @@ Exit.
|
|
|
45
45
|
No to-do items found.
|
|
46
46
|
|
|
47
47
|
Add your first idea:
|
|
48
|
-
`/sf
|
|
48
|
+
`/sf:todo "your idea here"`
|
|
49
49
|
```
|
|
50
50
|
Exit.
|
|
51
51
|
|
|
@@ -100,10 +100,10 @@ Within same priority, sort by date (oldest first).
|
|
|
100
100
|
---
|
|
101
101
|
|
|
102
102
|
**Actions:**
|
|
103
|
-
- `/sf
|
|
104
|
-
- `/sf
|
|
105
|
-
- `/sf
|
|
106
|
-
- `/sf
|
|
103
|
+
- `/sf:plan 1` — convert first item to specification
|
|
104
|
+
- `/sf:plan TODO-001` — convert by ID
|
|
105
|
+
- `/sf:priority` — change priorities
|
|
106
|
+
- `/sf:todo "new idea"` — add new item
|
|
107
107
|
```
|
|
108
108
|
|
|
109
109
|
## Step 7: Show Notes (if any have notes)
|
package/package.json
CHANGED
package/templates/audit.md
CHANGED
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# Codebase Scan Report
|
|
2
|
+
|
|
3
|
+
**Date:** [YYYY-MM-DD]
|
|
4
|
+
**Focus:** [all | concerns | quality | arch]
|
|
5
|
+
|
|
6
|
+
## Executive Summary
|
|
7
|
+
|
|
8
|
+
[2-3 sentence overview of codebase health and key findings]
|
|
9
|
+
|
|
10
|
+
**Health Score:** [Good | Moderate | Needs Attention | Critical]
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## Tech Debt
|
|
15
|
+
|
|
16
|
+
### High Priority
|
|
17
|
+
|
|
18
|
+
**[Issue Title]**
|
|
19
|
+
- Files: `[file/path.ts]`
|
|
20
|
+
- Problem: [What's wrong]
|
|
21
|
+
- Impact: [Why it matters]
|
|
22
|
+
- Fix: [How to address]
|
|
23
|
+
|
|
24
|
+
### Medium Priority
|
|
25
|
+
|
|
26
|
+
<!-- Add issues here -->
|
|
27
|
+
|
|
28
|
+
### Low Priority
|
|
29
|
+
|
|
30
|
+
<!-- Add issues here -->
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Code Quality Issues
|
|
35
|
+
|
|
36
|
+
### Type Safety
|
|
37
|
+
|
|
38
|
+
**[Issue]**
|
|
39
|
+
- Files: `[paths]`
|
|
40
|
+
- Count: [N occurrences]
|
|
41
|
+
- Fix: [Approach]
|
|
42
|
+
|
|
43
|
+
### Error Handling
|
|
44
|
+
|
|
45
|
+
<!-- Swallowed errors, missing catches, etc. -->
|
|
46
|
+
|
|
47
|
+
### Code Duplication
|
|
48
|
+
|
|
49
|
+
<!-- Similar code patterns that should be abstracted -->
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Security Considerations
|
|
54
|
+
|
|
55
|
+
**[Risk Area]**
|
|
56
|
+
- Files: `[paths]`
|
|
57
|
+
- Risk: [What could happen]
|
|
58
|
+
- Severity: [Critical | High | Medium | Low]
|
|
59
|
+
- Mitigation: [What to do]
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## Test Coverage Gaps
|
|
64
|
+
|
|
65
|
+
**[Untested Area]**
|
|
66
|
+
- Files: `[paths]`
|
|
67
|
+
- What's missing: [Description]
|
|
68
|
+
- Priority: [High | Medium | Low]
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## Architecture Observations
|
|
73
|
+
|
|
74
|
+
**[Observation]**
|
|
75
|
+
- Current: [How it is]
|
|
76
|
+
- Concern: [Why it's problematic]
|
|
77
|
+
- Suggestion: [Improvement]
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## Suggested Specifications
|
|
82
|
+
|
|
83
|
+
Based on this scan, consider creating specs for:
|
|
84
|
+
|
|
85
|
+
1. **[Spec title]** — [brief description]
|
|
86
|
+
- Priority: high | medium | low
|
|
87
|
+
- Complexity: small | medium | large
|
|
88
|
+
- Command: `/sf:new "[title]"`
|
|
89
|
+
|
|
90
|
+
2. **[Spec title]** — [brief description]
|
|
91
|
+
- Priority: ...
|
|
92
|
+
- Complexity: ...
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
*Scan completed: [timestamp]*
|
package/templates/spec.md
CHANGED
package/templates/state.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
- **Active Specification:** [none | SPEC-XXX]
|
|
6
6
|
- **Status:** [idle | drafting | auditing | running | reviewing]
|
|
7
|
-
- **Next Step:** [/sf
|
|
7
|
+
- **Next Step:** [/sf:new | /sf:audit | /sf:run | /sf:review | /sf:done]
|
|
8
8
|
|
|
9
9
|
## Queue
|
|
10
10
|
|