bigpowers 2.29.0 → 2.30.0

package/.pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.29.0",
+  "version": "2.30.0",
   "description": "70 skills — 61 agent skills for spec-driven, test-first software development by solo developers",
   "keywords": [
     "pi-package"

package/.pi/prompts/migrate-spec.md

@@ -93,6 +93,31 @@ in_scope:
 
 See [REFERENCE.md — in_scope format with ID tracking](./REFERENCE.md#in_scope-format-with-id-tracking) for examples.
 
+#### Traceability Output (FR-XX, UJ-XX)
+
+When source has FR-XX or UJ-XX IDs, emit `specs/product/REQUIREMENTS_TRACE.yaml` for end-to-end requirement traceability:
+
+```yaml
+trace:
+  - id: FR-001
+    type: functional_requirement
+    description: "User can register with email/password"
+    epic: e02-auth-ui
+    story: e02s01
+    verify: "grep -q 'FR-001' specs/product/SCOPE_LATEST.yaml && echo OK"
+  - id: UJ-001
+    type: user_journey
+    description: "New user completes registration flow"
+    epic: e02-auth-ui
+    story: e02s01
+```
+
+**Existing trace file:** If `REQUIREMENTS_TRACE.yaml` already exists, prompt: "REQUIREMENTS_TRACE.yaml exists. [overwrite / merge / skip]"
+
+**No FR-XX/UJ-XX found:** Skip trace file; add note to state.yaml handoff: "No FR-XX/UJ-XX IDs found — traceability file skipped".
+
+See [REFERENCE.md — REQUIREMENTS_TRACE.yaml format](./REFERENCE.md#requirements_traceyaml-format) for the complete schema.
+
 > **HARD GATE** — Never overwrite an existing `specs/` file without explicit user confirmation. Merge into it if it exists; don't clobber.
 >
 > → verify: `git diff --name-only HEAD -- specs/ 2>/dev/null | head -20`
@@ -436,7 +461,7 @@ Optional enhancements to offer the user after migration. Present as checkboxes.
 
 ### From BMAD
 
-- [ ] **FR-XX + UJ-XX in SCOPE_LATEST.yaml** — Rigorous traceability.
+- [x] **FR-XX + UJ-XX in SCOPE_LATEST.yaml** — Rigorous traceability. (adopted: REQUIREMENTS_TRACE.yaml emitted on migration)
 - [ ] **`specs/DECISION-LOG.md`** — Lightweight decisions below ADR threshold.
 - [ ] **Adversarial review pass** — Critique epic shard before `develop-tdd`.
 
@@ -497,6 +522,41 @@ in_scope:
 
 **When source has mixed IDs:** Entries with source IDs get `id:` fields; entries without IDs receive auto-generated IDs. A comment block at the top of `in_scope` documents which IDs were auto-generated.
 
+### REQUIREMENTS_TRACE.yaml format
+
+Emitted when source has FR-XX (functional requirement) or UJ-XX (user journey) IDs. Maps source requirements to bigpowers epic/story structure and verification commands:
+
+```yaml
+trace:
+  # Functional Requirements
+  - id: FR-001
+    type: functional_requirement
+    description: "User can register with email/password"
+    source_artifact: "prd.md"
+    epic: "e02-auth-ui"
+    story: "e02s01"
+    verify: "grep -q 'FR-001' specs/product/SCOPE_LATEST.yaml && echo OK"
+
+  # User Journeys
+  - id: UJ-001
+    type: user_journey
+    description: "New user completes registration flow"
+    source_artifact: "epic-auth-ui.md"
+    epic: "e02-auth-ui"
+    story: "e02s01"
+    verify: "grep -q 'UJ-001' specs/epics/e02-auth-ui/epic.yaml && echo OK"
+
+metadata:
+  source_framework: "BMAD"
+  migrated_at: "2026-06-26T12:00:00Z"
+  total_requirements: 2
+  coverage: "All FR-XX and UJ-XX IDs from source mapped"
+```
+
+**When source has no FR-XX/UJ-XX:** Skip REQUIREMENTS_TRACE.yaml. Add note to `state.yaml` handoff: "No FR-XX/UJ-XX IDs found — traceability file skipped".
+
+**Existing trace file:** If REQUIREMENTS_TRACE.yaml exists, prompt user: "Overwrite? [yes / merge / skip]". Merge appends new entries; skip leaves existing file intact.
+
 ### `specs/state.yaml` template format
 
 Generated during Step 4 of migration. Regenerate from scratch in bigpowers format:

package/.pi/skills/migrate-spec/SKILL.md

@@ -95,6 +95,31 @@ in_scope:
 
 See [REFERENCE.md — in_scope format with ID tracking](./REFERENCE.md#in_scope-format-with-id-tracking) for examples.
 
+#### Traceability Output (FR-XX, UJ-XX)
+
+When source has FR-XX or UJ-XX IDs, emit `specs/product/REQUIREMENTS_TRACE.yaml` for end-to-end requirement traceability:
+
+```yaml
+trace:
+  - id: FR-001
+    type: functional_requirement
+    description: "User can register with email/password"
+    epic: e02-auth-ui
+    story: e02s01
+    verify: "grep -q 'FR-001' specs/product/SCOPE_LATEST.yaml && echo OK"
+  - id: UJ-001
+    type: user_journey
+    description: "New user completes registration flow"
+    epic: e02-auth-ui
+    story: e02s01
+```
+
+**Existing trace file:** If `REQUIREMENTS_TRACE.yaml` already exists, prompt: "REQUIREMENTS_TRACE.yaml exists. [overwrite / merge / skip]"
+
+**No FR-XX/UJ-XX found:** Skip trace file; add note to state.yaml handoff: "No FR-XX/UJ-XX IDs found — traceability file skipped".
+
+See [REFERENCE.md — REQUIREMENTS_TRACE.yaml format](./REFERENCE.md#requirements_traceyaml-format) for the complete schema.
+
 > **HARD GATE** — Never overwrite an existing `specs/` file without explicit user confirmation. Merge into it if it exists; don't clobber.
 >
 > → verify: `git diff --name-only HEAD -- specs/ 2>/dev/null | head -20`
@@ -438,7 +463,7 @@ Optional enhancements to offer the user after migration. Present as checkboxes.
 
 ### From BMAD
 
-- [ ] **FR-XX + UJ-XX in SCOPE_LATEST.yaml** — Rigorous traceability.
+- [x] **FR-XX + UJ-XX in SCOPE_LATEST.yaml** — Rigorous traceability. (adopted: REQUIREMENTS_TRACE.yaml emitted on migration)
 - [ ] **`specs/DECISION-LOG.md`** — Lightweight decisions below ADR threshold.
 - [ ] **Adversarial review pass** — Critique epic shard before `develop-tdd`.
 
@@ -499,6 +524,41 @@ in_scope:
 
 **When source has mixed IDs:** Entries with source IDs get `id:` fields; entries without IDs receive auto-generated IDs. A comment block at the top of `in_scope` documents which IDs were auto-generated.
 
+### REQUIREMENTS_TRACE.yaml format
+
+Emitted when source has FR-XX (functional requirement) or UJ-XX (user journey) IDs. Maps source requirements to bigpowers epic/story structure and verification commands:
+
+```yaml
+trace:
+  # Functional Requirements
+  - id: FR-001
+    type: functional_requirement
+    description: "User can register with email/password"
+    source_artifact: "prd.md"
+    epic: "e02-auth-ui"
+    story: "e02s01"
+    verify: "grep -q 'FR-001' specs/product/SCOPE_LATEST.yaml && echo OK"
+
+  # User Journeys
+  - id: UJ-001
+    type: user_journey
+    description: "New user completes registration flow"
+    source_artifact: "epic-auth-ui.md"
+    epic: "e02-auth-ui"
+    story: "e02s01"
+    verify: "grep -q 'UJ-001' specs/epics/e02-auth-ui/epic.yaml && echo OK"
+
+metadata:
+  source_framework: "BMAD"
+  migrated_at: "2026-06-26T12:00:00Z"
+  total_requirements: 2
+  coverage: "All FR-XX and UJ-XX IDs from source mapped"
+```
+
+**When source has no FR-XX/UJ-XX:** Skip REQUIREMENTS_TRACE.yaml. Add note to `state.yaml` handoff: "No FR-XX/UJ-XX IDs found — traceability file skipped".
+
+**Existing trace file:** If REQUIREMENTS_TRACE.yaml exists, prompt user: "Overwrite? [yes / merge / skip]". Merge appends new entries; skip leaves existing file intact.
+
 ### `specs/state.yaml` template format
 
 Generated during Step 4 of migration. Regenerate from scratch in bigpowers format:

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [2.30.0](https://github.com/danielvm-git/bigpowers/compare/v2.29.0...v2.30.0) (2026-06-26)
+
+
+### Features
+
+* **migrate-spec:** emit REQUIREMENTS_TRACE.yaml for FR-XX/UJ-XX IDs ([955a1fd](https://github.com/danielvm-git/bigpowers/commit/955a1fd37b898ec70a86895d8772f0ec6fb8a0fa))
+
 # [2.29.0](https://github.com/danielvm-git/bigpowers/compare/v2.28.0...v2.29.0) (2026-06-26)
 
 

package/SKILL-INDEX.md

@@ -3,7 +3,7 @@
 > **DO NOT EDIT** — This file is auto-generated by `scripts/generate-skill-index.sh`.
 > Edit `SKILL.md` source files or `skills-lock.json` instead. Run `bash scripts/sync-skills.sh` to regenerate.
 
-**Generated:** 2026-06-26T22:20:53Z
+**Generated:** 2026-06-26T22:23:41Z
 **Skills:** 70
 
 ---

package/migrate-spec/REFERENCE.md

@@ -144,7 +144,7 @@ Optional enhancements to offer the user after migration. Present as checkboxes.
 
 ### From BMAD
 
-- [ ] **FR-XX + UJ-XX in SCOPE_LATEST.yaml** — Rigorous traceability.
+- [x] **FR-XX + UJ-XX in SCOPE_LATEST.yaml** — Rigorous traceability. (adopted: REQUIREMENTS_TRACE.yaml emitted on migration)
 - [ ] **`specs/DECISION-LOG.md`** — Lightweight decisions below ADR threshold.
 - [ ] **Adversarial review pass** — Critique epic shard before `develop-tdd`.
 
@@ -205,6 +205,41 @@ in_scope:
 
 **When source has mixed IDs:** Entries with source IDs get `id:` fields; entries without IDs receive auto-generated IDs. A comment block at the top of `in_scope` documents which IDs were auto-generated.
 
+### REQUIREMENTS_TRACE.yaml format
+
+Emitted when source has FR-XX (functional requirement) or UJ-XX (user journey) IDs. Maps source requirements to bigpowers epic/story structure and verification commands:
+
+```yaml
+trace:
+  # Functional Requirements
+  - id: FR-001
+    type: functional_requirement
+    description: "User can register with email/password"
+    source_artifact: "prd.md"
+    epic: "e02-auth-ui"
+    story: "e02s01"
+    verify: "grep -q 'FR-001' specs/product/SCOPE_LATEST.yaml && echo OK"
+
+  # User Journeys
+  - id: UJ-001
+    type: user_journey
+    description: "New user completes registration flow"
+    source_artifact: "epic-auth-ui.md"
+    epic: "e02-auth-ui"
+    story: "e02s01"
+    verify: "grep -q 'UJ-001' specs/epics/e02-auth-ui/epic.yaml && echo OK"
+
+metadata:
+  source_framework: "BMAD"
+  migrated_at: "2026-06-26T12:00:00Z"
+  total_requirements: 2
+  coverage: "All FR-XX and UJ-XX IDs from source mapped"
+```
+
+**When source has no FR-XX/UJ-XX:** Skip REQUIREMENTS_TRACE.yaml. Add note to `state.yaml` handoff: "No FR-XX/UJ-XX IDs found — traceability file skipped".
+
+**Existing trace file:** If REQUIREMENTS_TRACE.yaml exists, prompt user: "Overwrite? [yes / merge / skip]". Merge appends new entries; skip leaves existing file intact.
+
 ### `specs/state.yaml` template format
 
 Generated during Step 4 of migration. Regenerate from scratch in bigpowers format:

package/migrate-spec/SKILL.md

@@ -96,6 +96,31 @@ in_scope:
 
 See [REFERENCE.md — in_scope format with ID tracking](./REFERENCE.md#in_scope-format-with-id-tracking) for examples.
 
+#### Traceability Output (FR-XX, UJ-XX)
+
+When source has FR-XX or UJ-XX IDs, emit `specs/product/REQUIREMENTS_TRACE.yaml` for end-to-end requirement traceability:
+
+```yaml
+trace:
+  - id: FR-001
+    type: functional_requirement
+    description: "User can register with email/password"
+    epic: e02-auth-ui
+    story: e02s01
+    verify: "grep -q 'FR-001' specs/product/SCOPE_LATEST.yaml && echo OK"
+  - id: UJ-001
+    type: user_journey
+    description: "New user completes registration flow"
+    epic: e02-auth-ui
+    story: e02s01
+```
+
+**Existing trace file:** If `REQUIREMENTS_TRACE.yaml` already exists, prompt: "REQUIREMENTS_TRACE.yaml exists. [overwrite / merge / skip]"
+
+**No FR-XX/UJ-XX found:** Skip trace file; add note to state.yaml handoff: "No FR-XX/UJ-XX IDs found — traceability file skipped".
+
+See [REFERENCE.md — REQUIREMENTS_TRACE.yaml format](./REFERENCE.md#requirements_traceyaml-format) for the complete schema.
+
 > **HARD GATE** — Never overwrite an existing `specs/` file without explicit user confirmation. Merge into it if it exists; don't clobber.
 >
 > → verify: `git diff --name-only HEAD -- specs/ 2>/dev/null | head -20`

package/migrate-spec/templates/REQUIREMENTS_TRACE.yaml

@@ -0,0 +1,28 @@
+# Auto-generated from {{source_framework}} FR-XX / UJ-XX IDs during migration
+# Maps source requirements to bigpowers epic/story structure and verification commands.
+
+trace:
+  # Functional Requirements (FR-XX)
+  - id: FR-001
+    type: functional_requirement
+    description: "User can register with email/password"
+    source_artifact: "{{source_file}}"
+    epic: "e02-auth-ui"
+    story: "e02s01"
+    verify: "grep -q 'FR-001' specs/product/SCOPE_LATEST.yaml && echo OK || echo FAIL"
+
+  # User Journeys (UJ-XX)
+  - id: UJ-001
+    type: user_journey
+    description: "New user completes registration flow"
+    source_artifact: "{{source_file}}"
+    epic: "e02-auth-ui"
+    story: "e02s01"
+    verify: "grep -q 'UJ-001' specs/epics/e02-auth-ui/epic.yaml && echo OK || echo FAIL"
+
+# Metadata
+metadata:
+  source_framework: "{{source_framework}}"  # e.g., BMAD, GSD, spec-kit
+  migrated_at: "{{timestamp}}"
+  total_requirements: "{{count}}"
+  coverage: "All FR-XX and UJ-XX IDs from source mapped to bigpowers artifacts"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.29.0",
+  "version": "2.30.0",
   "description": "61 agent skills for spec-driven, test-first software development by solo developers",
   "main": "index.js",
   "scripts": {

package/skills-lock.json

@@ -163,7 +163,7 @@
     },
     "migrate-spec": {
       "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.",
-      "sha256": "3570ec13243de9b8",
+      "sha256": "72006537bb12ab1a",
       "path": "migrate-spec/SKILL.md"
     },
     "model-domain": {