bigpowers 2.74.2 → 2.74.4

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.
Files changed (56) hide show
  1. package/.pi/package.json +1 -1
  2. package/.pi/prompts/audit-code.md +5 -0
  3. package/.pi/prompts/deepen-architecture.md +4 -0
  4. package/.pi/prompts/develop-tdd.md +3 -0
  5. package/.pi/prompts/execute-plan.md +6 -0
  6. package/.pi/prompts/grill-with-docs.md +3 -0
  7. package/.pi/prompts/guard-git.md +4 -0
  8. package/.pi/prompts/model-domain.md +4 -0
  9. package/.pi/prompts/orchestrate-project.md +4 -0
  10. package/.pi/prompts/organize-workspace.md +4 -0
  11. package/.pi/prompts/plan-work.md +6 -0
  12. package/.pi/prompts/run-evals.md +3 -0
  13. package/.pi/prompts/session-state.md +4 -0
  14. package/.pi/prompts/slice-tasks.md +3 -0
  15. package/.pi/prompts/survey-context.md +3 -0
  16. package/.pi/prompts/terse-mode.md +4 -0
  17. package/.pi/prompts/using-bigpowers.md +4 -0
  18. package/.pi/skills/audit-code/SKILL.md +5 -0
  19. package/.pi/skills/deepen-architecture/SKILL.md +4 -0
  20. package/.pi/skills/develop-tdd/SKILL.md +3 -0
  21. package/.pi/skills/execute-plan/SKILL.md +6 -0
  22. package/.pi/skills/grill-with-docs/SKILL.md +3 -0
  23. package/.pi/skills/guard-git/SKILL.md +4 -0
  24. package/.pi/skills/model-domain/SKILL.md +4 -0
  25. package/.pi/skills/orchestrate-project/SKILL.md +4 -0
  26. package/.pi/skills/organize-workspace/SKILL.md +4 -0
  27. package/.pi/skills/plan-work/SKILL.md +6 -0
  28. package/.pi/skills/run-evals/SKILL.md +3 -0
  29. package/.pi/skills/session-state/SKILL.md +4 -0
  30. package/.pi/skills/slice-tasks/SKILL.md +3 -0
  31. package/.pi/skills/survey-context/SKILL.md +3 -0
  32. package/.pi/skills/terse-mode/SKILL.md +4 -0
  33. package/.pi/skills/using-bigpowers/SKILL.md +4 -0
  34. package/CHANGELOG.md +14 -0
  35. package/package.json +1 -1
  36. package/profiles/node-service.md +3 -0
  37. package/profiles/solo-git.md +3 -0
  38. package/profiles/swift.md +3 -0
  39. package/profiles/typescript-vue.md +3 -0
  40. package/skills/audit-code/SKILL.md +5 -0
  41. package/skills/deepen-architecture/SKILL.md +3 -0
  42. package/skills/develop-tdd/SKILL.md +3 -0
  43. package/skills/execute-plan/SKILL.md +5 -0
  44. package/skills/grill-with-docs/SKILL.md +3 -0
  45. package/skills/guard-git/SKILL.md +3 -0
  46. package/skills/model-domain/SKILL.md +3 -0
  47. package/skills/orchestrate-project/SKILL.md +3 -0
  48. package/skills/organize-workspace/SKILL.md +3 -0
  49. package/skills/plan-work/SKILL.md +6 -0
  50. package/skills/run-evals/SKILL.md +3 -0
  51. package/skills/session-state/SKILL.md +4 -0
  52. package/skills/slice-tasks/SKILL.md +3 -0
  53. package/skills/survey-context/SKILL.md +3 -0
  54. package/skills/terse-mode/SKILL.md +3 -0
  55. package/skills/using-bigpowers/SKILL.md +3 -0
  56. package/skills-lock.json +16 -16
package/.pi/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bigpowers",
3
- "version": "2.74.2",
3
+ "version": "2.74.4",
4
4
  "description": "77 skills — 73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
