bigpowers 2.86.5 → 2.86.7

package/scripts/test-install-hub.sh

@@ -0,0 +1,141 @@
+#!/usr/bin/env bash
+# story: e37s05
+# test-install-hub.sh — one registry-driven check of install-hub wiring for
+# every target, replacing 14 hand-written test-<target>-hub.sh scripts.
+#
+# Those 14 were line-for-line identical apart from three substituted tokens, and
+# none of them were reachable from any gate. They also covered only 14 of the 18
+# targets install.sh actually defines, so antigravity, claude, cursor and pi had
+# no hub coverage at all.
+#
+# Targets are discovered from install.sh's own install_<id>() definitions —
+# the authoritative statement of what the hub installs — rather than from a
+# table that would drift. Each target's display label is read out of its
+# install function body, so adding a target needs no edit here.
+#
+# Usage: bash scripts/test-install-hub.sh [--self-test]
+set -euo pipefail
+source "$(dirname "${BASH_SOURCE[0]}")/lib/skill-common.sh"
+resolve_repo_root
+cd "$REPO_ROOT"
+
+TA_PASS=0
+TA_FAIL=0
+TA_TMPDIR=""
+
+source "$(dirname "${BASH_SOURCE[0]}")/lib/test-assertions.sh"
+trap ta_cleanup EXIT
+
+INSTALL_SH="scripts/install.sh"
+HELPERS_JS="scripts/lib/install-helpers.js"
+SETUP_JS="bin/setup.js"
+TARGETS_YAML="scripts/targets.yaml"
+INSTALL_SRC="$INSTALL_SH scripts/lib/install-targets-a.sh scripts/lib/install-targets-b.sh scripts/lib/install-targets-c.sh scripts/lib/install-targets-d.sh"
+
+# setup.js registers Kilo under a shortened id; everything else matches 1:1.
+setup_id_for() { [[ "$1" == "kilocode" ]] && echo "kilo" || echo "$1"; }
+
+discover_targets() {
+  # shellcheck disable=SC2086
+  grep -hoE "^install_[a-z0-9]+\(\)" $INSTALL_SRC 2>/dev/null \
+    | sed 's/^install_//; s/()//' | sort -u
+}
+
+# Pull `echo "Label → ..."` out of the target's own install function body.
+label_for() {
+  local id="$1"
+  # shellcheck disable=SC2086
+  # Strip around the arrow with sub() rather than substr()/RLENGTH — the arrow
+  # is multi-byte UTF-8 and byte-indexed slicing corrupts the trailing char.
+  awk -v fn="install_${id}()" '
+    $0 ~ "^" fn { inside = 1; next }
+    inside && /^}/ { exit }
+    inside && /echo "[^"]* →/ {
+      line = $0
+      sub(/^[^"]*"/, "", line)
+      sub(/ →.*$/, "", line)
+      print line; exit
+    }
+  ' $INSTALL_SRC 2>/dev/null | head -1
+}
+
+# Returns the delegate id when install_<id>() does nothing but call another
+# install_<other>, otherwise empty.
+alias_target_for() {
+  local id="$1"
+  # shellcheck disable=SC2086
+  awk -v fn="install_${id}()" '
+    $0 ~ "^" fn { inside = 1; body = ""; next }
+    inside && /^}/ { exit }
+    inside {
+      line = $0
+      gsub(/^[[:space:]]+|[[:space:]]+$/, "", line)
+      if (line != "") body = body line "\n"
+    }
+    END {
+      n = split(body, lines, "\n")
+      count = 0; only = ""
+      for (i = 1; i <= n; i++) if (lines[i] != "") { count++; only = lines[i] }
+      if (count == 1 && only ~ /^install_[a-z0-9]+$/) { sub(/^install_/, "", only); print only }
+    }
+  ' $INSTALL_SRC 2>/dev/null | head -1
+}
+
+echo "=== test-install-hub.sh ==="
+
+TARGETS=$(discover_targets)
+[[ -n "$TARGETS" ]] || { ta_fail "no install_<id>() functions discovered"; echo "test-install-hub: $TA_PASS passed, $TA_FAIL failed"; exit 1; }
+echo "Discovered $(wc -w <<<"$TARGETS" | tr -d ' ') install targets"
+
+DRY_OUT="$(bash "$INSTALL_SH" --dry-run 2>&1 || true)"
+DRY_UNINSTALL="$(bash "$INSTALL_SH" --dry-run --uninstall 2>&1 || true)"
+SETUP_IDS="$(sed -n '/SUPPORTED_IDS = new Set/,/);/p' "$SETUP_JS")"
+
+for id in $TARGETS; do
+  # shellcheck disable=SC2086
+  grep -qE "^uninstall_${id}\(\)" $INSTALL_SRC \
+    && ta_pass "$id: uninstall_${id}() defined" \
+    || ta_fail "$id: uninstall_${id}() missing"
+
+  # Some targets are pure aliases (install_antigravity just calls install_agy).
+  # They own no label; the delegate's label is asserted on its own pass.
+  alias_of="$(alias_target_for "$id")"
+  label="$(label_for "$id")"
+  if [[ -z "$label" && -n "$alias_of" ]]; then
+    ta_pass "$id: alias of $alias_of (label asserted there)"
+  elif [[ -z "$label" ]]; then
+    ta_fail "$id: no 'Label →' line found inside install_${id}()"
+  else
+    grep -qF "$label →" <<<"$DRY_OUT" \
+      && ta_pass "$id: dry-run shows '$label'" \
+      || ta_fail "$id: dry-run missing '$label' section"
+    grep -qF "$label →" <<<"$DRY_UNINSTALL" \
+      && ta_pass "$id: dry-run --uninstall shows '$label'" \
+      || ta_fail "$id: dry-run --uninstall missing '$label' section"
+  fi
+
+  grep -q "case '${id}'" "$HELPERS_JS" \
+    && ta_pass "$id: install-helpers case" \
+    || ta_fail "$id: install-helpers missing case '${id}'"
+
+  sid="$(setup_id_for "$id")"
+  grep -q "'${sid}'" <<<"$SETUP_IDS" \
+    && ta_pass "$id: setup.js SUPPORTED_IDS carries '${sid}'" \
+    || ta_fail "$id: setup.js SUPPORTED_IDS missing '${sid}'"
+done
+
+# Global syntax gates — previously repeated in all 14 scripts.
+bash -n "$INSTALL_SH" && ta_pass "bash -n install.sh" || ta_fail "bash -n install.sh"
+node --check "$HELPERS_JS" >/dev/null 2>&1 && ta_pass "node --check install-helpers.js" || ta_fail "node --check install-helpers.js"
+node --check "$SETUP_JS" >/dev/null 2>&1 && ta_pass "node --check setup.js" || ta_fail "node --check setup.js"
+grep -q "SUPPORTED_IDS = new Set" "$SETUP_JS" && ta_pass "setup.js defines SUPPORTED_IDS" || ta_fail "setup.js missing SUPPORTED_IDS"
+
+# Registry coverage is reported, not enforced: copilot, opencode, claude and
+# antigravity ship install functions but have no targets.yaml row today.
+# Failing on that here would block unrelated work; it is tracked separately.
+for id in $TARGETS; do
+  grep -q "id: ${id}$" "$TARGETS_YAML" || echo "  note: $id installs but has no targets.yaml row"
+done
+
+echo "test-install-hub: $TA_PASS passed, $TA_FAIL failed"
+[[ "$TA_FAIL" -eq 0 ]] || exit 1

