bigpowers 2.44.1 → 2.45.1
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/align-grid.md +0 -4
- package/.pi/prompts/audit-code.md +1 -1
- package/.pi/prompts/build-epic.md +1 -1
- package/.pi/prompts/commit-message.md +0 -3
- package/.pi/prompts/craft-skill.md +0 -4
- package/.pi/prompts/deepen-architecture.md +0 -4
- package/.pi/prompts/define-language.md +0 -4
- package/.pi/prompts/define-success.md +0 -2
- package/.pi/prompts/delegate-task.md +0 -4
- package/.pi/prompts/deploy.md +0 -4
- package/.pi/prompts/design-interface.md +0 -4
- package/.pi/prompts/develop-tdd.md +0 -3
- package/.pi/prompts/dispatch-agents.md +0 -4
- package/.pi/prompts/edit-document.md +0 -4
- package/.pi/prompts/elaborate-spec.md +0 -4
- package/.pi/prompts/enforce-first.md +0 -4
- package/.pi/prompts/execute-plan.md +0 -4
- package/.pi/prompts/extract-design.md +0 -4
- package/.pi/prompts/grill-me.md +0 -4
- package/.pi/prompts/guard-git.md +0 -4
- package/.pi/prompts/hook-commits.md +0 -4
- package/.pi/prompts/inspect-quality.md +0 -4
- package/.pi/prompts/investigate-bug.md +0 -4
- package/.pi/prompts/kickoff-branch.md +0 -3
- package/.pi/prompts/map-codebase.md +0 -4
- package/.pi/prompts/model-domain.md +0 -4
- package/.pi/prompts/orchestrate-project.md +1 -5
- package/.pi/prompts/organize-workspace.md +0 -4
- package/.pi/prompts/plan-refactor.md +0 -2
- package/.pi/prompts/plan-work.md +0 -1
- package/.pi/prompts/quick-fix.md +0 -3
- package/.pi/prompts/release-branch.md +1 -1
- package/.pi/prompts/request-review.md +0 -4
- package/.pi/prompts/respond-review.md +0 -4
- package/.pi/prompts/security-review.md +0 -1
- package/.pi/prompts/seed-conventions.md +2 -5
- package/.pi/prompts/smoke-test.md +0 -4
- package/.pi/prompts/spike-prototype.md +0 -4
- package/.pi/prompts/terse-mode.md +0 -4
- package/.pi/prompts/using-bigpowers.md +0 -4
- package/.pi/prompts/validate-contracts.md +0 -4
- package/.pi/prompts/validate-fix.md +0 -4
- package/.pi/prompts/wire-observability.md +0 -4
- package/.pi/skills/align-grid/SKILL.md +0 -4
- package/.pi/skills/audit-code/SKILL.md +1 -1
- package/.pi/skills/build-epic/SKILL.md +1 -1
- package/.pi/skills/commit-message/SKILL.md +0 -3
- package/.pi/skills/craft-skill/SKILL.md +0 -4
- package/.pi/skills/deepen-architecture/SKILL.md +0 -4
- package/.pi/skills/define-language/SKILL.md +0 -4
- package/.pi/skills/define-success/SKILL.md +0 -2
- package/.pi/skills/delegate-task/SKILL.md +0 -4
- package/.pi/skills/deploy/SKILL.md +0 -4
- package/.pi/skills/design-interface/SKILL.md +0 -4
- package/.pi/skills/develop-tdd/SKILL.md +0 -3
- package/.pi/skills/dispatch-agents/SKILL.md +0 -4
- package/.pi/skills/edit-document/SKILL.md +0 -4
- package/.pi/skills/elaborate-spec/SKILL.md +0 -4
- package/.pi/skills/enforce-first/SKILL.md +0 -4
- package/.pi/skills/execute-plan/SKILL.md +0 -4
- package/.pi/skills/extract-design/SKILL.md +0 -4
- package/.pi/skills/grill-me/SKILL.md +0 -4
- package/.pi/skills/guard-git/SKILL.md +0 -4
- package/.pi/skills/hook-commits/SKILL.md +0 -4
- package/.pi/skills/inspect-quality/SKILL.md +0 -4
- package/.pi/skills/investigate-bug/SKILL.md +0 -4
- package/.pi/skills/kickoff-branch/SKILL.md +0 -3
- package/.pi/skills/map-codebase/SKILL.md +0 -4
- package/.pi/skills/model-domain/SKILL.md +0 -4
- package/.pi/skills/orchestrate-project/SKILL.md +1 -5
- package/.pi/skills/organize-workspace/SKILL.md +0 -4
- package/.pi/skills/plan-refactor/SKILL.md +0 -2
- package/.pi/skills/plan-work/SKILL.md +0 -1
- package/.pi/skills/quick-fix/SKILL.md +0 -3
- package/.pi/skills/release-branch/SKILL.md +1 -1
- package/.pi/skills/request-review/SKILL.md +0 -4
- package/.pi/skills/respond-review/SKILL.md +0 -4
- package/.pi/skills/security-review/SKILL.md +0 -1
- package/.pi/skills/seed-conventions/SKILL.md +2 -5
- package/.pi/skills/smoke-test/SKILL.md +0 -4
- package/.pi/skills/spike-prototype/SKILL.md +0 -4
- package/.pi/skills/terse-mode/SKILL.md +0 -4
- package/.pi/skills/using-bigpowers/SKILL.md +0 -4
- package/.pi/skills/validate-contracts/SKILL.md +0 -4
- package/.pi/skills/validate-fix/SKILL.md +0 -4
- package/.pi/skills/wire-observability/SKILL.md +0 -4
- package/CHANGELOG.md +14 -0
- package/CLAUDE.md +2 -0
- package/SKILL-INDEX.md +49 -46
- package/package.json +1 -1
- package/scripts/generate-skill-index.sh +3 -3
- package/skills/align-grid/SKILL.md +0 -3
- package/skills/audit-code/SKILL.md +1 -1
- package/skills/build-epic/SKILL.md +1 -1
- package/skills/commit-message/SKILL.md +0 -3
- package/skills/craft-skill/SKILL.md +0 -3
- package/skills/deepen-architecture/SKILL.md +0 -3
- package/skills/define-language/SKILL.md +0 -3
- package/skills/define-success/SKILL.md +0 -1
- package/skills/delegate-task/SKILL.md +0 -3
- package/skills/deploy/SKILL.md +0 -3
- package/skills/design-interface/SKILL.md +0 -3
- package/skills/develop-tdd/SKILL.md +0 -3
- package/skills/dispatch-agents/SKILL.md +0 -3
- package/skills/edit-document/SKILL.md +0 -3
- package/skills/elaborate-spec/SKILL.md +0 -3
- package/skills/enforce-first/SKILL.md +0 -3
- package/skills/execute-plan/SKILL.md +0 -3
- package/skills/extract-design/SKILL.md +0 -3
- package/skills/grill-me/SKILL.md +0 -3
- package/skills/guard-git/SKILL.md +0 -3
- package/skills/hook-commits/SKILL.md +0 -3
- package/skills/inspect-quality/SKILL.md +0 -3
- package/skills/investigate-bug/SKILL.md +0 -3
- package/skills/kickoff-branch/SKILL.md +0 -3
- package/skills/map-codebase/SKILL.md +0 -3
- package/skills/model-domain/SKILL.md +0 -3
- package/skills/orchestrate-project/SKILL.md +1 -4
- package/skills/organize-workspace/SKILL.md +0 -3
- package/skills/plan-refactor/SKILL.md +0 -1
- package/skills/plan-work/SKILL.md +0 -1
- package/skills/quick-fix/SKILL.md +0 -3
- package/skills/release-branch/SKILL.md +1 -1
- package/skills/request-review/SKILL.md +0 -3
- package/skills/respond-review/SKILL.md +0 -3
- package/skills/security-review/SKILL.md +0 -1
- package/skills/seed-conventions/SKILL.md +2 -5
- package/skills/smoke-test/SKILL.md +0 -3
- package/skills/spike-prototype/SKILL.md +0 -3
- package/skills/terse-mode/SKILL.md +0 -3
- package/skills/using-bigpowers/SKILL.md +0 -3
- package/skills/validate-contracts/SKILL.md +0 -3
- package/skills/validate-fix/SKILL.md +0 -3
- package/skills/wire-observability/SKILL.md +0 -3
- package/skills-lock.json +43 -43
package/.pi/package.json
CHANGED
|
@@ -102,7 +102,3 @@ A clean run looks like: `col=0px overlay=0px baseline≤4px ink=0px` → `GRID V
|
|
|
102
102
|
|
|
103
103
|
## CREED
|
|
104
104
|
A grid you can't toggle on and measure is a mood board, not a system. Build it from one source of truth, prove it at 0px, and align the **ink**.
|
|
105
|
-
|
|
106
|
-
## Verify
|
|
107
|
-
|
|
108
|
-
→ verify: `test -f align-grid/SKILL.md && grep -q '^name:' align-grid/SKILL.md && echo "OK: align-grid valid" || echo "FAIL: align-grid missing"`
|
|
@@ -121,7 +121,7 @@ Aggregate exit code: `0` if all sections PASS, `1` (non-zero) if any section FAI
|
|
|
121
121
|
|
|
122
122
|
## Verify
|
|
123
123
|
|
|
124
|
-
→ verify: `test -f
|
|
124
|
+
→ verify: `test -f CONVENTIONS.md && test -d skills/enforce-first && test -d skills/request-review && echo "OK: audit-code dependencies present" || echo "FAIL"`
|
|
125
125
|
|
|
126
126
|
|
|
127
127
|
## Handoff
|
|
@@ -76,4 +76,4 @@ Write `handoff.next_skill` and `handoff.context` in `state.yaml` when pausing mi
|
|
|
76
76
|
|
|
77
77
|
## Verify
|
|
78
78
|
|
|
79
|
-
→ verify: `test -f
|
|
79
|
+
→ verify: `test -f specs/state.yaml && test -f specs/execution-status.yaml && test -f specs/release-plan.yaml && test -d skills/assess-impact && test -d skills/audit-code && test -d skills/security-review && echo "OK: build-epic dependencies present" || echo "FAIL"`
|
|
@@ -46,9 +46,6 @@ If the repo uses a custom `@semantic-release/commit-analyzer` preset, note that
|
|
|
46
46
|
|
|
47
47
|
- [REFERENCE.md](REFERENCE.md) — Message shape, footers, release mapping, squashing notes.
|
|
48
48
|
|
|
49
|
-
## Verify
|
|
50
|
-
|
|
51
|
-
→ verify: `test -f commit-message/SKILL.md && grep -q '^name:' commit-message/SKILL.md && echo "OK: commit-message valid" || echo "FAIL: commit-message missing"`
|
|
52
49
|
|
|
53
50
|
|
|
54
51
|
## Handoff
|
|
@@ -58,10 +58,6 @@ After drafting, verify:
|
|
|
58
58
|
- [ ] specs/ output documented if applicable
|
|
59
59
|
- [ ] `sync-skills.sh` run to propagate to Cursor/Gemini
|
|
60
60
|
|
|
61
|
-
## Verify
|
|
62
|
-
|
|
63
|
-
→ verify: `test -f craft-skill/SKILL.md && grep -q '^name:' craft-skill/SKILL.md && echo "OK: craft-skill valid" || echo "FAIL: craft-skill missing"`
|
|
64
|
-
|
|
65
61
|
---
|
|
66
62
|
|
|
67
63
|
# Craft Skill — Reference
|
|
@@ -91,10 +91,6 @@ Side effects happen inline as decisions crystallize:
|
|
|
91
91
|
- **User rejects the candidate with a load-bearing reason?** Offer an ADR, framed as: _"Want me to record this as an ADR so future architecture reviews don't re-suggest it?"_ Only offer when the reason would actually be needed by a future explorer. See [ADR-FORMAT.md](../model-domain/ADR-FORMAT.md).
|
|
92
92
|
- **Want to explore alternative interfaces for the deepened module?** See [INTERFACE-DESIGN.md](INTERFACE-DESIGN.md).
|
|
93
93
|
|
|
94
|
-
## Verify
|
|
95
|
-
|
|
96
|
-
→ verify: `test -f deepen-architecture/SKILL.md && grep -q '^name:' deepen-architecture/SKILL.md && echo "OK: deepen-architecture valid" || echo "FAIL: deepen-architecture missing"`
|
|
97
|
-
|
|
98
94
|
---
|
|
99
95
|
|
|
100
96
|
# Deepening
|
|
@@ -77,7 +77,3 @@ When invoked again in the same conversation:
|
|
|
77
77
|
3. Update definitions if understanding has evolved
|
|
78
78
|
4. Re-flag any new ambiguities
|
|
79
79
|
5. Rewrite the example dialogue to incorporate new terms
|
|
80
|
-
|
|
81
|
-
## Verify
|
|
82
|
-
|
|
83
|
-
→ verify: `test -f define-language/SKILL.md && grep -q '^name:' define-language/SKILL.md && echo "OK: define-language valid" || echo "FAIL: define-language missing"`
|
|
@@ -62,5 +62,3 @@ Present the pairs to the user and ask: "Does this capture everything the task re
|
|
|
62
62
|
Once confirmed, these pairs become the skeleton for `plan-work`'s steps. Pass them along when calling `plan-work`.
|
|
63
63
|
|
|
64
64
|
## Verify
|
|
65
|
-
|
|
66
|
-
→ verify: `test -f define-success/SKILL.md && grep -q '^name:' define-success/SKILL.md && echo "OK: define-success valid" || echo "FAIL: define-success missing"`
|
package/.pi/prompts/deploy.md
CHANGED
|
@@ -103,10 +103,6 @@ For comprehensive health-checking, chain to the `smoke-test` skill:
|
|
|
103
103
|
bash scripts/run-smoke.sh "$DEPLOY_URL"
|
|
104
104
|
```
|
|
105
105
|
|
|
106
|
-
## Verify
|
|
107
|
-
|
|
108
|
-
→ verify: `test -f deploy/SKILL.md && grep -q '^name:' deploy/SKILL.md && echo "OK: deploy valid" || echo "FAIL: deploy missing"`
|
|
109
|
-
|
|
110
106
|
---
|
|
111
107
|
|
|
112
108
|
# Deploy — Reference
|
|
@@ -94,7 +94,3 @@ From "A Philosophy of Software Design":
|
|
|
94
94
|
- Don't skip comparison — the value is in contrast
|
|
95
95
|
- Don't implement — this is purely about interface shape
|
|
96
96
|
- Don't evaluate based on implementation effort
|
|
97
|
-
|
|
98
|
-
## Verify
|
|
99
|
-
|
|
100
|
-
→ verify: `test -f design-interface/SKILL.md && grep -q '^name:' design-interface/SKILL.md && echo "OK: design-interface valid" || echo "FAIL: design-interface missing"`
|
|
@@ -93,9 +93,6 @@ If this cycle modified files in `.github/workflows/`, run the CI dry-run procedu
|
|
|
93
93
|
[ ] verify: command passes
|
|
94
94
|
```
|
|
95
95
|
|
|
96
|
-
## Verify
|
|
97
|
-
|
|
98
|
-
→ verify: `test -f develop-tdd/SKILL.md && grep -q '^name:' develop-tdd/SKILL.md && echo "OK: develop-tdd valid" || echo "FAIL: develop-tdd missing"`
|
|
99
96
|
|
|
100
97
|
|
|
101
98
|
## Handoff
|
|
@@ -81,7 +81,3 @@ When all agents return:
|
|
|
81
81
|
Merge accepted results. If any agent's result conflicts with another, resolve manually and note the conflict.
|
|
82
82
|
|
|
83
83
|
Report a summary: which tasks succeeded, which need revision, and overall verify status.
|
|
84
|
-
|
|
85
|
-
## Verify
|
|
86
|
-
|
|
87
|
-
→ verify: `test -f dispatch-agents/SKILL.md && grep -q '^name:' dispatch-agents/SKILL.md && echo "OK: dispatch-agents valid" || echo "FAIL: dispatch-agents missing"`
|
|
@@ -20,7 +20,3 @@ Confirm the sections with the user.
|
|
|
20
20
|
2. For each section:
|
|
21
21
|
|
|
22
22
|
2a. Rewrite the section to improve clarity, coherence, and flow. Use maximum 240 characters per paragraph.
|
|
23
|
-
|
|
24
|
-
## Verify
|
|
25
|
-
|
|
26
|
-
→ verify: `test -f edit-document/SKILL.md && grep -q '^name:' edit-document/SKILL.md && echo "OK: edit-document valid" || echo "FAIL: edit-document missing"`
|
|
@@ -98,7 +98,3 @@ Once the spec is clear, recommend the next step:
|
|
|
98
98
|
- If a spike is needed first → `spike-prototype`
|
|
99
99
|
- If architecture decisions are needed → `deepen-architecture` or `grill-me`
|
|
100
100
|
- If the plan depends on a specific library or API → `grill-me` in docs mode
|
|
101
|
-
|
|
102
|
-
## Verify
|
|
103
|
-
|
|
104
|
-
→ verify: `test -f elaborate-spec/SKILL.md && grep -q '^name:' elaborate-spec/SKILL.md && echo "OK: elaborate-spec valid" || echo "FAIL: elaborate-spec missing"`
|
|
@@ -80,7 +80,3 @@ For each failing criterion:
|
|
|
80
80
|
4. Re-run the suite to confirm it still passes
|
|
81
81
|
|
|
82
82
|
Report: "F.I.R.S.T audit complete. X criteria passed, Y fixed."
|
|
83
|
-
|
|
84
|
-
## Verify
|
|
85
|
-
|
|
86
|
-
→ verify: `test -f enforce-first/SKILL.md && grep -q '^name:' enforce-first/SKILL.md && echo "OK: enforce-first valid" || echo "FAIL: enforce-first missing"`
|
|
@@ -52,7 +52,3 @@ 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
|
-
## Verify
|
|
57
|
-
|
|
58
|
-
→ verify: `test -f execute-plan/SKILL.md && grep -q '^name:' execute-plan/SKILL.md && echo "OK: execute-plan valid" || echo "FAIL: execute-plan missing"`
|
|
@@ -75,10 +75,6 @@ node extract-design/tests/test-extraction.js
|
|
|
75
75
|
|
|
76
76
|
See [REFERENCE.md](REFERENCE.md) for extraction algorithms and heuristics.
|
|
77
77
|
|
|
78
|
-
## Verify
|
|
79
|
-
|
|
80
|
-
→ verify: `test -f extract-design/SKILL.md && grep -q '^name:' extract-design/SKILL.md && echo "OK: extract-design valid" || echo "FAIL: extract-design missing"`
|
|
81
|
-
|
|
82
78
|
---
|
|
83
79
|
|
|
84
80
|
# Extract Design — Reference
|
package/.pi/prompts/grill-me.md
CHANGED
|
@@ -28,10 +28,6 @@ Short form:
|
|
|
28
28
|
4. Report confirmed ✓, corrected ✗ (with the real behavior), and uncertain → `spike-prototype`.
|
|
29
29
|
5. Update the plan for each confirmed discrepancy.
|
|
30
30
|
|
|
31
|
-
## Verify
|
|
32
|
-
|
|
33
|
-
→ verify: `test -f grill-me/SKILL.md && grep -q '^name:' grill-me/SKILL.md && echo "OK: grill-me valid" || echo "FAIL: grill-me missing"`
|
|
34
|
-
|
|
35
31
|
---
|
|
36
32
|
|
|
37
33
|
# Docs Mode — Full Process
|
package/.pi/prompts/guard-git.md
CHANGED
|
@@ -42,10 +42,6 @@ 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
|
-
## Verify
|
|
46
|
-
|
|
47
|
-
→ verify: `test -f guard-git/SKILL.md && grep -q '^name:' guard-git/SKILL.md && echo "OK: guard-git valid" || echo "FAIL: guard-git missing"`
|
|
48
|
-
|
|
49
45
|
---
|
|
50
46
|
|
|
51
47
|
# Git guardrails — reference
|
|
@@ -91,7 +91,3 @@ This will run through the new pre-commit hooks — a good smoke test that everyt
|
|
|
91
91
|
- Husky v9+ doesn't need shebangs in hook files
|
|
92
92
|
- `prettier --ignore-unknown` skips files Prettier can't parse (images, etc.)
|
|
93
93
|
- The pre-commit runs lint-staged first (fast, staged-only), then full typecheck and tests
|
|
94
|
-
|
|
95
|
-
## Verify
|
|
96
|
-
|
|
97
|
-
→ verify: `test -f hook-commits/SKILL.md && grep -q '^name:' hook-commits/SKILL.md && echo "OK: hook-commits valid" || echo "FAIL: hook-commits missing"`
|
|
@@ -103,7 +103,3 @@ For each bug, also append a detail section:
|
|
|
103
103
|
### 5. Continue the session
|
|
104
104
|
|
|
105
105
|
After logging, ask: "Next issue, or are we done?" Keep going until the user says done. Each issue is independent — don't batch them.
|
|
106
|
-
|
|
107
|
-
## Verify
|
|
108
|
-
|
|
109
|
-
→ verify: `test -f inspect-quality/SKILL.md && grep -q '^name:' inspect-quality/SKILL.md && echo "OK: inspect-quality valid" || echo "FAIL: inspect-quality missing"`
|
|
@@ -117,7 +117,3 @@ A numbered list of RED-GREEN cycles:
|
|
|
117
117
|
</diagnosis-template>
|
|
118
118
|
|
|
119
119
|
After writing the bug file, print a one-line summary of the root cause and suggest running `kickoff-branch` next to create a fix branch.
|
|
120
|
-
|
|
121
|
-
## Verify
|
|
122
|
-
|
|
123
|
-
→ verify: `test -f investigate-bug/SKILL.md && grep -q '^name:' investigate-bug/SKILL.md && echo "OK: investigate-bug valid" || echo "FAIL: investigate-bug missing"`
|
|
@@ -118,9 +118,6 @@ Ready to develop.
|
|
|
118
118
|
|
|
119
119
|
Suggest next skill: `develop-tdd` to start the TDD loop, or `execute-plan` if `specs/release-plan.yaml + epic capsule directories` already exists.
|
|
120
120
|
|
|
121
|
-
## Verify
|
|
122
|
-
|
|
123
|
-
→ verify: `test -f kickoff-branch/SKILL.md && grep -q '^name:' kickoff-branch/SKILL.md && echo "OK: kickoff-branch valid" || echo "FAIL: kickoff-branch missing"`
|
|
124
121
|
|
|
125
122
|
|
|
126
123
|
## Handoff
|
|
@@ -68,7 +68,3 @@ Compile all findings into `specs/tech-architecture/tech-stack.md`. This file ser
|
|
|
68
68
|
- Before a major refactor or architectural change.
|
|
69
69
|
- When `survey-context` reveals a lack of domain knowledge.
|
|
70
70
|
- To refresh `specs/tech-architecture/tech-stack.md` after significant changes.
|
|
71
|
-
|
|
72
|
-
## Verify
|
|
73
|
-
|
|
74
|
-
→ verify: `test -f map-codebase/SKILL.md && grep -q '^name:' map-codebase/SKILL.md && echo "OK: map-codebase valid" || echo "FAIL: map-codebase missing"`
|
|
@@ -96,10 +96,6 @@ 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
|
-
## Verify
|
|
100
|
-
|
|
101
|
-
→ verify: `test -f model-domain/SKILL.md && grep -q '^name:' model-domain/SKILL.md && echo "OK: model-domain valid" || echo "FAIL: model-domain missing"`
|
|
102
|
-
|
|
103
99
|
---
|
|
104
100
|
|
|
105
101
|
# ADR Format
|
|
@@ -45,7 +45,7 @@ See [REFERENCE.md](REFERENCE.md) for detailed phase specifications and gate type
|
|
|
45
45
|
|
|
46
46
|
1. **Maintains state.yaml** — Tracks current phase, `active_epic`, `active_flow`, decisions, risks.
|
|
47
47
|
2. **Spawns appropriate skills** — Routes by `model:` frontmatter. Decisions pass only via `specs/state.yaml` `handoff` between spawns.
|
|
48
|
-
3. **Methodology lenses** — If `specs/tech-architecture/
|
|
48
|
+
3. **Methodology lenses** — If `specs/tech-architecture/TEST_PLAN_LATEST.md` or ADRs exist, apply at phase gates.
|
|
49
49
|
4. **Enforces gates** — Hard stops if success criteria not met.
|
|
50
50
|
5. **The Gatekeeper** — Between stories in BUILD: read `specs/execution-status.yaml`; previous story must be `done` before starting the next; use `build-epic` for the 8-step epic cycle.
|
|
51
51
|
6. **Pauses for confirmation** — After each phase, asks "Ready to proceed?".
|
|
@@ -66,10 +66,6 @@ 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
|
-
## Verify
|
|
70
|
-
|
|
71
|
-
→ verify: `test -f orchestrate-project/SKILL.md && grep -q '^name:' orchestrate-project/SKILL.md && echo "OK: orchestrate-project valid" || echo "FAIL: orchestrate-project missing"`
|
|
72
|
-
|
|
73
69
|
---
|
|
74
70
|
|
|
75
71
|
# Orchestrate Reference: Phases, Modes, and Workflows
|
|
@@ -75,10 +75,6 @@ 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
|
-
## Verify
|
|
79
|
-
|
|
80
|
-
→ verify: `test -f organize-workspace/SKILL.md && grep -q '^name:' organize-workspace/SKILL.md && echo "OK: organize-workspace valid" || echo "FAIL: organize-workspace missing"`
|
|
81
|
-
|
|
82
78
|
---
|
|
83
79
|
|
|
84
80
|
# clean-my-room — reference patterns
|
|
@@ -77,5 +77,3 @@ Any further notes about the refactor.
|
|
|
77
77
|
After writing `specs/REFACTOR_LATEST.md`, suggest running `kickoff-branch` next to create a refactor branch.
|
|
78
78
|
|
|
79
79
|
## Verify
|
|
80
|
-
|
|
81
|
-
→ verify: `test -f plan-refactor/SKILL.md && grep -q '^name:' plan-refactor/SKILL.md && echo "OK: plan-refactor valid" || echo "FAIL: plan-refactor missing"`
|
package/.pi/prompts/plan-work.md
CHANGED
|
@@ -52,7 +52,6 @@ After writing capsule tasks, suggest `kickoff-branch` (if not already on a featu
|
|
|
52
52
|
|
|
53
53
|
## Verify
|
|
54
54
|
|
|
55
|
-
→ verify: `test -f plan-work/SKILL.md && grep -q '^name:' plan-work/SKILL.md && echo "OK: plan-work valid" || echo "FAIL: plan-work missing"`
|
|
56
55
|
|
|
57
56
|
|
|
58
57
|
## Handoff
|
package/.pi/prompts/quick-fix.md
CHANGED
|
@@ -94,9 +94,6 @@ Skipped skills (justified for data-only change):
|
|
|
94
94
|
|
|
95
95
|
Invoke `release-branch` to merge and ship.
|
|
96
96
|
|
|
97
|
-
## Verify
|
|
98
|
-
|
|
99
|
-
→ verify: `test -f quick-fix/SKILL.md && grep -q '^name:' quick-fix/SKILL.md && echo "OK: quick-fix valid" || echo "FAIL: quick-fix missing"`
|
|
100
97
|
|
|
101
98
|
## Example
|
|
102
99
|
|
|
@@ -129,7 +129,7 @@ Report: "Branch released. Integrate mode: <solo-local|team-pr>. cwd: $(pwd) on $
|
|
|
129
129
|
|
|
130
130
|
## Verify
|
|
131
131
|
|
|
132
|
-
→ verify: `test -f
|
|
132
|
+
→ verify: `command -v gh >/dev/null 2>&1 && test -f specs/state.yaml && test -d skills/verify-work && echo "OK: release-branch dependencies available" || echo "FAIL"`
|
|
133
133
|
|
|
134
134
|
---
|
|
135
135
|
|
|
@@ -69,7 +69,3 @@ When the reviewer returns:
|
|
|
69
69
|
Pass the reviewer's report to `respond-review` to categorize findings and apply fixes.
|
|
70
70
|
|
|
71
71
|
Report to user: "Review complete. [N] findings: [X] must-fix, [Y] should-fix, [Z] consider. Running respond-review."
|
|
72
|
-
|
|
73
|
-
## Verify
|
|
74
|
-
|
|
75
|
-
→ verify: `test -f request-review/SKILL.md && grep -q '^name:' request-review/SKILL.md && echo "OK: request-review valid" || echo "FAIL: request-review missing"`
|
|
@@ -43,8 +43,8 @@ mkdir -p specs/product specs/product/snapshots specs/epics/archive
|
|
|
43
43
|
mkdir -p specs/tech-architecture specs/adr specs/verifications specs/bugs
|
|
44
44
|
touch specs/product/SCOPE_LATEST.yaml specs/product/VISION_LATEST.yaml specs/product/GLOSSARY_LATEST.yaml
|
|
45
45
|
touch specs/release-plan.yaml specs/execution-status.yaml specs/planning-status.yaml specs/state.yaml
|
|
46
|
-
touch specs/tech-architecture/tech-stack.md specs/tech-architecture/
|
|
47
|
-
touch specs/tech-architecture/
|
|
46
|
+
touch specs/tech-architecture/tech-stack.md specs/tech-architecture/SECURITY_PLAN_LATEST.md
|
|
47
|
+
touch specs/tech-architecture/TEST_PLAN_LATEST.md specs/tech-architecture/DESIGN_PLAN_LATEST.md
|
|
48
48
|
touch specs/tech-architecture/REFACTOR_LATEST.md specs/tech-architecture/IMPACT_LATEST.md
|
|
49
49
|
touch specs/bugs/registry.yaml
|
|
50
50
|
echo "# Specs\n\nAll planning documents for this project." > specs/README.md
|
|
@@ -54,9 +54,6 @@ echo "# Specs\n\nAll planning documents for this project." > specs/README.md
|
|
|
54
54
|
|
|
55
55
|
`specs/state.yaml` carries a top-level `workflow_mode` key (`team-pr` | `solo-git`, default `team-pr`). This is the **canonical integrate-mode signal** for all skills — set it once here and skills such as `release-branch` read it from this file instead of sniffing profile files.
|
|
56
56
|
|
|
57
|
-
## Verify
|
|
58
|
-
|
|
59
|
-
→ verify: `test -f seed-conventions/SKILL.md && grep -q '^name:' seed-conventions/SKILL.md && echo "OK: seed-conventions valid" || echo "FAIL: seed-conventions missing"`
|
|
60
57
|
|
|
61
58
|
|
|
62
59
|
- [ ] CLAUDE.md exists and is populated
|
|
@@ -64,10 +64,6 @@ The `deploy` skill references `smoke-test` as its final verification step:
|
|
|
64
64
|
DEPLOY_URL="$DEPLOY_URL" bash scripts/run-smoke.sh
|
|
65
65
|
```
|
|
66
66
|
|
|
67
|
-
## Verify
|
|
68
|
-
|
|
69
|
-
→ verify: `test -f smoke-test/SKILL.md && grep -q '^name:' smoke-test/SKILL.md && echo "OK: smoke-test valid" || echo "FAIL: smoke-test missing"`
|
|
70
|
-
|
|
71
67
|
---
|
|
72
68
|
|
|
73
69
|
# Smoke Test — Reference
|
|
@@ -92,7 +92,3 @@ After writing the findings, delete or discard the spike code. It is not meant to
|
|
|
92
92
|
### 6. Feed back into plan-work
|
|
93
93
|
|
|
94
94
|
The spike findings are the input to `plan-work`. Call `plan-work` next, informed by `specs/archive/spikes/SPIKE-<name>.md`.
|
|
95
|
-
|
|
96
|
-
## Verify
|
|
97
|
-
|
|
98
|
-
→ verify: `test -f spike-prototype/SKILL.md && grep -q '^name:' spike-prototype/SKILL.md && echo "OK: spike-prototype valid" || echo "FAIL: spike-prototype missing"`
|
|
@@ -103,7 +103,3 @@ Start the HTTP dashboard with `visual-dashboard` → `GET /api/status?projectDir
|
|
|
103
103
|
## After this
|
|
104
104
|
|
|
105
105
|
Call `survey-context` to read your project's current state and get a personalized recommendation for where to go next.
|
|
106
|
-
|
|
107
|
-
## Verify
|
|
108
|
-
|
|
109
|
-
→ verify: `test -f using-bigpowers/SKILL.md && grep -q '^name:' using-bigpowers/SKILL.md && echo "OK: using-bigpowers valid" || echo "FAIL: using-bigpowers missing"`
|
|
@@ -109,10 +109,6 @@ bash scripts/validate-contracts.sh <contract-file>
|
|
|
109
109
|
# → All pass → ready to deploy
|
|
110
110
|
```
|
|
111
111
|
|
|
112
|
-
## Verify
|
|
113
|
-
|
|
114
|
-
→ verify: `test -f validate-contracts/SKILL.md && grep -q '^name:' validate-contracts/SKILL.md && echo "OK: validate-contracts valid" || echo "FAIL: validate-contracts missing"`
|
|
115
|
-
|
|
116
112
|
---
|
|
117
113
|
|
|
118
114
|
# Validate Contracts — Reference
|
|
@@ -101,7 +101,3 @@ Mechanical verification (tests passing) is only half the fix. You must prove **b
|
|
|
101
101
|
- **The verify command from specs/bugs/BUG-*.md or the active epic task `verify` field must pass**
|
|
102
102
|
|
|
103
103
|
Suggest next skill: `audit-code` → `commit-message`.
|
|
104
|
-
|
|
105
|
-
## Verify
|
|
106
|
-
|
|
107
|
-
→ verify: `test -f validate-fix/SKILL.md && grep -q '^name:' validate-fix/SKILL.md && echo "OK: validate-fix valid" || echo "FAIL: validate-fix missing"`
|
|
@@ -90,7 +90,3 @@ Place setup scripts in `scripts/setup.sh` (or language-appropriate equivalent).
|
|
|
90
90
|
- [ ] Run `scripts/setup.sh` twice — second run should produce no errors
|
|
91
91
|
- [ ] Health check command returns success
|
|
92
92
|
- [ ] No sensitive data in log output
|
|
93
|
-
|
|
94
|
-
## Verify
|
|
95
|
-
|
|
96
|
-
→ verify: `test -f wire-observability/SKILL.md && grep -q '^name:' wire-observability/SKILL.md && echo "OK: wire-observability valid" || echo "FAIL: wire-observability missing"`
|
|
@@ -104,7 +104,3 @@ A clean run looks like: `col=0px overlay=0px baseline≤4px ink=0px` → `GRID V
|
|
|
104
104
|
|
|
105
105
|
## CREED
|
|
106
106
|
A grid you can't toggle on and measure is a mood board, not a system. Build it from one source of truth, prove it at 0px, and align the **ink**.
|
|
107
|
-
|
|
108
|
-
## Verify
|
|
109
|
-
|
|
110
|
-
→ verify: `test -f align-grid/SKILL.md && grep -q '^name:' align-grid/SKILL.md && echo "OK: align-grid valid" || echo "FAIL: align-grid missing"`
|
|
@@ -123,7 +123,7 @@ Aggregate exit code: `0` if all sections PASS, `1` (non-zero) if any section FAI
|
|
|
123
123
|
|
|
124
124
|
## Verify
|
|
125
125
|
|
|
126
|
-
→ verify: `test -f
|
|
126
|
+
→ verify: `test -f CONVENTIONS.md && test -d skills/enforce-first && test -d skills/request-review && echo "OK: audit-code dependencies present" || echo "FAIL"`
|
|
127
127
|
|
|
128
128
|
|
|
129
129
|
## Handoff
|
|
@@ -78,4 +78,4 @@ Write `handoff.next_skill` and `handoff.context` in `state.yaml` when pausing mi
|
|
|
78
78
|
|
|
79
79
|
## Verify
|
|
80
80
|
|
|
81
|
-
→ verify: `test -f
|
|
81
|
+
→ verify: `test -f specs/state.yaml && test -f specs/execution-status.yaml && test -f specs/release-plan.yaml && test -d skills/assess-impact && test -d skills/audit-code && test -d skills/security-review && echo "OK: build-epic dependencies present" || echo "FAIL"`
|
|
@@ -48,9 +48,6 @@ If the repo uses a custom `@semantic-release/commit-analyzer` preset, note that
|
|
|
48
48
|
|
|
49
49
|
- [REFERENCE.md](REFERENCE.md) — Message shape, footers, release mapping, squashing notes.
|
|
50
50
|
|
|
51
|
-
## Verify
|
|
52
|
-
|
|
53
|
-
→ verify: `test -f commit-message/SKILL.md && grep -q '^name:' commit-message/SKILL.md && echo "OK: commit-message valid" || echo "FAIL: commit-message missing"`
|
|
54
51
|
|
|
55
52
|
|
|
56
53
|
## Handoff
|
|
@@ -60,10 +60,6 @@ After drafting, verify:
|
|
|
60
60
|
- [ ] specs/ output documented if applicable
|
|
61
61
|
- [ ] `sync-skills.sh` run to propagate to Cursor/Gemini
|
|
62
62
|
|
|
63
|
-
## Verify
|
|
64
|
-
|
|
65
|
-
→ verify: `test -f craft-skill/SKILL.md && grep -q '^name:' craft-skill/SKILL.md && echo "OK: craft-skill valid" || echo "FAIL: craft-skill missing"`
|
|
66
|
-
|
|
67
63
|
---
|
|
68
64
|
|
|
69
65
|
# Craft Skill — Reference
|
|
@@ -93,10 +93,6 @@ Side effects happen inline as decisions crystallize:
|
|
|
93
93
|
- **User rejects the candidate with a load-bearing reason?** Offer an ADR, framed as: _"Want me to record this as an ADR so future architecture reviews don't re-suggest it?"_ Only offer when the reason would actually be needed by a future explorer. See [ADR-FORMAT.md](../model-domain/ADR-FORMAT.md).
|
|
94
94
|
- **Want to explore alternative interfaces for the deepened module?** See [INTERFACE-DESIGN.md](INTERFACE-DESIGN.md).
|
|
95
95
|
|
|
96
|
-
## Verify
|
|
97
|
-
|
|
98
|
-
→ verify: `test -f deepen-architecture/SKILL.md && grep -q '^name:' deepen-architecture/SKILL.md && echo "OK: deepen-architecture valid" || echo "FAIL: deepen-architecture missing"`
|
|
99
|
-
|
|
100
96
|
---
|
|
101
97
|
|
|
102
98
|
# Deepening
|
|
@@ -79,7 +79,3 @@ When invoked again in the same conversation:
|
|
|
79
79
|
3. Update definitions if understanding has evolved
|
|
80
80
|
4. Re-flag any new ambiguities
|
|
81
81
|
5. Rewrite the example dialogue to incorporate new terms
|
|
82
|
-
|
|
83
|
-
## Verify
|
|
84
|
-
|
|
85
|
-
→ verify: `test -f define-language/SKILL.md && grep -q '^name:' define-language/SKILL.md && echo "OK: define-language valid" || echo "FAIL: define-language missing"`
|
|
@@ -64,5 +64,3 @@ Present the pairs to the user and ask: "Does this capture everything the task re
|
|
|
64
64
|
Once confirmed, these pairs become the skeleton for `plan-work`'s steps. Pass them along when calling `plan-work`.
|
|
65
65
|
|
|
66
66
|
## Verify
|
|
67
|
-
|
|
68
|
-
→ verify: `test -f define-success/SKILL.md && grep -q '^name:' define-success/SKILL.md && echo "OK: define-success valid" || echo "FAIL: define-success missing"`
|
|
@@ -105,10 +105,6 @@ For comprehensive health-checking, chain to the `smoke-test` skill:
|
|
|
105
105
|
bash scripts/run-smoke.sh "$DEPLOY_URL"
|
|
106
106
|
```
|
|
107
107
|
|
|
108
|
-
## Verify
|
|
109
|
-
|
|
110
|
-
→ verify: `test -f deploy/SKILL.md && grep -q '^name:' deploy/SKILL.md && echo "OK: deploy valid" || echo "FAIL: deploy missing"`
|
|
111
|
-
|
|
112
108
|
---
|
|
113
109
|
|
|
114
110
|
# Deploy — Reference
|
|
@@ -96,7 +96,3 @@ From "A Philosophy of Software Design":
|
|
|
96
96
|
- Don't skip comparison — the value is in contrast
|
|
97
97
|
- Don't implement — this is purely about interface shape
|
|
98
98
|
- Don't evaluate based on implementation effort
|
|
99
|
-
|
|
100
|
-
## Verify
|
|
101
|
-
|
|
102
|
-
→ verify: `test -f design-interface/SKILL.md && grep -q '^name:' design-interface/SKILL.md && echo "OK: design-interface valid" || echo "FAIL: design-interface missing"`
|
|
@@ -95,9 +95,6 @@ If this cycle modified files in `.github/workflows/`, run the CI dry-run procedu
|
|
|
95
95
|
[ ] verify: command passes
|
|
96
96
|
```
|
|
97
97
|
|
|
98
|
-
## Verify
|
|
99
|
-
|
|
100
|
-
→ verify: `test -f develop-tdd/SKILL.md && grep -q '^name:' develop-tdd/SKILL.md && echo "OK: develop-tdd valid" || echo "FAIL: develop-tdd missing"`
|
|
101
98
|
|
|
102
99
|
|
|
103
100
|
## Handoff
|
|
@@ -83,7 +83,3 @@ When all agents return:
|
|
|
83
83
|
Merge accepted results. If any agent's result conflicts with another, resolve manually and note the conflict.
|
|
84
84
|
|
|
85
85
|
Report a summary: which tasks succeeded, which need revision, and overall verify status.
|
|
86
|
-
|
|
87
|
-
## Verify
|
|
88
|
-
|
|
89
|
-
→ verify: `test -f dispatch-agents/SKILL.md && grep -q '^name:' dispatch-agents/SKILL.md && echo "OK: dispatch-agents valid" || echo "FAIL: dispatch-agents missing"`
|
|
@@ -22,7 +22,3 @@ Confirm the sections with the user.
|
|
|
22
22
|
2. For each section:
|
|
23
23
|
|
|
24
24
|
2a. Rewrite the section to improve clarity, coherence, and flow. Use maximum 240 characters per paragraph.
|
|
25
|
-
|
|
26
|
-
## Verify
|
|
27
|
-
|
|
28
|
-
→ verify: `test -f edit-document/SKILL.md && grep -q '^name:' edit-document/SKILL.md && echo "OK: edit-document valid" || echo "FAIL: edit-document missing"`
|
|
@@ -100,7 +100,3 @@ Once the spec is clear, recommend the next step:
|
|
|
100
100
|
- If a spike is needed first → `spike-prototype`
|
|
101
101
|
- If architecture decisions are needed → `deepen-architecture` or `grill-me`
|
|
102
102
|
- If the plan depends on a specific library or API → `grill-me` in docs mode
|
|
103
|
-
|
|
104
|
-
## Verify
|
|
105
|
-
|
|
106
|
-
→ verify: `test -f elaborate-spec/SKILL.md && grep -q '^name:' elaborate-spec/SKILL.md && echo "OK: elaborate-spec valid" || echo "FAIL: elaborate-spec missing"`
|