5
5
  "keywords": [
6
6
  "pi-package"
@@ -134,6 +134,11 @@ In `--gate` mode, print one summary line per checklist section (`PASS Supply Cha
134
134
  Gate: READY -> next: commit-message
135
135
  Writes: state.yaml handoff.next_skill = commit-message
136
136
 
137
+
138
+ <!-- story: e01s02 -->
139
+ <!-- story: e06s03 -->
140
+ <!-- story: e07s01 -->
141
+
137
142
  ---
138
143
 
139
144
  # Clean Code Heuristics (Chapter 17)
@@ -111,6 +111,10 @@ Run the check before proposing cross-module `source` edges. Convention docs alon
111
111
 
112
112
  → verify: `test -f specs/import-boundaries.json && bash scripts/check-import-boundaries.sh && echo OK || echo FAIL`
113
113
 
114
+
115
+
116
+ <!-- story: e07s02 -->
117
+
114
118
  ---
115
119
 
116
120
  # Deepening
@@ -118,6 +118,9 @@ Writes: state.yaml handoff.next_skill = verify-work
118
118
 
119
119
  At story completion, if the story was sized with BCP Plus (13-dimension breakdown), log the `bcp_plus.total` alongside the standard `bcps:` count in the story's tasks.yaml. The breakdown is available from the epic capsule's `bcp_plus_breakdown` field. See `docs/references/bcp-plus.md` for the full methodology and NFR Gate pattern.
120
120
 
121
+
122
+ <!-- story: e02s04 -->
123
+
121
124
  ---
122
125
 
123
126
  # Develop TDD — Reference
@@ -52,3 +52,9 @@ Suggest: `verify-work` → `run-evals` → `audit-code` → `simulate-agents`
52
52
  ## Rules
53
53
 
54
54
  - **Loop until behavioral correctness is verified**: if a verify command passes but the observed behavior is still wrong, return to step 1 and run the execution cycle again.
55
+
56
+
57
+
58
+ <!-- story: e02s03 -->
59
+ <!-- story: e05s02 -->
60
+ <!-- story: e08s01 -->
@@ -28,6 +28,9 @@ description: Doc-grounded variant of grill-me — stress-tests plan assumptions
28
28
 
29
29
  See [REFERENCE.md](REFERENCE.md) for question templates.
30
30
 
31
+
32
+ <!-- story: e03s01 -->
33
+
31
34
  ---
32
35
 
33
36
  # Grill With Docs — Question templates
@@ -42,6 +42,10 @@ To add or remove patterns or protected branches, edit `pre-tool-use.sh`.
42
42
 
43
43
  Full JSON examples, merge rules, Antigravity deny-list entries, and test commands: [REFERENCE.md](REFERENCE.md).
44
44
 
45
+
46
+
47
+ <!-- story: e01s03 -->
48
+
45
49
  ---
46
50
 
47
51
  # Git guardrails — reference
@@ -96,6 +96,10 @@ When the plan touches shared state, async, or multi-threaded code:
96
96
  - [ ] Flag **race risks** (check-then-act, non-atomic read-modify-write) with severity.
97
97
  - [ ] Record findings in `specs/tech-architecture/tech-stack.md` under `## Concurrency` or in an ADR if architectural.
98
98
 
99
+
100
+
101
+ <!-- story: e07s03 -->
102
+
99
103
  ---
100
104
 
101
105
  # ADR Format
@@ -66,6 +66,10 @@ All phases complete with artifacts:
66
66
  verify: test -f specs/state.yaml && test -f specs/release-plan.yaml && test -f specs/product/SCOPE_LATEST.yaml && ls specs/epics/*.yaml 1>/dev/null && echo "✅ All phases complete"
67
67
  ```
68
68
 
69
+
70
+
71
+ <!-- story: e05s03 -->
72
+
69
73
  ---
70
74
 
71
75
  # Orchestrate Reference: Phases, Modes, and Workflows
@@ -75,6 +75,10 @@ Do this when the repo is under Git and the cleanup surfaced **untracked** noise:
75
75
 
76
76
  See [REFERENCE.md](REFERENCE.md) for shell patterns, `.gitignore` mechanics, and safety checks.
77
77
 
78
+
79
+
80
+ <!-- story: e04s03 -->
81
+
78
82
  ---
79
83
 
80
84
  # clean-my-room — reference patterns
@@ -92,6 +92,12 @@ After writing capsule tasks, suggest `kickoff-branch` (if not already on a featu
92
92
  Gate: READY -> next: kickoff-branch
93
93
  Writes: state.yaml handoff.next_skill = kickoff-branch
94
94
 
95
+
96
+ <!-- story: e01s01 -->
97
+ <!-- story: e02s02 -->
98
+ <!-- story: e06s01 -->
99
+ <!-- story: e06s02 -->
100
+
95
101
  ---
96
102
 
97
103
  # Plan Work — Reference
@@ -35,6 +35,9 @@ description: Eval-Driven Development — define capability and regression evals
35
35
 
36
36
  → verify: `find specs/verifications -name "*-eval-report.md" | wc -l | awk '{if($1>0) print "OK: "$1" eval reports"; else print "MISSING"}'`
37
37
 
38
+
39
+ <!-- story: e02s01 -->
40
+
38
41
  ---
39
42
 
40
43
  # Run Evals — Reference
@@ -139,3 +139,7 @@ handoff:
139
139
  - **Duplicate Plan**: Don't copy `release-plan.yaml` or epic shards into `state.yaml`.
140
140
  - **Stale State**: Forgetting to update `state.yaml` after a major refactor or decision.
141
141
  - **Status in release-plan**: Story/epic status lives only in `execution-status.yaml`.
142
+
143
+
144
+ <!-- story: e03s03 -->
145
+ <!-- story: e04s01 -->
@@ -62,3 +62,6 @@ Produce **epic capsule story tasks** in `specs/epics/eNN-slug/` — vertical sli
62
62
  ## Verify
63
63
 
64
64
  → verify: `find specs/epics -name "*-tasks.yaml" | wc -l | awk '{if($1>0) print "OK: "$1" task files"; else print "MISSING"}'`
65
+
66
+
67
+ <!-- story: e03s01 -->
@@ -129,3 +129,6 @@ Print the current `active_flow` from `specs/state.yaml`, run `bash scripts/valid
129
129
 
130
130
  Gate: READY -> next: plan-work
131
131
  Writes: state.yaml handoff.next_skill = plan-work
132
+
133
+
134
+ <!-- story: e03s03 -->
@@ -35,3 +35,7 @@ Example — destructive op:
35
35
  > ```
36
36
  >
37
37
  > Terse resume. Verify backup exist first.
38
+
39
+
40
+
41
+ <!-- story: e04s02 -->
@@ -104,3 +104,7 @@ Start the HTTP dashboard with `visual-dashboard` → `GET /api/status?projectDir
104
104
  ## After this
105
105
 
106
106
  Call `survey-context` to read your project's current state and get a personalized recommendation for where to go next.
107
+
108
+
109
+
110
+ <!-- story: e03s02 -->
@@ -136,6 +136,11 @@ In `--gate` mode, print one summary line per checklist section (`PASS Supply Cha
136
136
  Gate: READY -> next: commit-message
137
137
  Writes: state.yaml handoff.next_skill = commit-message
138
138
 
139
+
140
+ <!-- story: e01s02 -->
141
+ <!-- story: e06s03 -->
142
+ <!-- story: e07s01 -->
143
+
139
144
  ---
140
145
 
141
146
  # Clean Code Heuristics (Chapter 17)
@@ -113,6 +113,10 @@ Run the check before proposing cross-module `source` edges. Convention docs alon
113
113
 
114
114
  → verify: `test -f specs/import-boundaries.json && bash scripts/check-import-boundaries.sh && echo OK || echo FAIL`
115
115
 
116
+
117
+
118
+ <!-- story: e07s02 -->
119
+
116
120
  ---
117
121
 
118
122
  # Deepening
@@ -120,6 +120,9 @@ Writes: state.yaml handoff.next_skill = verify-work
120
120
 
121
121
  At story completion, if the story was sized with BCP Plus (13-dimension breakdown), log the `bcp_plus.total` alongside the standard `bcps:` count in the story's tasks.yaml. The breakdown is available from the epic capsule's `bcp_plus_breakdown` field. See `docs/references/bcp-plus.md` for the full methodology and NFR Gate pattern.
122
122
 
123
+
124
+ <!-- story: e02s04 -->
125
+
123
126
  ---
124
127
 
125
128
  # Develop TDD — Reference
@@ -54,3 +54,9 @@ Suggest: `verify-work` → `run-evals` → `audit-code` → `simulate-agents`
54
54
  ## Rules
55
55
 
56
56
  - **Loop until behavioral correctness is verified**: if a verify command passes but the observed behavior is still wrong, return to step 1 and run the execution cycle again.
57
+
58
+
59
+
60
+ <!-- story: e02s03 -->
61
+ <!-- story: e05s02 -->
62
+ <!-- story: e08s01 -->
@@ -30,6 +30,9 @@ model: opus
30
30
 
31
31
  See [REFERENCE.md](REFERENCE.md) for question templates.
32
32
 
33
+
34
+ <!-- story: e03s01 -->
35
+
33
36
  ---
34
37
 
35
38
  # Grill With Docs — Question templates
@@ -44,6 +44,10 @@ To add or remove patterns or protected branches, edit `pre-tool-use.sh`.
44
44
 
45
45
  Full JSON examples, merge rules, Antigravity deny-list entries, and test commands: [REFERENCE.md](REFERENCE.md).
46
46
 
47
+
48
+
49
+ <!-- story: e01s03 -->
50
+
47
51
  ---
48
52
 
49
53
  # Git guardrails — reference
@@ -98,6 +98,10 @@ When the plan touches shared state, async, or multi-threaded code:
98
98
  - [ ] Flag **race risks** (check-then-act, non-atomic read-modify-write) with severity.
99
99
  - [ ] Record findings in `specs/tech-architecture/tech-stack.md` under `## Concurrency` or in an ADR if architectural.
100
100
 
101
+
102
+
103
+ <!-- story: e07s03 -->
104
+
101
105
  ---
102
106
 
103
107
  # ADR Format
@@ -68,6 +68,10 @@ All phases complete with artifacts:
68
68
  verify: test -f specs/state.yaml && test -f specs/release-plan.yaml && test -f specs/product/SCOPE_LATEST.yaml && ls specs/epics/*.yaml 1>/dev/null && echo "✅ All phases complete"
69
69
  ```
70
70
 
71
+
72
+
73
+ <!-- story: e05s03 -->
74
+
71
75
  ---
72
76
 
73
77
  # Orchestrate Reference: Phases, Modes, and Workflows
@@ -77,6 +77,10 @@ Do this when the repo is under Git and the cleanup surfaced **untracked** noise:
77
77
 
78
78
  See [REFERENCE.md](REFERENCE.md) for shell patterns, `.gitignore` mechanics, and safety checks.
79
79
 
80
+
81
+
82
+ <!-- story: e04s03 -->
83
+
80
84
  ---
81
85
 
82
86
  # clean-my-room — reference patterns
@@ -94,6 +94,12 @@ After writing capsule tasks, suggest `kickoff-branch` (if not already on a featu
94
94
  Gate: READY -> next: kickoff-branch
95
95
  Writes: state.yaml handoff.next_skill = kickoff-branch
96
96
 
97
+
98
+ <!-- story: e01s01 -->
99
+ <!-- story: e02s02 -->
100
+ <!-- story: e06s01 -->
101
+ <!-- story: e06s02 -->
102
+
97
103
  ---
98
104
 
99
105
  # Plan Work — Reference
@@ -37,6 +37,9 @@ model: sonnet
37
37
 
38
38
  → verify: `find specs/verifications -name "*-eval-report.md" | wc -l | awk '{if($1>0) print "OK: "$1" eval reports"; else print "MISSING"}'`
39
39
 
40
+
41
+ <!-- story: e02s01 -->
42
+
40
43
  ---
41
44
 
42
45
  # Run Evals — Reference
@@ -141,3 +141,7 @@ handoff:
141
141
  - **Duplicate Plan**: Don't copy `release-plan.yaml` or epic shards into `state.yaml`.
142
142
  - **Stale State**: Forgetting to update `state.yaml` after a major refactor or decision.
143
143
  - **Status in release-plan**: Story/epic status lives only in `execution-status.yaml`.
144
+
145
+
146
+ <!-- story: e03s03 -->
147
+ <!-- story: e04s01 -->
@@ -64,3 +64,6 @@ Produce **epic capsule story tasks** in `specs/epics/eNN-slug/` — vertical sli
64
64
  ## Verify
65
65
 
66
66
  → verify: `find specs/epics -name "*-tasks.yaml" | wc -l | awk '{if($1>0) print "OK: "$1" task files"; else print "MISSING"}'`
67
+
68
+
69
+ <!-- story: e03s01 -->
@@ -131,3 +131,6 @@ Print the current `active_flow` from `specs/state.yaml`, run `bash scripts/valid
131
131
 
132
132
  Gate: READY -> next: plan-work
133
133
  Writes: state.yaml handoff.next_skill = plan-work
134
+
135
+
136
+ <!-- story: e03s03 -->
@@ -37,3 +37,7 @@ Example — destructive op:
37
37
  > ```
38
38
  >
39
39
  > Terse resume. Verify backup exist first.
40
+
41
+
42
+
43
+ <!-- story: e04s02 -->
@@ -106,3 +106,7 @@ Start the HTTP dashboard with `visual-dashboard` → `GET /api/status?projectDir
106
106
  ## After this
107
107
 
108
108
  Call `survey-context` to read your project's current state and get a personalized recommendation for where to go next.
109
+
110
+
111
+
112
+ <!-- story: e03s02 -->
package/CHANGELOG.md CHANGED
@@ -1,3 +1,17 @@
1
+ ## [2.74.4](https://github.com/danielvm-git/bigpowers/compare/v2.74.3...v2.74.4) (2026-07-07)
2
+
3
+
4
+ ### Bug Fixes
5
+
6
+ * **sync-skills:** regenerate artifacts after story tag backfill ([35a0455](https://github.com/danielvm-git/bigpowers/commit/35a04555a3067ff3820580c2f08d3d2c071bfd87))
7
+
8
+ ## [2.74.3](https://github.com/danielvm-git/bigpowers/compare/v2.74.2...v2.74.3) (2026-07-07)
9
+
10
+
11
+ ### Bug Fixes
12
+
13
+ * **traceability:** backfill story tags for e01 e02 e03 e04 e05 e06 e07 e08 e10 ([2926f8f](https://github.com/danielvm-git/bigpowers/commit/2926f8f49304fa28f09e8eb0c2b63f1c405c4d94))
14
+
1
15
  ## [2.74.2](https://github.com/danielvm-git/bigpowers/compare/v2.74.1...v2.74.2) (2026-07-07)
2
16
 
3
17
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bigpowers",
3
- "version": "2.74.2",
3
+ "version": "2.74.4",
4
4
  "description": "73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
5
5
  "main": "index.js",
6
6
  "scripts": {
@@ -26,3 +26,6 @@ Opt-in conventions fragment for `seed-conventions`.
26
26
 
27
27
  - Never log secrets or full auth tokens
28
28
  - Never use `any` on public API types
29
+
30
+
31
+ <!-- story: e10s01 -->
@@ -37,3 +37,6 @@ Run `compose-workflow` or copy `specs/WORKFLOW-solo-git.md` and note in `specs/S
37
37
  - Never land without `release-branch` §1–3 gates (tests, coverage, diff review)
38
38
  - Never commit on `main` outside `land-branch.sh`
39
39
  - Never skip `kickoff-branch` for feature work
40
+
41
+
42
+ <!-- story: e10s01 -->
package/profiles/swift.md CHANGED
@@ -25,3 +25,6 @@ Opt-in conventions fragment for `seed-conventions`. Core bigpowers skills stay l
25
25
 
26
26
  - Never force-unwrap (`!`) in production paths without documented invariant
27
27
  - Never commit `DerivedData/` or `.build/`
28
+
29
+
30
+ <!-- story: e10s01 -->
@@ -26,3 +26,6 @@ Opt-in conventions fragment for `seed-conventions`.
26
26
 
27
27
  - Never use Options API for new components unless extending legacy
28
28
  - Never commit `dist/`, `node_modules/`, `.env`
29
+
30
+
31
+ <!-- story: e10s01 -->
@@ -138,3 +138,8 @@ In `--gate` mode, print one summary line per checklist section (`PASS Supply Cha
138
138
 
139
139
  Gate: READY -> next: commit-message
140
140
  Writes: state.yaml handoff.next_skill = commit-message
141
+
142
+
143
+ <!-- story: e01s02 -->
144
+ <!-- story: e06s03 -->
145
+ <!-- story: e07s01 -->
@@ -115,3 +115,6 @@ Run the check before proposing cross-module `source` edges. Convention docs alon
115
115
 
116
116
  → verify: `test -f specs/import-boundaries.json && bash scripts/check-import-boundaries.sh && echo OK || echo FAIL`
117
117
 
118
+
119
+
120
+ <!-- story: e07s02 -->
@@ -123,3 +123,6 @@ Writes: state.yaml handoff.next_skill = verify-work
123
123
  ## BCP Plus Integration
124
124
 
125
125
  At story completion, if the story was sized with BCP Plus (13-dimension breakdown), log the `bcp_plus.total` alongside the standard `bcps:` count in the story's tasks.yaml. The breakdown is available from the epic capsule's `bcp_plus_breakdown` field. See `docs/references/bcp-plus.md` for the full methodology and NFR Gate pattern.
126
+
127
+
128
+ <!-- story: e02s04 -->
@@ -55,3 +55,8 @@ Suggest: `verify-work` → `run-evals` → `audit-code` → `simulate-agents`
55
55
 
56
56
  - **Loop until behavioral correctness is verified**: if a verify command passes but the observed behavior is still wrong, return to step 1 and run the execution cycle again.
57
57
 
58
+
59
+
60
+ <!-- story: e02s03 -->
61
+ <!-- story: e05s02 -->
62
+ <!-- story: e08s01 -->
@@ -29,3 +29,6 @@ effort: standard
29
29
  → verify: `grep -c 'https\?://' skills/grill-with-docs/SKILL.md | awk '{if($1>=2) print "OK"; else print "NEEDS DOCS"}'`
30
30
 
31
31
  See [REFERENCE.md](REFERENCE.md) for question templates.
32
+
33
+
34
+ <!-- story: e03s01 -->
@@ -44,3 +44,6 @@ To add or remove patterns or protected branches, edit `pre-tool-use.sh`.
44
44
 
45
45
  Full JSON examples, merge rules, Antigravity deny-list entries, and test commands: [REFERENCE.md](REFERENCE.md).
46
46
 
47
+
48
+
49
+ <!-- story: e01s03 -->
@@ -98,3 +98,6 @@ When the plan touches shared state, async, or multi-threaded code:
98
98
  - [ ] Flag **race risks** (check-then-act, non-atomic read-modify-write) with severity.
99
99
  - [ ] Record findings in `specs/tech-architecture/tech-stack.md` under `## Concurrency` or in an ADR if architectural.
100
100
 
101
+
102
+
103
+ <!-- story: e07s03 -->
@@ -68,3 +68,6 @@ All phases complete with artifacts:
68
68
  verify: test -f specs/state.yaml && test -f specs/release-plan.yaml && test -f specs/product/SCOPE_LATEST.yaml && ls specs/epics/*.yaml 1>/dev/null && echo "✅ All phases complete"
69
69
  ```
70
70
 
71
+
72
+
73
+ <!-- story: e05s03 -->
@@ -77,3 +77,6 @@ Do this when the repo is under Git and the cleanup surfaced **untracked** noise:
77
77
 
78
78
  See [REFERENCE.md](REFERENCE.md) for shell patterns, `.gitignore` mechanics, and safety checks.
79
79
 
80
+
81
+
82
+ <!-- story: e04s03 -->
@@ -98,3 +98,9 @@ After writing capsule tasks, suggest `kickoff-branch` (if not already on a featu
98
98
 
99
99
  Gate: READY -> next: kickoff-branch
100
100
  Writes: state.yaml handoff.next_skill = kickoff-branch
101
+
102
+
103
+ <!-- story: e01s01 -->
104
+ <!-- story: e02s02 -->
105
+ <!-- story: e06s01 -->
106
+ <!-- story: e06s02 -->
@@ -37,3 +37,6 @@ effort: standard
37
37
  ## Verify
38
38
 
39
39
  → verify: `find specs/verifications -name "*-eval-report.md" | wc -l | awk '{if($1>0) print "OK: "$1" eval reports"; else print "MISSING"}'`
40
+
41
+
42
+ <!-- story: e02s01 -->
@@ -141,3 +141,7 @@ handoff:
141
141
  - **Duplicate Plan**: Don't copy `release-plan.yaml` or epic shards into `state.yaml`.
142
142
  - **Stale State**: Forgetting to update `state.yaml` after a major refactor or decision.
143
143
  - **Status in release-plan**: Story/epic status lives only in `execution-status.yaml`.
144
+
145
+
146
+ <!-- story: e03s03 -->
147
+ <!-- story: e04s01 -->
@@ -64,3 +64,6 @@ Produce **epic capsule story tasks** in `specs/epics/eNN-slug/` — vertical sli
64
64
  ## Verify
65
65
 
66
66
  → verify: `find specs/epics -name "*-tasks.yaml" | wc -l | awk '{if($1>0) print "OK: "$1" task files"; else print "MISSING"}'`
67
+
68
+
69
+ <!-- story: e03s01 -->
@@ -131,3 +131,6 @@ Print the current `active_flow` from `specs/state.yaml`, run `bash scripts/valid
131
131
 
132
132
  Gate: READY -> next: plan-work
133
133
  Writes: state.yaml handoff.next_skill = plan-work
134
+
135
+
136
+ <!-- story: e03s03 -->
@@ -38,3 +38,6 @@ Example — destructive op:
38
38
  >
39
39
  > Terse resume. Verify backup exist first.
40
40
 
41
+
42
+
43
+ <!-- story: e04s02 -->
@@ -107,3 +107,6 @@ Start the HTTP dashboard with `visual-dashboard` → `GET /api/status?projectDir
107
107
 
108
108
  Call `survey-context` to read your project's current state and get a personalized recommendation for where to go next.
109
109
 
110
+
111
+
112
+ <!-- story: e03s02 -->
package/skills-lock.json CHANGED
@@ -13,7 +13,7 @@
13
13
  },
14
14
  "audit-code": {
15
15
  "description": "Self-review checklist for the coding agent to run before dispatching a reviewer. Checks CONVENTIONS.md compliance, Boy Scout Rule, test coverage, types, and SOLID. Produces a pass/fail checklist. Use before request-review, before committing, or when user asks for a code quality check.",
16
- "sha256": "b4d70ad39eca5902",
16
+ "sha256": "bbb128254464f8f4",
17
17
  "path": "skills/audit-codeSKILL.md"
18
18
  },
19
19
  "audit-plan": {
@@ -53,7 +53,7 @@
53
53
  },
54
54
  "deepen-architecture": {
55
55
  "description": "Find deepening opportunities in a codebase, informed by the domain language in specs/tech-architecture/tech-stack.md and the decisions in specs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.",
56
- "sha256": "591441a980d0447c",
56
+ "sha256": "a31de1fbd4800060",
57
57
  "path": "skills/deepen-architectureSKILL.md"
58
58
  },
59
59
  "define-language": {
@@ -83,7 +83,7 @@
83
83
  },
84
84
  "develop-tdd": {
85
85
  "description": "Test-driven development with red-green-refactor loop using vertical slices. Use for features (epic tasks) or bugs (specs/bugs/BUG-*.md).",
86
- "sha256": "1989004e232bb4be",
86
+ "sha256": "91928da1d9757094",
87
87
  "path": "skills/develop-tddSKILL.md"
88
88
  },
89
89
  "diagnose-root": {
@@ -123,7 +123,7 @@
123
123
  },
124
124
  "execute-plan": {
125
125
  "description": "Batch-execute tasks from the active epic capsule sequentially, with a human checkpoint after each step. Use when user has an approved plan and wants step-by-step oversight.",
126
- "sha256": "259833a91f470ac3",
126
+ "sha256": "9d6d2bf18e58dafd",
127
127
  "path": "skills/execute-planSKILL.md"
128
128
  },
129
129
  "extract-design": {
@@ -148,12 +148,12 @@
148
148
  },
149
149
  "grill-with-docs": {
150
150
  "description": "Doc-grounded variant of grill-me — stress-tests plan assumptions by fetching and citing real library or API documentation. Every challenge must cite a real URL. Use when the plan depends on a specific library or external API.",
151
- "sha256": "e78bea0ebcd9ae9b",
151
+ "sha256": "bd4267952e492f9c",
152
152
  "path": "skills/grill-with-docsSKILL.md"
153
153
  },
154
154
  "guard-git": {
155
155
  "description": "Block dangerous git commands (push, force push, reset --hard, clean, branch -D, checkout/restore .) and enforce Conventional Commits & Branch Protection before an AI agent runs them. Installs hook scripts for Claude Code, Cursor, Cursor CLI, and Gemini CLI; documents Google Antigravity Terminal deny lists. Use when the user wants git safety hooks, to block git push or destructive git in agents, or to mirror the same policy across AI coding tools.",
156
- "sha256": "1386000c275dc9ef",
156
+ "sha256": "9ee881df89273b00",
157
157
  "path": "skills/guard-gitSKILL.md"
158
158
  },
159
159
  "hook-commits": {
@@ -193,17 +193,17 @@
193
193
  },
194
194
  "model-domain": {
195
195
  "description": "Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates specs/tech-architecture/tech-stack.md and specs/adr/ inline as decisions crystallise. Use when user wants to stress-test a plan against their project's domain language and documented decisions.",
196
- "sha256": "982bf9996a89183e",
196
+ "sha256": "857d86ccd37236eb",
197
197
  "path": "skills/model-domainSKILL.md"
198
198
  },
199
199
  "orchestrate-project": {
200
200
  "description": "Meta-skill that enforces the 6-phase core loop (discover → elaborate → plan → build → verify → release) with hard gates. Use to coordinate multi-phase projects with guaranteed quality checkpoints. One-time command for the entire project lifecycle.",
201
- "sha256": "4e53cd83ac296735",
201
+ "sha256": "e38e21bb3ad47734",
202
202
  "path": "skills/orchestrate-projectSKILL.md"
203
203
  },
204
204
  "organize-workspace": {
205
205
  "description": "Scans the active workspace for disposable artifacts—logs, caches, stale build output, and stray draft markdown—and proposes consolidation of scattered assets. Produces a reviewable list, asks for explicit confirmation before any delete or move, and optionally revises .gitignore. Use when the user says \"clean my room\", \"organize workspace\", \"workspace cleanup\", \"remove temp files\", \"organize assets\", \"gitignore\", or wants a safe tidy pass.",
206
- "sha256": "d98b8d6312d94a20",
206
+ "sha256": "8295d674c2cd461e",
207
207
  "path": "skills/organize-workspaceSKILL.md"
208
208
  },
209
209
  "plan-refactor": {
@@ -223,7 +223,7 @@
223
223
  },
224
224
  "plan-work": {
225
225
  "description": "\"PLANNING SPINE STEP 3 of 3 — Plan the work: write detailed implementation tasks into the active epic capsule (specs/epics/eNN-slug/). Produces countable-story-format .md specs and runnable -tasks.yaml files. Use after slice-tasks (step 2). Not a substitute for scope-work (step 1) or slice-tasks (step 2).\"",
226
- "sha256": "4cc87b8c2ae13dae",
226
+ "sha256": "aabc7f15b46525c2",
227
227
  "path": "skills/plan-workSKILL.md"
228
228
  },
229
229
  "publish-package": {
@@ -268,7 +268,7 @@
268
268
  },
269
269
  "run-evals": {
270
270
  "description": "Eval-Driven Development — define capability and regression evals before building; code graders use verify commands, model graders use explicit rubrics; log pass@k. Use before develop-tdd on new features, or when measuring agent capability over runs.",
271
- "sha256": "2fd60cbf4a4e1c63",
271
+ "sha256": "928eb6bcc1176a40",
272
272
  "path": "skills/run-evalsSKILL.md"
273
273
  },
274
274
  "run-planning": {
@@ -298,7 +298,7 @@
298
298
  },
299
299
  "session-state": {
300
300
  "description": "Track implementation decisions and progress in specs/state.yaml to prevent context rot. Use at the start of a session to load context, and whenever a significant decision is made or a milestone is reached.",
301
- "sha256": "4b607fee350390c6",
301
+ "sha256": "943075be867cd50e",
302
302
  "path": "skills/session-stateSKILL.md"
303
303
  },
304
304
  "setup-environment": {
@@ -313,7 +313,7 @@
313
313
  },
314
314
  "slice-tasks": {
315
315
  "description": "\"PLANNING SPINE STEP 2 of 3 — Slice the work: break a scoped PRD into vertical-slice stories in specs/epics/. Use after scope-work (step 1), before plan-work (step 3). Not a substitute for scope-work or plan-work.\"",
316
- "sha256": "b89b61159fc619e5",
316
+ "sha256": "b60f861b88387e4d",
317
317
  "path": "skills/slice-tasksSKILL.md"
318
318
  },
319
319
  "smoke-test": {
@@ -333,12 +333,12 @@
333
333
  },
334
334
  "survey-context": {
335
335
  "description": "Per-task context bootstrap — reads existing specs/ and tech-architecture docs to map the current lifecycle phase and suggest the next skill. Use at the start of any task, when returning after a break, or when unsure what to do next. For deriving a tech-stack doc from scratch, use map-codebase first.",
336
- "sha256": "eab179b810784ef4",
336
+ "sha256": "8beae3b8b7eab0f7",
337
337
  "path": "skills/survey-contextSKILL.md"
338
338
  },
339
339
  "terse-mode": {
340
340
  "description": "Fallback ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use ONLY when context is critically long and compressing output is necessary to continue. Not a strategy — token discipline comes from code shape (small functions, unique names, headless tests), not terser prompts. Use when user says \"caveman mode\", \"terse mode\", \"less tokens\", \"be brief\", or invokes /terse-mode.",
341
- "sha256": "bb6fce40d59044a5",
341
+ "sha256": "952aa309f6287804",
342
342
  "path": "skills/terse-modeSKILL.md"
343
343
  },
344
344
  "trace-requirement": {
@@ -348,7 +348,7 @@
348
348
  },
349
349
  "using-bigpowers": {
350
350
  "description": "One-time bootstrap that introduces the bigpowers skills system, the PMBOK lifecycle arc, and tells you which skill to call first for your situation. Use when starting with bigpowers for the first time, when user asks \"where do I start?\", or when the skills system needs to be explained.",
351
- "sha256": "c910fc0ed3482341",
351
+ "sha256": "332d6468868b759b",
352
352
  "path": "skills/using-bigpowersSKILL.md"
353
353
  },
354
354
  "validate-contracts": {