package/scripts/test-setup-no-pyyaml.sh

@@ -16,15 +16,17 @@ source "$(dirname "${BASH_SOURCE[0]}")/lib/skill-common.sh"
 resolve_repo_root
 cd "$REPO_ROOT"
 
-GREEN='\033[0;32m'; RED='\033[0;31m'; NC='\033[0m'
-FAILURES=0
-pass() { echo -e "${GREEN}PASS${NC} $1"; }
-fail() { echo -e "${RED}FAIL${NC} $1"; FAILURES=$((FAILURES + 1)); }
+TA_PASS=0
+TA_FAIL=0
+TA_TMPDIR=""
+
+source "$(dirname "${BASH_SOURCE[0]}")/lib/test-assertions.sh"
+trap ta_cleanup EXIT
 
 # Build a throwaway PyYAML-free interpreter — a fresh venv has no PyYAML,
 # reproducing a stock macOS python3 without touching the caller's environment.
-NOYAML_DIR="$(mktemp -d)"
-trap 'rm -rf "$NOYAML_DIR"' EXIT
+TA_TMPDIR="$(mktemp -d)"
+NOYAML_DIR="$TA_TMPDIR"
 if ! python3 -m venv "$NOYAML_DIR/venv" >/dev/null 2>&1; then
   echo "test-setup-no-pyyaml: SKIP — cannot create venv"; exit 0
 fi
