bigpowers 2.16.0 → 2.17.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/.pi/package.json +1 -1
- package/.pi/prompts/fix-bug.md +24 -6
- package/.pi/prompts/orchestrate-project.md +8 -0
- package/.pi/prompts/session-state.md +11 -12
- package/.pi/skills/fix-bug/SKILL.md +24 -6
- package/.pi/skills/orchestrate-project/SKILL.md +8 -0
- package/.pi/skills/session-state/SKILL.md +11 -12
- package/CHANGELOG.md +7 -0
- package/SKILL-INDEX.md +1 -1
- package/fix-bug/SKILL.md +24 -6
- package/orchestrate-project/SKILL.md +8 -0
- package/package.json +1 -1
- package/session-state/SKILL.md +11 -12
- package/skills-lock.json +3 -3
package/.pi/package.json
CHANGED
package/.pi/prompts/fix-bug.md
CHANGED
|
@@ -9,15 +9,33 @@ description: Bug fix orchestrator — active_flow fix_bug; reads specs/bugs/BUG-
|
|
|
9
9
|
|
|
10
10
|
Orchestrates **fix_bug** flow without mixing epic build state.
|
|
11
11
|
|
|
12
|
-
> **HARD GATE** — Set `specs/state.yaml` `active_flow: fix_bug
|
|
12
|
+
> **HARD GATE** — Set `specs/state.yaml` `active_flow: fix_bug` and `bug_cycle.current_step: 1` before starting.
|
|
13
|
+
|
|
14
|
+
## Five steps (`bug_cycle` in state.yaml)
|
|
15
|
+
|
|
16
|
+
| Step | Skill / action |
|
|
17
|
+
|------|----------------|
|
|
18
|
+
| 1 | `investigate-bug` — create BUG-*.md with RCA |
|
|
19
|
+
| 2 | `diagnose-root` — 4-phase root cause analysis |
|
|
20
|
+
| 3 | `develop-tdd` — red-green against bug file verify steps |
|
|
21
|
+
| 4 | `validate-fix` — re-run failing test, full suite, lint |
|
|
22
|
+
| 5 | `release-branch` — PR or solo land the fix |
|
|
23
|
+
|
|
24
|
+
### Checkpoint / resume
|
|
25
|
+
|
|
26
|
+
Track progress via `specs/state.yaml` `bug_cycle`:
|
|
27
|
+
- `bug_cycle.current_step`: current step (1–5)
|
|
28
|
+
- `bug_cycle.completed_steps`: completed step numbers
|
|
29
|
+
- `handoff.next_skill`: skill for the current step
|
|
30
|
+
- On resume, read `bug_cycle.current_step` and continue from there
|
|
13
31
|
|
|
14
32
|
## Process
|
|
15
33
|
|
|
16
|
-
1. If no `specs/bugs/BUG-*.md`, run `investigate-bug` first — it handles history check, RCA (via `diagnose-root`), fix approach, and writes the bug file.
|
|
17
|
-
2.
|
|
18
|
-
3. `
|
|
19
|
-
4.
|
|
20
|
-
5. Clear `
|
|
34
|
+
1. **Step 1 — investigate-bug:** If no `specs/bugs/BUG-*.md`, run `investigate-bug` first — it handles history check, RCA (via `diagnose-root`), fix approach, and writes the bug file. Increment `bug_cycle.current_step` to 2 on completion.
|
|
35
|
+
2. **Step 2 — diagnose-root:** Run 4-phase RCA (reproduce → isolate → hypothesize → verify). Record findings in the bug file. Increment to step 3.
|
|
36
|
+
3. **Step 3 — develop-tdd:** `develop-tdd` against the bug file's verify steps. Increment to step 4 on all-green.
|
|
37
|
+
4. **Step 4 — validate-fix:** `validate-fix` — re-run failing test, full suite, typecheck, lint. Increment to step 5.
|
|
38
|
+
5. **Step 5 — release-branch:** Land the fix via `release-branch`. Clear `bug_cycle` and `active_flow` when done.
|
|
21
39
|
|
|
22
40
|
## Bug file SoT
|
|
23
41
|
|
|
@@ -31,6 +31,14 @@ claude /orchestrate --mode fast-track
|
|
|
31
31
|
5. **VERIFY** (1-3 hours): Validate success criteria. Deliverables: UAT evidence, `specs/EVALS-*.md` if used.
|
|
32
32
|
6. **RELEASE** (30 min - 2 hours): Ship to production. Deliverables: Release tag (vX.Y.Z), `state.yaml` `release.last_tag`.
|
|
33
33
|
|
|
34
|
+
### Checkpoint / resume
|
|
35
|
+
|
|
36
|
+
Track progress via `specs/state.yaml` `project_cycle`:
|
|
37
|
+
- `project_cycle.current_phase`: current phase (1–6)
|
|
38
|
+
- `project_cycle.completed_phases`: completed phase numbers
|
|
39
|
+
- `handoff.next_skill`: skill for the current phase
|
|
40
|
+
- On resume, read `project_cycle.current_phase` and continue from there
|
|
41
|
+
|
|
34
42
|
See [REFERENCE.md](REFERENCE.md) for detailed phase specifications and gate types.
|
|
35
43
|
|
|
36
44
|
## How Orchestrate Works
|
|
@@ -67,24 +67,23 @@ Whenever a significant decision is made or a milestone is reached:
|
|
|
67
67
|
|
|
68
68
|
→ verify: `bash scripts/validate-specs-yaml.sh`
|
|
69
69
|
|
|
70
|
-
##
|
|
70
|
+
## Universal checkpoint pattern
|
|
71
71
|
|
|
72
|
-
|
|
72
|
+
Every multi-step flow (>3 steps) in bigpowers uses a cycle counter in `state.yaml`:
|
|
73
73
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
74
|
+
| Flow | Cycle key | Step field | Phases/Steps |
|
|
75
|
+
|------|-----------|------------|-------------|
|
|
76
|
+
| build-epic | `epic_cycle` | `current_step` | 8 (survey → release) |
|
|
77
|
+
| fix-bug | `bug_cycle` | `current_step` | 5 (investigate → release) |
|
|
78
|
+
| orchestrate-project | `project_cycle` | `current_phase` | 6 (discover → release) |
|
|
77
79
|
|
|
78
|
-
|
|
79
|
-
```yaml
|
|
80
|
-
agent_id: session-state
|
|
81
|
-
acquired_at: "2026-06-11T14:30:00Z"
|
|
82
|
-
```
|
|
80
|
+
**Checkpoint:** After each step/phase completes, increment the counter in `state.yaml` and update `handoff.next_skill`.
|
|
83
81
|
|
|
82
|
+
**Resume:** On session start, read the current step/phase from the cycle key — continue from there, not from step 1.
|
|
84
83
|
|
|
85
|
-
|
|
84
|
+
**Completed steps:** Track completed steps in `completed_steps` (comma-separated string) for audit trail.
|
|
86
85
|
|
|
87
|
-
|
|
86
|
+
## Strategic compaction
|
|
88
87
|
|
|
89
88
|
Print the current session state: `cat specs/state.yaml`, then display `active_flow` and `handoff.next_skill` for quick reference.
|
|
90
89
|
|
|
@@ -11,15 +11,33 @@ model: sonnet
|
|
|
11
11
|
|
|
12
12
|
Orchestrates **fix_bug** flow without mixing epic build state.
|
|
13
13
|
|
|
14
|
-
> **HARD GATE** — Set `specs/state.yaml` `active_flow: fix_bug
|
|
14
|
+
> **HARD GATE** — Set `specs/state.yaml` `active_flow: fix_bug` and `bug_cycle.current_step: 1` before starting.
|
|
15
|
+
|
|
16
|
+
## Five steps (`bug_cycle` in state.yaml)
|
|
17
|
+
|
|
18
|
+
| Step | Skill / action |
|
|
19
|
+
|------|----------------|
|
|
20
|
+
| 1 | `investigate-bug` — create BUG-*.md with RCA |
|
|
21
|
+
| 2 | `diagnose-root` — 4-phase root cause analysis |
|
|
22
|
+
| 3 | `develop-tdd` — red-green against bug file verify steps |
|
|
23
|
+
| 4 | `validate-fix` — re-run failing test, full suite, lint |
|
|
24
|
+
| 5 | `release-branch` — PR or solo land the fix |
|
|
25
|
+
|
|
26
|
+
### Checkpoint / resume
|
|
27
|
+
|
|
28
|
+
Track progress via `specs/state.yaml` `bug_cycle`:
|
|
29
|
+
- `bug_cycle.current_step`: current step (1–5)
|
|
30
|
+
- `bug_cycle.completed_steps`: completed step numbers
|
|
31
|
+
- `handoff.next_skill`: skill for the current step
|
|
32
|
+
- On resume, read `bug_cycle.current_step` and continue from there
|
|
15
33
|
|
|
16
34
|
## Process
|
|
17
35
|
|
|
18
|
-
1. If no `specs/bugs/BUG-*.md`, run `investigate-bug` first — it handles history check, RCA (via `diagnose-root`), fix approach, and writes the bug file.
|
|
19
|
-
2.
|
|
20
|
-
3. `
|
|
21
|
-
4.
|
|
22
|
-
5. Clear `
|
|
36
|
+
1. **Step 1 — investigate-bug:** If no `specs/bugs/BUG-*.md`, run `investigate-bug` first — it handles history check, RCA (via `diagnose-root`), fix approach, and writes the bug file. Increment `bug_cycle.current_step` to 2 on completion.
|
|
37
|
+
2. **Step 2 — diagnose-root:** Run 4-phase RCA (reproduce → isolate → hypothesize → verify). Record findings in the bug file. Increment to step 3.
|
|
38
|
+
3. **Step 3 — develop-tdd:** `develop-tdd` against the bug file's verify steps. Increment to step 4 on all-green.
|
|
39
|
+
4. **Step 4 — validate-fix:** `validate-fix` — re-run failing test, full suite, typecheck, lint. Increment to step 5.
|
|
40
|
+
5. **Step 5 — release-branch:** Land the fix via `release-branch`. Clear `bug_cycle` and `active_flow` when done.
|
|
23
41
|
|
|
24
42
|
## Bug file SoT
|
|
25
43
|
|
|
@@ -33,6 +33,14 @@ claude /orchestrate --mode fast-track
|
|
|
33
33
|
5. **VERIFY** (1-3 hours): Validate success criteria. Deliverables: UAT evidence, `specs/EVALS-*.md` if used.
|
|
34
34
|
6. **RELEASE** (30 min - 2 hours): Ship to production. Deliverables: Release tag (vX.Y.Z), `state.yaml` `release.last_tag`.
|
|
35
35
|
|
|
36
|
+
### Checkpoint / resume
|
|
37
|
+
|
|
38
|
+
Track progress via `specs/state.yaml` `project_cycle`:
|
|
39
|
+
- `project_cycle.current_phase`: current phase (1–6)
|
|
40
|
+
- `project_cycle.completed_phases`: completed phase numbers
|
|
41
|
+
- `handoff.next_skill`: skill for the current phase
|
|
42
|
+
- On resume, read `project_cycle.current_phase` and continue from there
|
|
43
|
+
|
|
36
44
|
See [REFERENCE.md](REFERENCE.md) for detailed phase specifications and gate types.
|
|
37
45
|
|
|
38
46
|
## How Orchestrate Works
|
|
@@ -69,24 +69,23 @@ Whenever a significant decision is made or a milestone is reached:
|
|
|
69
69
|
|
|
70
70
|
→ verify: `bash scripts/validate-specs-yaml.sh`
|
|
71
71
|
|
|
72
|
-
##
|
|
72
|
+
## Universal checkpoint pattern
|
|
73
73
|
|
|
74
|
-
|
|
74
|
+
Every multi-step flow (>3 steps) in bigpowers uses a cycle counter in `state.yaml`:
|
|
75
75
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
76
|
+
| Flow | Cycle key | Step field | Phases/Steps |
|
|
77
|
+
|------|-----------|------------|-------------|
|
|
78
|
+
| build-epic | `epic_cycle` | `current_step` | 8 (survey → release) |
|
|
79
|
+
| fix-bug | `bug_cycle` | `current_step` | 5 (investigate → release) |
|
|
80
|
+
| orchestrate-project | `project_cycle` | `current_phase` | 6 (discover → release) |
|
|
79
81
|
|
|
80
|
-
|
|
81
|
-
```yaml
|
|
82
|
-
agent_id: session-state
|
|
83
|
-
acquired_at: "2026-06-11T14:30:00Z"
|
|
84
|
-
```
|
|
82
|
+
**Checkpoint:** After each step/phase completes, increment the counter in `state.yaml` and update `handoff.next_skill`.
|
|
85
83
|
|
|
84
|
+
**Resume:** On session start, read the current step/phase from the cycle key — continue from there, not from step 1.
|
|
86
85
|
|
|
87
|
-
|
|
86
|
+
**Completed steps:** Track completed steps in `completed_steps` (comma-separated string) for audit trail.
|
|
88
87
|
|
|
89
|
-
|
|
88
|
+
## Strategic compaction
|
|
90
89
|
|
|
91
90
|
Print the current session state: `cat specs/state.yaml`, then display `active_flow` and `handoff.next_skill` for quick reference.
|
|
92
91
|
|
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,10 @@
|
|
|
1
|
+
# [2.17.0](https://github.com/danielvm-git/bigpowers/compare/v2.16.0...v2.17.0) (2026-06-21)
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
### Features
|
|
5
|
+
|
|
6
|
+
* **e18s04:** universal checkpoint pattern in fix-bug + orchestrate ([5a47aac](https://github.com/danielvm-git/bigpowers/commit/5a47aac8f0dd1a4463749ab36c64aeded86aa8a4))
|
|
7
|
+
|
|
1
8
|
# [2.16.0](https://github.com/danielvm-git/bigpowers/compare/v2.15.0...v2.16.0) (2026-06-21)
|
|
2
9
|
|
|
3
10
|
|
package/SKILL-INDEX.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> **DO NOT EDIT** — This file is auto-generated by `scripts/generate-skill-index.sh`.
|
|
4
4
|
> Edit `SKILL.md` source files or `skills-lock.json` instead. Run `bash scripts/sync-skills.sh` to regenerate.
|
|
5
5
|
|
|
6
|
-
**Generated:** 2026-06-21T21:
|
|
6
|
+
**Generated:** 2026-06-21T21:41:36Z
|
|
7
7
|
**Skills:** 67
|
|
8
8
|
|
|
9
9
|
---
|
package/fix-bug/SKILL.md
CHANGED
|
@@ -10,15 +10,33 @@ description: Bug fix orchestrator — active_flow fix_bug; reads specs/bugs/BUG-
|
|
|
10
10
|
|
|
11
11
|
Orchestrates **fix_bug** flow without mixing epic build state.
|
|
12
12
|
|
|
13
|
-
> **HARD GATE** — Set `specs/state.yaml` `active_flow: fix_bug
|
|
13
|
+
> **HARD GATE** — Set `specs/state.yaml` `active_flow: fix_bug` and `bug_cycle.current_step: 1` before starting.
|
|
14
|
+
|
|
15
|
+
## Five steps (`bug_cycle` in state.yaml)
|
|
16
|
+
|
|
17
|
+
| Step | Skill / action |
|
|
18
|
+
|------|----------------|
|
|
19
|
+
| 1 | `investigate-bug` — create BUG-*.md with RCA |
|
|
20
|
+
| 2 | `diagnose-root` — 4-phase root cause analysis |
|
|
21
|
+
| 3 | `develop-tdd` — red-green against bug file verify steps |
|
|
22
|
+
| 4 | `validate-fix` — re-run failing test, full suite, lint |
|
|
23
|
+
| 5 | `release-branch` — PR or solo land the fix |
|
|
24
|
+
|
|
25
|
+
### Checkpoint / resume
|
|
26
|
+
|
|
27
|
+
Track progress via `specs/state.yaml` `bug_cycle`:
|
|
28
|
+
- `bug_cycle.current_step`: current step (1–5)
|
|
29
|
+
- `bug_cycle.completed_steps`: completed step numbers
|
|
30
|
+
- `handoff.next_skill`: skill for the current step
|
|
31
|
+
- On resume, read `bug_cycle.current_step` and continue from there
|
|
14
32
|
|
|
15
33
|
## Process
|
|
16
34
|
|
|
17
|
-
1. If no `specs/bugs/BUG-*.md`, run `investigate-bug` first — it handles history check, RCA (via `diagnose-root`), fix approach, and writes the bug file.
|
|
18
|
-
2.
|
|
19
|
-
3. `
|
|
20
|
-
4.
|
|
21
|
-
5. Clear `
|
|
35
|
+
1. **Step 1 — investigate-bug:** If no `specs/bugs/BUG-*.md`, run `investigate-bug` first — it handles history check, RCA (via `diagnose-root`), fix approach, and writes the bug file. Increment `bug_cycle.current_step` to 2 on completion.
|
|
36
|
+
2. **Step 2 — diagnose-root:** Run 4-phase RCA (reproduce → isolate → hypothesize → verify). Record findings in the bug file. Increment to step 3.
|
|
37
|
+
3. **Step 3 — develop-tdd:** `develop-tdd` against the bug file's verify steps. Increment to step 4 on all-green.
|
|
38
|
+
4. **Step 4 — validate-fix:** `validate-fix` — re-run failing test, full suite, typecheck, lint. Increment to step 5.
|
|
39
|
+
5. **Step 5 — release-branch:** Land the fix via `release-branch`. Clear `bug_cycle` and `active_flow` when done.
|
|
22
40
|
|
|
23
41
|
## Bug file SoT
|
|
24
42
|
|
|
@@ -32,6 +32,14 @@ claude /orchestrate --mode fast-track
|
|
|
32
32
|
5. **VERIFY** (1-3 hours): Validate success criteria. Deliverables: UAT evidence, `specs/EVALS-*.md` if used.
|
|
33
33
|
6. **RELEASE** (30 min - 2 hours): Ship to production. Deliverables: Release tag (vX.Y.Z), `state.yaml` `release.last_tag`.
|
|
34
34
|
|
|
35
|
+
### Checkpoint / resume
|
|
36
|
+
|
|
37
|
+
Track progress via `specs/state.yaml` `project_cycle`:
|
|
38
|
+
- `project_cycle.current_phase`: current phase (1–6)
|
|
39
|
+
- `project_cycle.completed_phases`: completed phase numbers
|
|
40
|
+
- `handoff.next_skill`: skill for the current phase
|
|
41
|
+
- On resume, read `project_cycle.current_phase` and continue from there
|
|
42
|
+
|
|
35
43
|
See [REFERENCE.md](REFERENCE.md) for detailed phase specifications and gate types.
|
|
36
44
|
|
|
37
45
|
## How Orchestrate Works
|
package/package.json
CHANGED
package/session-state/SKILL.md
CHANGED
|
@@ -68,24 +68,23 @@ Whenever a significant decision is made or a milestone is reached:
|
|
|
68
68
|
|
|
69
69
|
→ verify: `bash scripts/validate-specs-yaml.sh`
|
|
70
70
|
|
|
71
|
-
##
|
|
71
|
+
## Universal checkpoint pattern
|
|
72
72
|
|
|
73
|
-
|
|
73
|
+
Every multi-step flow (>3 steps) in bigpowers uses a cycle counter in `state.yaml`:
|
|
74
74
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
75
|
+
| Flow | Cycle key | Step field | Phases/Steps |
|
|
76
|
+
|------|-----------|------------|-------------|
|
|
77
|
+
| build-epic | `epic_cycle` | `current_step` | 8 (survey → release) |
|
|
78
|
+
| fix-bug | `bug_cycle` | `current_step` | 5 (investigate → release) |
|
|
79
|
+
| orchestrate-project | `project_cycle` | `current_phase` | 6 (discover → release) |
|
|
78
80
|
|
|
79
|
-
|
|
80
|
-
```yaml
|
|
81
|
-
agent_id: session-state
|
|
82
|
-
acquired_at: "2026-06-11T14:30:00Z"
|
|
83
|
-
```
|
|
81
|
+
**Checkpoint:** After each step/phase completes, increment the counter in `state.yaml` and update `handoff.next_skill`.
|
|
84
82
|
|
|
83
|
+
**Resume:** On session start, read the current step/phase from the cycle key — continue from there, not from step 1.
|
|
85
84
|
|
|
86
|
-
|
|
85
|
+
**Completed steps:** Track completed steps in `completed_steps` (comma-separated string) for audit trail.
|
|
87
86
|
|
|
88
|
-
|
|
87
|
+
## Strategic compaction
|
|
89
88
|
|
|
90
89
|
Print the current session state: `cat specs/state.yaml`, then display `active_flow` and `handoff.next_skill` for quick reference.
|
|
91
90
|
|
package/skills-lock.json
CHANGED
|
@@ -113,7 +113,7 @@
|
|
|
113
113
|
},
|
|
114
114
|
"fix-bug": {
|
|
115
115
|
"description": "Bug fix orchestrator — active_flow fix_bug; reads specs/bugs/BUG-*.md; chains investigate-bug, develop-tdd, validate-fix. Use when user reports a defect.",
|
|
116
|
-
"sha256": "
|
|
116
|
+
"sha256": "aa6fe406ba87a648",
|
|
117
117
|
"path": "fix-bug/SKILL.md"
|
|
118
118
|
},
|
|
119
119
|
"grill-me": {
|
|
@@ -168,7 +168,7 @@
|
|
|
168
168
|
},
|
|
169
169
|
"orchestrate-project": {
|
|
170
170
|
"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.",
|
|
171
|
-
"sha256": "
|
|
171
|
+
"sha256": "542276f88198ae72",
|
|
172
172
|
"path": "orchestrate-project/SKILL.md"
|
|
173
173
|
},
|
|
174
174
|
"organize-workspace": {
|
|
@@ -248,7 +248,7 @@
|
|
|
248
248
|
},
|
|
249
249
|
"session-state": {
|
|
250
250
|
"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.",
|
|
251
|
-
"sha256": "
|
|
251
|
+
"sha256": "4efd54a453e3e2cd",
|
|
252
252
|
"path": "session-state/SKILL.md"
|
|
253
253
|
},
|
|
254
254
|
"setup-environment": {
|