bigpowers 2.33.0 → 2.34.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/migrate-spec.md +28 -1
- package/.pi/skills/migrate-spec/SKILL.md +28 -1
- package/CHANGELOG.md +14 -0
- package/SKILL-INDEX.md +1 -1
- package/migrate-spec/REFERENCE.md +1 -1
- package/migrate-spec/SKILL.md +27 -0
- package/migrate-spec/templates/METHODOLOGY_LATEST.md +92 -0
- package/package.json +3 -2
- package/skills-lock.json +1 -1
package/.pi/package.json
CHANGED
|
@@ -234,6 +234,33 @@ If **no**, skip the two-pass gate. Proceed directly to plan-work.
|
|
|
234
234
|
|
|
235
235
|
→ verify: `grep -q 'two_pass_spec:' specs/state.yaml && echo "two-pass gate initialized" || echo "two-pass gate not activated"`
|
|
236
236
|
|
|
237
|
+
### Step 8 — Post-migration: Optional methodology doc template
|
|
238
|
+
|
|
239
|
+
After Steps 1–7, offer the user an optional analytical framework scaffold (GSD learning):
|
|
240
|
+
|
|
241
|
+
Prompt: "Create a methodology doc? [yes / no]"
|
|
242
|
+
|
|
243
|
+
If **yes**, present a checklist of analytical lenses:
|
|
244
|
+
|
|
245
|
+
```
|
|
246
|
+
Which lenses to include in specs/tech-architecture/METHODOLOGY_LATEST.md?
|
|
247
|
+
|
|
248
|
+
[x] Cost of Delay (CD3) — Priority & trade-off assessment
|
|
249
|
+
[ ] STRIDE — Security threat modeling
|
|
250
|
+
[ ] F.I.R.S.T — Test quality principles
|
|
251
|
+
[ ] Bayesian Updating — Probabilistic decision-making
|
|
252
|
+
[ ] OWASP Top 10 — Web security framework
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
Copy the template from `migrate-spec/templates/METHODOLOGY_LATEST.md` to `specs/tech-architecture/METHODOLOGY_LATEST.md`.
|
|
256
|
+
- Active lenses remain uncommented
|
|
257
|
+
- Unselected lenses are left commented out
|
|
258
|
+
- Populate `{{project_name}}` with the migrated project's name
|
|
259
|
+
|
|
260
|
+
If **no**, skip. Add note to handoff: "Methodology doc: skipped — can be added later via `cp migrate-spec/templates/METHODOLOGY_LATEST.md specs/tech-architecture/`"
|
|
261
|
+
|
|
262
|
+
→ verify: `test -f specs/tech-architecture/METHODOLOGY_LATEST.md && echo "methodology doc created" || echo "methodology doc skipped"`
|
|
263
|
+
|
|
237
264
|
|
|
238
265
|
## Artifact Mapping Summary
|
|
239
266
|
|
|
@@ -535,7 +562,7 @@ Optional enhancements to offer the user after migration. Present as checkboxes.
|
|
|
535
562
|
|
|
536
563
|
### From GSD
|
|
537
564
|
|
|
538
|
-
- [
|
|
565
|
+
- [x] **`specs/tech-architecture/METHODOLOGY_LATEST.md`** — Standing analytical lenses. Agents read before planning. (adopted: optional Step 8 template scaffold)
|
|
539
566
|
- [x] **`handoff` block in state.yaml** — Last skill, last step, required reading for next session. (adopted: mandatory in Step 4 output)
|
|
540
567
|
- [x] **ID tracking in SCOPE_LATEST.yaml** — FR/UJ IDs for spec → plan → verification traceability. (adopted in Step 3 transform)
|
|
541
568
|
|
|
@@ -236,6 +236,33 @@ If **no**, skip the two-pass gate. Proceed directly to plan-work.
|
|
|
236
236
|
|
|
237
237
|
→ verify: `grep -q 'two_pass_spec:' specs/state.yaml && echo "two-pass gate initialized" || echo "two-pass gate not activated"`
|
|
238
238
|
|
|
239
|
+
### Step 8 — Post-migration: Optional methodology doc template
|
|
240
|
+
|
|
241
|
+
After Steps 1–7, offer the user an optional analytical framework scaffold (GSD learning):
|
|
242
|
+
|
|
243
|
+
Prompt: "Create a methodology doc? [yes / no]"
|
|
244
|
+
|
|
245
|
+
If **yes**, present a checklist of analytical lenses:
|
|
246
|
+
|
|
247
|
+
```
|
|
248
|
+
Which lenses to include in specs/tech-architecture/METHODOLOGY_LATEST.md?
|
|
249
|
+
|
|
250
|
+
[x] Cost of Delay (CD3) — Priority & trade-off assessment
|
|
251
|
+
[ ] STRIDE — Security threat modeling
|
|
252
|
+
[ ] F.I.R.S.T — Test quality principles
|
|
253
|
+
[ ] Bayesian Updating — Probabilistic decision-making
|
|
254
|
+
[ ] OWASP Top 10 — Web security framework
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
Copy the template from `migrate-spec/templates/METHODOLOGY_LATEST.md` to `specs/tech-architecture/METHODOLOGY_LATEST.md`.
|
|
258
|
+
- Active lenses remain uncommented
|
|
259
|
+
- Unselected lenses are left commented out
|
|
260
|
+
- Populate `{{project_name}}` with the migrated project's name
|
|
261
|
+
|
|
262
|
+
If **no**, skip. Add note to handoff: "Methodology doc: skipped — can be added later via `cp migrate-spec/templates/METHODOLOGY_LATEST.md specs/tech-architecture/`"
|
|
263
|
+
|
|
264
|
+
→ verify: `test -f specs/tech-architecture/METHODOLOGY_LATEST.md && echo "methodology doc created" || echo "methodology doc skipped"`
|
|
265
|
+
|
|
239
266
|
|
|
240
267
|
## Artifact Mapping Summary
|
|
241
268
|
|
|
@@ -537,7 +564,7 @@ Optional enhancements to offer the user after migration. Present as checkboxes.
|
|
|
537
564
|
|
|
538
565
|
### From GSD
|
|
539
566
|
|
|
540
|
-
- [
|
|
567
|
+
- [x] **`specs/tech-architecture/METHODOLOGY_LATEST.md`** — Standing analytical lenses. Agents read before planning. (adopted: optional Step 8 template scaffold)
|
|
541
568
|
- [x] **`handoff` block in state.yaml** — Last skill, last step, required reading for next session. (adopted: mandatory in Step 4 output)
|
|
542
569
|
- [x] **ID tracking in SCOPE_LATEST.yaml** — FR/UJ IDs for spec → plan → verification traceability. (adopted in Step 3 transform)
|
|
543
570
|
|
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,17 @@
|
|
|
1
|
+
## [2.34.1](https://github.com/danielvm-git/bigpowers/compare/v2.34.0...v2.34.1) (2026-06-26)
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
### Bug Fixes
|
|
5
|
+
|
|
6
|
+
* **dashboard:** expose bigpowers-dashboard as global CLI bin entry ([7018583](https://github.com/danielvm-git/bigpowers/commit/7018583848807b80e9dd16e1e6ddf4e4bbe3c635))
|
|
7
|
+
|
|
8
|
+
# [2.34.0](https://github.com/danielvm-git/bigpowers/compare/v2.33.0...v2.34.0) (2026-06-26)
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
### Features
|
|
12
|
+
|
|
13
|
+
* **migrate-spec:** add methodology doc template scaffold ([beba70c](https://github.com/danielvm-git/bigpowers/commit/beba70cbc6a4728aff8b121668440af7ca8abf45))
|
|
14
|
+
|
|
1
15
|
# [2.33.0](https://github.com/danielvm-git/bigpowers/compare/v2.32.0...v2.33.0) (2026-06-26)
|
|
2
16
|
|
|
3
17
|
|
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-26T23:
|
|
6
|
+
**Generated:** 2026-06-26T23:52:38Z
|
|
7
7
|
**Skills:** 70
|
|
8
8
|
|
|
9
9
|
---
|
|
@@ -132,7 +132,7 @@ Optional enhancements to offer the user after migration. Present as checkboxes.
|
|
|
132
132
|
|
|
133
133
|
### From GSD
|
|
134
134
|
|
|
135
|
-
- [
|
|
135
|
+
- [x] **`specs/tech-architecture/METHODOLOGY_LATEST.md`** — Standing analytical lenses. Agents read before planning. (adopted: optional Step 8 template scaffold)
|
|
136
136
|
- [x] **`handoff` block in state.yaml** — Last skill, last step, required reading for next session. (adopted: mandatory in Step 4 output)
|
|
137
137
|
- [x] **ID tracking in SCOPE_LATEST.yaml** — FR/UJ IDs for spec → plan → verification traceability. (adopted in Step 3 transform)
|
|
138
138
|
|
package/migrate-spec/SKILL.md
CHANGED
|
@@ -237,6 +237,33 @@ If **no**, skip the two-pass gate. Proceed directly to plan-work.
|
|
|
237
237
|
|
|
238
238
|
→ verify: `grep -q 'two_pass_spec:' specs/state.yaml && echo "two-pass gate initialized" || echo "two-pass gate not activated"`
|
|
239
239
|
|
|
240
|
+
### Step 8 — Post-migration: Optional methodology doc template
|
|
241
|
+
|
|
242
|
+
After Steps 1–7, offer the user an optional analytical framework scaffold (GSD learning):
|
|
243
|
+
|
|
244
|
+
Prompt: "Create a methodology doc? [yes / no]"
|
|
245
|
+
|
|
246
|
+
If **yes**, present a checklist of analytical lenses:
|
|
247
|
+
|
|
248
|
+
```
|
|
249
|
+
Which lenses to include in specs/tech-architecture/METHODOLOGY_LATEST.md?
|
|
250
|
+
|
|
251
|
+
[x] Cost of Delay (CD3) — Priority & trade-off assessment
|
|
252
|
+
[ ] STRIDE — Security threat modeling
|
|
253
|
+
[ ] F.I.R.S.T — Test quality principles
|
|
254
|
+
[ ] Bayesian Updating — Probabilistic decision-making
|
|
255
|
+
[ ] OWASP Top 10 — Web security framework
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
Copy the template from `migrate-spec/templates/METHODOLOGY_LATEST.md` to `specs/tech-architecture/METHODOLOGY_LATEST.md`.
|
|
259
|
+
- Active lenses remain uncommented
|
|
260
|
+
- Unselected lenses are left commented out
|
|
261
|
+
- Populate `{{project_name}}` with the migrated project's name
|
|
262
|
+
|
|
263
|
+
If **no**, skip. Add note to handoff: "Methodology doc: skipped — can be added later via `cp migrate-spec/templates/METHODOLOGY_LATEST.md specs/tech-architecture/`"
|
|
264
|
+
|
|
265
|
+
→ verify: `test -f specs/tech-architecture/METHODOLOGY_LATEST.md && echo "methodology doc created" || echo "methodology doc skipped"`
|
|
266
|
+
|
|
240
267
|
---
|
|
241
268
|
|
|
242
269
|
## Artifact Mapping Summary
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
# Methodology — {{project_name}}
|
|
2
|
+
|
|
3
|
+
The following analytical lenses should inform `plan-work` and `audit-code` sessions.
|
|
4
|
+
|
|
5
|
+
## Cost of Delay (CD3)
|
|
6
|
+
|
|
7
|
+
**CD3 = Value / Duration**
|
|
8
|
+
|
|
9
|
+
Use this lens when:
|
|
10
|
+
- Prioritizing epics by business impact
|
|
11
|
+
- Assessing the cost of deferring a story
|
|
12
|
+
- Making trade-off decisions between scope and schedule
|
|
13
|
+
|
|
14
|
+
Example: A feature with $10k business value and 5-day delivery window has CD3 = $10k / 5d = $2k/day.
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## STRIDE (Security Threats)
|
|
19
|
+
|
|
20
|
+
Structured threat modeling framework for API, auth, and data-handling code.
|
|
21
|
+
|
|
22
|
+
- **Spoofing:** Can an attacker impersonate a user or service?
|
|
23
|
+
- **Tampering:** Can an attacker modify data in transit or at rest?
|
|
24
|
+
- **Repudiation:** Can an attacker deny performing an action?
|
|
25
|
+
- **Information Disclosure:** Can an attacker access sensitive data?
|
|
26
|
+
- **Denial of Service:** Can an attacker disrupt service availability?
|
|
27
|
+
- **Elevation of Privilege:** Can an attacker gain admin or elevated access?
|
|
28
|
+
|
|
29
|
+
Use STRIDE to review `specs/tech-architecture/TECH_STACK_LATEST.md` and spot-check `develop-tdd` for auth/API changes.
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## F.I.R.S.T (Test Principles)
|
|
34
|
+
|
|
35
|
+
Verify that all tests in the codebase are:
|
|
36
|
+
|
|
37
|
+
- **Fast:** Run in under 5 seconds per test
|
|
38
|
+
- **Independent:** No shared state or test interdependencies
|
|
39
|
+
- **Repeatable:** Same result every run, no flaky timeouts
|
|
40
|
+
- **Self-Validating:** Assert on observable outcomes (return values, API responses, UI state)
|
|
41
|
+
- **Timely:** Written alongside code (test-first in `develop-tdd`)
|
|
42
|
+
|
|
43
|
+
Use F.I.R.S.T to review test suites in `audit-code` step.
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## Optional: Bayesian Updating
|
|
48
|
+
|
|
49
|
+
<!--
|
|
50
|
+
When evidence is ambiguous, use Bayesian reasoning to update your confidence:
|
|
51
|
+
|
|
52
|
+
P(hypothesis | evidence) = P(evidence | hypothesis) × P(hypothesis) / P(evidence)
|
|
53
|
+
|
|
54
|
+
Example: "We think this epic has low risk (10% prior). Code review finds 3 SQL injection opportunities. How does that shift our confidence?"
|
|
55
|
+
|
|
56
|
+
P(high-risk | code-review-findings) = P(findings | high-risk) × P(high-risk) / P(findings)
|
|
57
|
+
= 0.7 × 0.1 / 0.15 = 47%
|
|
58
|
+
|
|
59
|
+
Update: high risk is now more likely than the 10% prior.
|
|
60
|
+
-->
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## Optional: Threat Modeling (OWASP Top 10)
|
|
65
|
+
|
|
66
|
+
<!--
|
|
67
|
+
For projects with sensitive data or external APIs, model threats per OWASP Top 10:
|
|
68
|
+
|
|
69
|
+
1. **Injection** — Can attackers inject SQL, NoSQL, command shell, LDAP?
|
|
70
|
+
2. **Broken Authentication** — Session management, MFA, password handling?
|
|
71
|
+
3. **Sensitive Data Exposure** — Encryption, tokenization, data classification?
|
|
72
|
+
4. **XML External Entities (XXE)** — XML parsing, file uploads?
|
|
73
|
+
5. **Broken Access Control** — Role-based access, scope, delegation?
|
|
74
|
+
6. **Security Misconfiguration** — Default credentials, error messages, headers?
|
|
75
|
+
7. **Cross-Site Scripting (XSS)** — Untrusted data, sanitization, CSP?
|
|
76
|
+
8. **Insecure Deserialization** — Object deserialization, pickle, YAML?
|
|
77
|
+
9. **Using Components with Known Vulnerabilities** — Dependencies, versions?
|
|
78
|
+
10. **Insufficient Logging & Monitoring** — Audit trails, alerting, incident response?
|
|
79
|
+
|
|
80
|
+
Document mitigations in `specs/tech-architecture/TECH_STACK_LATEST.md`.
|
|
81
|
+
-->
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## Using This Document
|
|
86
|
+
|
|
87
|
+
Before starting a phase:
|
|
88
|
+
- Read the relevant sections of this document
|
|
89
|
+
- In `plan-work`, ensure every task considers the applicable lens
|
|
90
|
+
- In `audit-code`, verify that completed work passes the lens checks
|
|
91
|
+
|
|
92
|
+
Update this document as new analytical frameworks emerge or prove valuable.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "bigpowers",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.34.1",
|
|
4
4
|
"description": "61 agent skills for spec-driven, test-first software development by solo developers",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"scripts": {
|
|
@@ -44,7 +44,8 @@
|
|
|
44
44
|
"url": "https://github.com/danielvm-git/bigpowers.git"
|
|
45
45
|
},
|
|
46
46
|
"bin": {
|
|
47
|
-
"bigpowers": "./bin/bigpowers.js"
|
|
47
|
+
"bigpowers": "./bin/bigpowers.js",
|
|
48
|
+
"bigpowers-dashboard": "./dashboard/bin/dashboard.js"
|
|
48
49
|
},
|
|
49
50
|
"engines": {
|
|
50
51
|
"node": ">=14.0.0"
|
package/skills-lock.json
CHANGED
|
@@ -163,7 +163,7 @@
|
|
|
163
163
|
},
|
|
164
164
|
"migrate-spec": {
|
|
165
165
|
"description": "Detect GSD, spec-kit, or BMAD spec artifacts and transform them into bigpowers YAML layout (state.yaml, release-plan.yaml, epics/, requirements/, plans/, ADRs). Use when migrating foreign spec docs.",
|
|
166
|
-
"sha256": "
|
|
166
|
+
"sha256": "7636756cd3421b20",
|
|
167
167
|
"path": "migrate-spec/SKILL.md"
|
|
168
168
|
},
|
|
169
169
|
"model-domain": {
|