@@ -35,18 +37,18 @@ fi
 
 # 1. srp-engine.py must parse a skill's frontmatter without crashing.
 if "$NOPY" scripts/lib/srp-engine.py skills/fix-bug/SKILL.md >/dev/null 2>&1; then
-  pass "srp-engine.py parses frontmatter without PyYAML"
+  ta_pass "srp-engine.py parses frontmatter without PyYAML"
 else
-  fail "srp-engine.py crashed without PyYAML"
+  ta_fail "srp-engine.py crashed without PyYAML"
 fi
 
 # 2. validate-skill-yaml.py must not bail with exit 2 (the old PyYAML-required path).
 rc=0
 "$NOPY" scripts/validate-skill-yaml.py >/dev/null 2>&1 || rc=$?
 if [[ "$rc" -ne 2 ]]; then
-  pass "validate-skill-yaml.py runs without PyYAML (exit $rc)"
+  ta_pass "validate-skill-yaml.py runs without PyYAML (exit $rc)"
 else
-  fail "validate-skill-yaml.py bailed with exit 2 (PyYAML required)"
+  ta_fail "validate-skill-yaml.py bailed with exit 2 (PyYAML required)"
 fi
 
 # 3. Fallback fidelity: simple_yaml must equal PyYAML for every skill's
@@ -71,13 +73,10 @@ if bad:
     print("mismatch: " + ", ".join(bad)); sys.exit(1)
 sys.exit(0)
 PY
-  pass "simple_yaml matches PyYAML for all skill frontmatter"
+  ta_pass "simple_yaml matches PyYAML for all skill frontmatter"
 else
-  fail "simple_yaml diverged from PyYAML for some skill frontmatter"
+  ta_fail "simple_yaml diverged from PyYAML for some skill frontmatter"
 fi
 
-if [[ "$FAILURES" -gt 0 ]]; then
-  echo "test-setup-no-pyyaml: $FAILURES failure(s)" >&2
-  exit 1
-fi
-echo "test-setup-no-pyyaml: PASS"
+echo "test-setup-no-pyyaml: $TA_PASS passed, $TA_FAIL failed"
+[[ "$TA_FAIL" -eq 0 ]] || exit 1

package/scripts/test-target-contracts.sh

@@ -15,10 +15,12 @@ source "$(dirname "${BASH_SOURCE[0]}")/lib/skill-common.sh"
 resolve_repo_root
 cd "$REPO_ROOT"
 
-PASS=0
-FAIL=0
-pass() { echo "PASS: $1"; PASS=$((PASS + 1)); }
-fail() { echo "FAIL: $1" >&2; FAIL=$((FAIL + 1)); }
+TA_PASS=0
+TA_FAIL=0
+TA_TMPDIR=""
+
+source "$REPO_ROOT/scripts/lib/test-assertions.sh"
+trap ta_cleanup EXIT
 
 echo "=== test-target-contracts.sh ==="
 
@@ -31,9 +33,9 @@ out=$(run_contract "faketarget" "definitely_not_a_real_contract" 2>&1)
 rc=$?
 set -e
 if [[ $rc -ne 0 ]]; then
-  pass "unknown contract fails (exit $rc)"
+  ta_pass "unknown contract fails (exit $rc)"
 else
-  fail "unknown contract returned 0 — run_contract is fail-open again: $out"
+  ta_fail "unknown contract returned 0 — run_contract is fail-open again: $out"
 fi
 
 # 2. Every contract declared in targets.yaml must resolve to an assertion.
@@ -41,16 +43,16 @@ fi
 #    a FAIL line, while a missing implementation hits the default branch and
 #    reports "unknown contract".
 declared=$(grep -E "^      - [a-z0-9_]+$" scripts/targets.yaml | sed 's/^      - //' | sort -u)
-[[ -n "$declared" ]] || fail "no contracts parsed from targets.yaml"
+[[ -n "$declared" ]] || ta_fail "no contracts parsed from targets.yaml"
 
 for c in $declared; do
   set +e
   out=$(run_contract "__probe__" "$c" 2>&1)
   set -e
   if grep -q "unknown contract" <<<"$out"; then
-    fail "$c declared in targets.yaml but no assertion implements it"
+    ta_fail "$c declared in targets.yaml but no assertion implements it"
   else
-    pass "$c has an implementation"
+    ta_pass "$c has an implementation"
   fi
 done
 
@@ -61,13 +63,13 @@ for c in $declared; do
     *_hooks_manifest)
       t="${c%_hooks_manifest}"
       if [[ -f "scripts/hooks/${t}/hooks-manifest.json" ]]; then
-        pass "$t ships hooks-manifest.json"
+        ta_pass "$t ships hooks-manifest.json"
       else
-        fail "$t declares $c but scripts/hooks/${t}/hooks-manifest.json is missing"
+        ta_fail "$t declares $c but scripts/hooks/${t}/hooks-manifest.json is missing"
       fi
       ;;
   esac
 done
 
-echo "test-target-contracts: $PASS passed, $FAIL failed"
-[[ "$FAIL" -eq 0 ]] || exit 1
+echo "test-target-contracts: $TA_PASS passed, $TA_FAIL failed"
+[[ "$TA_FAIL" -eq 0 ]] || exit 1

package/scripts/test-tombstone-mechanism.sh

@@ -14,10 +14,12 @@ RED='\033[0;31m'
 GREEN='\033[0;32m'
 NC='\033[0m'
 
-FAILURES=0
-tt_pass() { echo -e "${GREEN}PASS${NC} $1"; }
-tt_fail() { echo -e "${RED}FAIL${NC} $1"; FAILURES=$((FAILURES + 1)); }
-strip_ansi() { sed -E 's/\x1b\[[0-9;]*m//g'; }
+TA_PASS=0
+TA_FAIL=0
+TA_TMPDIR=""
+source "$(dirname "${BASH_SOURCE[0]}")/lib/test-assertions.sh"
+# NOT `trap ta_cleanup EXIT` — this script's cleanup restores a backed-up
+# specs/tombstones.yaml and removes named fixture dirs, not a TA_TMPDIR.
 
 FIXTURE_OLD="test-tombstone-fixture"
 FIXTURE_NEW="test-tombstone-target"
@@ -25,7 +27,7 @@ FIXTURE_DIR="skills/${FIXTURE_OLD}"
 TOMBSTONES_FILE="specs/tombstones.yaml"
 TOMBSTONES_BACKUP=""
 
-cleanup() {
+tombstone_test_cleanup() {
   rm -rf "$FIXTURE_DIR" "skills/${FIXTURE_NEW}"
   if [[ -n "$TOMBSTONES_BACKUP" ]]; then
     mv "$TOMBSTONES_BACKUP" "$TOMBSTONES_FILE"
@@ -33,7 +35,7 @@ cleanup() {
     rm -f "$TOMBSTONES_FILE"
   fi
 }
-trap cleanup EXIT
+trap tombstone_test_cleanup EXIT
 
 if [[ -f "$TOMBSTONES_FILE" ]]; then
   TOMBSTONES_BACKUP=$(mktemp)
@@ -43,9 +45,9 @@ fi
 
 # --- Scenario: zero tombstones registered (6a) ---
 if bash scripts/validate-tombstones.sh 2>&1 | grep -qi "no tombstones"; then
-  tt_pass "validate-tombstones.sh reports clean when zero tombstones registered"
+  ta_pass "validate-tombstones.sh reports clean when zero tombstones registered"
 else
-  tt_fail "validate-tombstones.sh did not report 'no tombstones' with an empty ledger"
+  ta_fail "validate-tombstones.sh did not report 'no tombstones' with an empty ledger"
 fi
 
 # --- Scenario: tombstone-skill.sh generates a stub ---
@@ -62,28 +64,28 @@ FIXTUREEOF
 bash scripts/tombstone-skill.sh "$FIXTURE_OLD" "$FIXTURE_NEW"
 
 if grep -q "TOMBSTONE" "${FIXTURE_DIR}/SKILL.md"; then
-  tt_pass "tombstone-skill.sh replaced SKILL.md with a stub"
+  ta_pass "tombstone-skill.sh replaced SKILL.md with a stub"
 else
-  tt_fail "SKILL.md was not replaced with a tombstone stub"
+  ta_fail "SKILL.md was not replaced with a tombstone stub"
 fi
 
 if grep -q "story: e00s00" "${FIXTURE_DIR}/SKILL.md"; then
-  tt_pass "tombstone-skill.sh preserved the old story tag"
+  ta_pass "tombstone-skill.sh preserved the old story tag"
 else
-  tt_fail "story tag was not preserved in the stub"
+  ta_fail "story tag was not preserved in the stub"
 fi
 
 if [[ -f "$TOMBSTONES_FILE" ]] && grep -q "$FIXTURE_OLD" "$TOMBSTONES_FILE"; then
-  tt_pass "tombstone-skill.sh registered the mapping in ${TOMBSTONES_FILE}"
+  ta_pass "tombstone-skill.sh registered the mapping in ${TOMBSTONES_FILE}"
 else
-  tt_fail "mapping not registered in ${TOMBSTONES_FILE}"
+  ta_fail "mapping not registered in ${TOMBSTONES_FILE}"
 fi
 
 # --- Scenario: fresh tombstone resolves cleanly ---
-if bash scripts/validate-tombstones.sh 2>&1 | strip_ansi | grep -q "OK: ${FIXTURE_OLD}"; then
-  tt_pass "validate-tombstones.sh confirms the fresh stub resolves"
+if bash scripts/validate-tombstones.sh 2>&1 | ta_strip_ansi | grep -q "OK: ${FIXTURE_OLD}"; then
+  ta_pass "validate-tombstones.sh confirms the fresh stub resolves"
 else
-  tt_fail "validate-tombstones.sh did not confirm the fresh stub"
+  ta_fail "validate-tombstones.sh did not confirm the fresh stub"
 fi
 
 # --- Scenario: expired tombstone flagged (6b) ---
@@ -96,10 +98,10 @@ for t in d['tombstones']:
 yaml.dump(d, open('$TOMBSTONES_FILE', 'w'), default_flow_style=False)
 "
 
-if bash scripts/validate-tombstones.sh 2>&1 | strip_ansi | grep -qi "EXPIRED: ${FIXTURE_OLD}"; then
-  tt_pass "validate-tombstones.sh flags a tombstone whose expiry window has passed"
+if bash scripts/validate-tombstones.sh 2>&1 | ta_strip_ansi | grep -qi "EXPIRED: ${FIXTURE_OLD}"; then
+  ta_pass "validate-tombstones.sh flags a tombstone whose expiry window has passed"
 else
-  tt_fail "expired tombstone was not flagged"
+  ta_fail "expired tombstone was not flagged"
 fi
 
 # --- Scenario: rejects path-traversal / invalid skill names (threat model CWE-22) ---
@@ -108,16 +110,16 @@ fi
 # status doesn't mask the grep check below.
 output=$(bash scripts/tombstone-skill.sh "../../etc/passwd" "target" 2>&1 || true)
 if echo "$output" | grep -qi "not a valid skill name"; then
-  tt_pass "tombstone-skill.sh rejects a path-traversal old-name"
+  ta_pass "tombstone-skill.sh rejects a path-traversal old-name"
 else
-  tt_fail "tombstone-skill.sh did not reject a path-traversal old-name"
+  ta_fail "tombstone-skill.sh did not reject a path-traversal old-name"
 fi
 
 output=$(bash scripts/tombstone-skill.sh "$FIXTURE_OLD" "../../etc/passwd" 2>&1 || true)
 if echo "$output" | grep -qi "not a valid skill name"; then
-  tt_pass "tombstone-skill.sh rejects a path-traversal new-name"
+  ta_pass "tombstone-skill.sh rejects a path-traversal new-name"
 else
-  tt_fail "tombstone-skill.sh did not reject a path-traversal new-name"
+  ta_fail "tombstone-skill.sh did not reject a path-traversal new-name"
 fi
 
 # --- Scenario: validate-tombstones.sh rejects an invalid name read back from the ledger ---
@@ -131,11 +133,11 @@ d.setdefault('tombstones', []).append({
 })
 yaml.dump(d, open('$TOMBSTONES_FILE', 'w'), default_flow_style=False)
 "
-output=$(bash scripts/validate-tombstones.sh 2>&1 | strip_ansi || true)
+output=$(bash scripts/validate-tombstones.sh 2>&1 | ta_strip_ansi || true)
 if echo "$output" | grep -qi "FAIL.*not a valid skill name"; then
-  tt_pass "validate-tombstones.sh rejects a path-traversal name read from the ledger"
+  ta_pass "validate-tombstones.sh rejects a path-traversal name read from the ledger"
 else
-  tt_fail "validate-tombstones.sh did not reject a path-traversal name read from the ledger"
+  ta_fail "validate-tombstones.sh did not reject a path-traversal name read from the ledger"
 fi
 python3 -c "
 import yaml
@@ -145,9 +147,5 @@ yaml.dump(d, open('$TOMBSTONES_FILE', 'w'), default_flow_style=False)
 "
 
 echo "---"
-if [[ "$FAILURES" -eq 0 ]]; then
-  echo -e "${GREEN}test-tombstone-mechanism: ALL PASS${NC}"
-else
-  echo -e "${RED}test-tombstone-mechanism: $FAILURES failure(s)${NC}"
-fi
-exit "$FAILURES"
+echo "test-tombstone-mechanism: $TA_PASS passed, $TA_FAIL failed"
+exit "$TA_FAIL"

package/skills/commit-message/REFERENCE.md

@@ -78,4 +78,4 @@ This table reflects the **out-of-the-box** behavior of `semantic-release` using
 
 - [Conventional Commits — specification](https://www.conventionalcommits.org/en/v1.0.0/#specification)
 - [semantic-release — README (commit format & flow)](https://github.com/semantic-release/semantic-release#commit-message-format)
-- Fork pointer: [semantic-release-baby](https://github.com/danielvm-git/semantic-release-baby) (automation and docs align with upstream semantic-release)
+- Automation and docs align with [semantic-release](https://github.com/semantic-release/semantic-release) upstream; a fork may be substituted without changing this guidance.

package/skills/evolve-skill/REFERENCE.md

@@ -9,4 +9,4 @@
 **Evidence:** path/to/benchmark-report.md
 ```
 
-Benchmark repo: `bigpowers-benchmark` — resolve the local clone on this machine (e.g. `gh repo clone danielvm-git/bigpowers-benchmark` if absent); never assume a hard-coded absolute path.
+Benchmark repo: `bigpowers-benchmark` — resolve the local clone on this machine; clone it from wherever your fork lives if absent. Never assume a hard-coded absolute path or a specific owner.

package/skills/guard-git/REFERENCE.md

@@ -5,14 +5,14 @@
 | Lines | Section |
 |-------|---------|
 | 1 | Title |
-| 3–14 | Navigation |
-| 16–24 | Secret patterns |
-| 26–44 | Copy layout |
-| 46–72 | Claude Code |
-| 74–92 | Cursor and Cursor CLI |
-| 94–120 | Gemini CLI |
-| 122–135 | Google Antigravity |
-| 137–178 | Verify (local tests) |
+| 3–16 | Navigation |
+| 17–28 | Secret patterns (audit + pre-commit) |
+| 29–46 | Copy layout |
+| 47–72 | Claude Code |
+| 73–94 | Cursor and Cursor CLI |
+| 95–122 | Gemini CLI |
+| 123–137 | Google Antigravity |
+| 138–180 | Verify (local tests) |
 
 ## Secret patterns (audit + pre-commit)
 

package/skills/kickoff-branch/SKILL.md

@@ -82,7 +82,7 @@ git worktree list | grep "<task-slug>"
 **Handling Conflicts:**
 - **Directory exists:** If `../<task-slug>` already exists, ask the user if they want to use it or delete it.
 - **Branch exists:** If the branch exists but no worktree is attached, ask to use the existing branch (`git worktree add ../<task-slug> <task-slug>`) or delete it.
-- **Ghost worktree:** If `git worktree list` shows the path but the directory is missing, run `git worktree prune` to clear the stale metadata.
+- **Ghost worktree:** If `git worktree list` shows the path but the directory is missing, run `git worktree prune` to clear the stale metadata. `bash scripts/cleanup-worktrees.sh` does this plus reports any worktree whose branch is already merged or deleted — advisory only, it prints the `git worktree remove`/`git branch -d` commands rather than running them, so review before acting.
 
 ### 4. Create worktree + branch
 

package/skills/migrate-spec/REFERENCE.md

@@ -5,12 +5,58 @@
 | Lines | Section |
 |-------|---------|
 | 1 | Title |
-| 3–22 | Navigation |
-| 24–62 | spec-kit → bigpowers Mapping |
-| 64–130 | BMAD → bigpowers Mapping |
-| 132–154 | Learnings to Adopt |
-| 156–350 | Output Formats + state.yaml template |
-| 352–620 | Reference blocks 1–2 + extended mappings |
+| 3–68 | Navigation |
+| 69–70 | spec-kit → bigpowers Mapping |
+| 71–84 | Artifact Locations |
+| 85–94 | `spec.md` → `specs/product/SCOPE_LATEST.yaml` + `specs/tech-architecture/TECH_STACK_LATEST.md` |
+| 95–105 | `plan.md` → `specs/tech-architecture/TECH_STACK_LATEST.md` + `specs/release-plan.yaml` + `specs/epics/` |
+| 106–114 | `tasks.md` → `specs/epics/` (via slice-tasks) |
+| 115–120 | `.specify/` state |
+| 121–122 | BMAD → bigpowers Mapping |
+| 123–141 | Artifact Locations |
+| 142–148 | `product-brief.md` / `prfaq-{project}.md` → `specs/product/VISION_LATEST.yaml` |
+| 149–160 | `prd.md` → `specs/product/SCOPE_LATEST.yaml` + `GLOSSARY_LATEST.yaml` |
+| 161–167 | `addendum.md` + `decision-log.md` → `specs/adr/` + `specs/DECISION-LOG_LATEST.md` |
+| 168–174 | `architecture.md` → `specs/tech-architecture/TECH_STACK_LATEST.md` + `specs/adr/` |
+| 175–178 | `epic-*.md` → `specs/release-plan.yaml` + `specs/epics/eNN-*.yaml` |
+| 179–182 | `story-*.md` → `specs/epics/` stories |
+| 183–188 | `project-context.md` → `CLAUDE.md` |
+| 189–192 | Learnings to Adopt |
+| 193–198 | From GSD |
+| 199–204 | From spec-kit |
+| 205–212 | From BMAD |
+| 213–214 | Output Formats |
+| 215–224 | ADR format (bigpowers) |
+| 225–227 | Context |
+| 228–230 | Decision |
+| 231–234 | Consequences |
+| 235–246 | DECISION-LOG.md format |
+| 247–257 | MIGRATION-AUDIT.md format |
+| 258–264 | Summary |
+| 265–274 | High Priority Findings |
+| 275–278 | Information |
+| 279–285 | Next Steps |
+| 286–306 | in_scope format with ID tracking |
+| 307–341 | REQUIREMENTS_TRACE.yaml format |
+| 342–397 | `specs/state.yaml` template format |
+| 398–416 | Reference block 1 |
+| 417–432 | Reference block 2 |
+| 433–451 | Reference block 3 |
+| 452–474 | Reference block 4 |
+| 475–482 | Reference block 5 |
+| 483–484 | Findings |
+| 485–489 | High Priority |
+| 490–495 | Information |
+| 496–509 | Reference block 6 |
+| 510–542 | Step 7 — Post-migration: Optional two-pass spec writing gate |
+| 543–574 | Step 8 — Post-migration: Optional methodology doc template |
+| 575–600 | Artifact Mapping Summary |
+| 601–610 | Rules |
+| 611–621 | Step 5 — Surface learnings (optional) |
+| 622–644 | Step 6 — Adversarial review (optional) |
+| 645–646 | Findings |
+| 647–651 | High Priority |
+| 652–660 | Information |
 
 # migrate-spec Reference — spec-kit, BMAD, Learnings
 

package/skills/plan-work/REFERENCE.md

@@ -5,11 +5,23 @@
 | Lines | Section |
 |-------|---------|
 | 1 | Title |
-| 3–14 | Navigation |
-| 16–38 | Output file formats |
-| 40–71 | Plan template |
-| 73–91 | Verify step format rules |
-| 93–131 | Sub-operations (risk, define-success, zoom-out, slopcheck, delta tags) |
+| 3–25 | Navigation |
+| 26–27 | Output file formats |
+| 28–31 | Story spec: `specs/epics/<capsule>/eNNsYY-<slug>.md` |
+| 32–61 | Task checklist: `specs/epics/<capsule>/eNNsYY-tasks.yaml` |
+| 62–64 | Plan template |
+| 65–71 | Story [X.Y]: [title] — Implementation Steps |
+| 72–77 | Steps |
+| 78–85 | Verification Script (Step-by-Step) |
+| 86–89 | Out of scope |
+| 90–94 | Risks |
+| 95–114 | Verify step format rules |
+| 115–116 | Sub-operations |
+| 117–127 | Risk Assignment Heuristics |
+| 128–143 | Requirement delta tags (e45s29) |
+| 144–152 | Define Success |
+| 153–161 | Zoom-Out Check |
+| 162–169 | Slopcheck |
 
 ## Output file formats
 

package/skills/publish-package/REFERENCE.md

@@ -5,11 +5,21 @@
 | Lines | Section |
 |-------|---------|
 | 1 | Title |
-| 3–18 | Navigation |
-| 20–28 | Options |
-| 30–60 | Examples |
-| 62–72 | Integration with release-branch |
-| 74–252 | Reference blocks 1–8 |
+| 3–23 | Navigation |
+| 24–35 | Options |
+| 36–37 | Examples |
+| 38–51 | Publish an npm package |
+| 52–59 | Publish a Rust crate |
+| 60–69 | Missing token scenario |
+| 70–80 | Integration with release-branch |
+| 81–121 | Reference block 1 |
+| 122–143 | Reference block 2 |
+| 144–162 | Reference block 3 |
+| 163–180 | Reference block 4 |
+| 181–195 | Reference block 5 |
+| 196–230 | Reference block 6 |
+| 231–248 | Reference block 7 |
+| 249–260 | Reference block 8 |
 
 ## Options
 

package/skills/release-branch/REFERENCE.md

@@ -4,15 +4,19 @@
 
 | Lines | Section |
 |-------|---------|
-| 1–3 | Title |
-| 5–16 | Navigation |
-| 18–41 | PR body template |
-| 43–54 | Worktree cleanup |
-| 56–96 | Cycle-time recording |
-| 98–119 | CI verification |
-| 121–126 | Solo-local fallback |
+| 1 | Title |
+| 3–22 | Navigation |
+| 23–31 | PR body template (team-pr mode) |
+| 32–35 | Summary |
+| 36–41 | Verify |
+| 42–47 | specs/ artifacts |
+| 48–58 | Worktree cleanup details |
+| 59–81 | Cycle-time recording |
+| 82–100 | Why not story_start minus story_end? |
+| 101–121 | CI verification |
+| 122–127 | Solo-local fallback detail |
 | 128–134 | Handoff |
-| 136–155 | Reference block 1 (manual squash) |
+| 135–159 | Reference block 1 |
 
 # Release Branch — Reference
 

package/skills/seed-conventions/REFERENCE.md

@@ -6,16 +6,26 @@
 
 | Lines | Section |
 |-------|---------|
-| 1–4 | Title + story tags |
-| 6–22 | Navigation (this table) |
-| 24–35 | AGENTS.md spine |
-| 37–76 | Agent config template |
-| 78–85 | opencode.json template |
-| 87–96 | Aider bridge |
-| 98–108 | Codex CLI wiring |
-| 110–118 | CONVENTIONS.md |
-| 120–122 | Stack profile fragments |
-| 124–153 | Local tool wiring |
+| 1 | Title |
+| 5–29 | Navigation |
+| 30–53 | Fenced markers (e45s21) |
+| 54–65 | AGENTS.md spine (Reach Template — e37s01) |
+| 66–77 | Agent config template (legacy — prefer AGENTS.md spine) |
+| 78–81 | Project |
+| 82–91 | Commands |
+| 92–94 | Architecture |
+| 95–98 | Conventions |
+| 99–104 | Never |
+| 105–114 | Agent Rules |
+| 115–123 | opencode.json template |
+| 124–133 | Aider — `.aider.conf.yml` bridge (e37s03) |
+| 134–146 | Codex CLI — project-local `.codex/config.toml` + AGENTS.md (e37s14) |
+| 147–156 | CONVENTIONS.md |
+| 157–160 | Stack profile fragments |
+| 161–164 | Local tool wiring (optional interview step 8) |
+| 165–173 | Cursor — project-local `.cursor/rules` symlink |
+| 174–187 | OpenCode — project-local `opencode.json` + `AGENTS.md` |
+| 188–190 | When to offer |
 
 ## Fenced markers (e45s21)