bigpowers 2.72.1 → 2.73.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [2.73.1](https://github.com/danielvm-git/bigpowers/compare/v2.73.0...v2.73.1) (2026-07-06)
+
+
+### Bug Fixes
+
+* **ci:** skip unimplemented P0 stories in trace --strict gate ([e7a56bf](https://github.com/danielvm-git/bigpowers/commit/e7a56bfd94d5dbebf0f7736383e2c381016616b9))
+
+# [2.73.0](https://github.com/danielvm-git/bigpowers/compare/v2.72.1...v2.73.0) (2026-07-06)
+
+
+### Features
+
+* **reach:** AGENTS.md spine and integration registry (e37) ([7d3b856](https://github.com/danielvm-git/bigpowers/commit/7d3b85691384e8df67e71d61fccfd143cc637f56))
+
 ## [2.72.1](https://github.com/danielvm-git/bigpowers/compare/v2.72.0...v2.72.1) (2026-07-06)
 
 

package/audit-independent-unwaived-2026-07-06.md

@@ -0,0 +1,49 @@
+# Independent Compliance Audit (Unwaived Mode)
+
+**Date**: 2026-07-06
+**Mode**: Strict (All waivers disabled)
+**Target**: `specs/verifications/features/`
+**Result**: GATE: FAIL
+
+## Summary of Execution
+I executed the verification gates by temporarily bypassing `waivers.yaml` to run an independent compliance audit against the `bigpowers` principles and conventions without any exceptions. The `audit-compliance.sh` and `validate-doctrine.sh` scripts were successfully executed.
+
+## Failed Verification Steps & Offending Scripts
+
+By disabling the waivers, I isolated **4 failing verification steps**. Below is the mapping of each failure to its offending files and corresponding `bigpowers` skills:
+
+### 1. Unique Public Symbols (`grep` < 5 results)
+**Feature**: `akita.feature` (sourced from `conventions.feature`)
+- **Reason**: Duplicate function names across multiple files (e.g., `agent_dry_run`, `assign_tier`, `cleanup`, `emit_json`, `fail`, `parse_frontmatter`, `pass`, `show_help`, `usage`). 
+- **Affected Core/Skills**: Common shared scripts and lifecycle utilities.
+
+### 2. Context Window Constraint (< 300 lines)
+**Feature**: `akita.feature`
+- **Reason**: Scripts exceeding the 300-line limit for agent context windows.
+- **Offending Files**:
+  - `scripts/sync-skills.sh` (Mapped to: `craft-skill`, `evolve-skill`, `maintain-wiki`)
+  - `scripts/migrate-version.sh` (Mapped to: `migrate-spec`)
+  - `scripts/run-verification-gates.sh` (Core harness)
+  - `scripts/validate-okf.sh` (Core harness)
+  - `scripts/audit-compliance.sh` (Core harness / `audit-code`)
+  - `scripts/run-golden-suite.sh` (Core harness)
+  - `scripts/lib/trace-matrix.py` (Mapped to: `gate-trace`)
+  - `scripts/lib/trace-stories.py` (Mapped to: `trace-requirement`)
+
+### 3. Newspaper Metaphor (< 500 lines)
+**Feature**: `cleancode.feature`
+- **Reason**: Critical scripts exceeding the absolute 500-line hard cap.
+- **Offending Files**:
+  - `scripts/sync-skills.sh` (Mapped to: `craft-skill`, `evolve-skill`)
+  - `scripts/migrate-version.sh` (Mapped to: `migrate-spec`)
+  - `scripts/lib/trace-matrix.py` (Mapped to: `gate-trace`)
+
+### 4. Boolean Encapsulation (G28)
+**Feature**: `cleancode.feature`
+- **Reason**: Complex, multi-clause bash conditional logic not encapsulated in named functions.
+- **Offending Files**:
+  - `scripts/migrate-version.sh` (Mapped to: `migrate-spec`)
+  - `scripts/check-spec-version-gap.sh` (Mapped to: `plan-release`)
+
+## Restoration
+After the test run concluded, the original `waivers.yaml` was restored to preserve environment integrity. No actual code modifications were made.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.72.1",
+  "version": "2.73.1",
   "description": "73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "main": "index.js",
   "scripts": {

package/scripts/adapters/agy.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# story: e37s09
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode symlink "${1:-CLAUDE.md}"
+}

package/scripts/adapters/aider.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+# story: e37s05 e37s03
+
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode config-bridge ".aider.conf.yml" read "AGENTS.md"
+}

package/scripts/adapters/cline.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# story: e37s05
+# Cline reads AGENTS.md natively — no skill artifacts.
+
+wire_context() {
+  # native mode — no derivative
+  return 0
+}

package/scripts/adapters/continue.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# story: e37s12
+render_skill() {
+  local rules_dir="${CONTINUE_RULES:-.continue/rules}"
+  mkdir -p "$rules_dir" 2>/dev/null || true
+  [[ -n "${IR_NAME:-}" ]] && touch "$rules_dir/$IR_NAME.md" 2>/dev/null || true
+}
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode copy "${1:-AGENTS.md}"
+}

package/scripts/adapters/cursor.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# story: e37s05 e37s07
+# scenario: SC-e37s07-P0-02
+# Cursor skill adapter — renders .cursor/rules/*.mdc from IR globals.
+
+render_skill() {
+  if declare -f render_cursor >/dev/null 2>&1; then
+    render_cursor
+    return
+  fi
+  local cursor_file="${CURSOR_RULES:-.cursor/rules}/$IR_NAME.mdc"
+  {
+    echo "---"
+    echo "description: \"$IR_DESC_ESCAPED\""
+    echo "alwaysApply: false"
+    echo "---"
+    echo ""
+    echo "$IR_BODY"
+  } > "$cursor_file"
+}
+
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode symlink "${1:-CLAUDE.md}"
+}

package/scripts/adapters/gemini.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# story: e37s05 e37s07
+
+render_skill() {
+  if declare -f render_gemini_skill >/dev/null 2>&1; then
+    render_gemini_skill
+    render_gemini_command
+    return
+  fi
+  mkdir -p "${GEMINI_SKILLS:-.gemini/extensions/bigpowers/skills}/$IR_NAME"
+  {
+    echo "---"
+    echo "name: $IR_NAME"
+    [[ -n "$IR_MODEL" ]] && echo "model: $IR_MODEL"
+    echo "description: \"$IR_DESC_ESCAPED\""
+    echo "disable-model-invocation: true"
+    echo "---"
+    echo ""
+    echo "$IR_BODY"
+  } > "${GEMINI_SKILLS}/$IR_NAME/SKILL.md"
+
+  mkdir -p "${GEMINI_COMMANDS:-.gemini/extensions/bigpowers/commands/prompts}"
+  {
+    echo "---"
+    echo "name: $IR_NAME"
+    echo "description: \"$IR_DESC_ESCAPED\""
+    echo "---"
+    echo ""
+    echo "$IR_BODY"
+  } > "${GEMINI_COMMANDS}/prompts/$IR_NAME.md"
+}
+
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode symlink "${1:-GEMINI.md}"
+}

package/scripts/adapters/goose.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+# story: e37s09
+wire_context() { return 0; }

package/scripts/adapters/hermes.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# story: e37s10
+render_skill() {
+  local out="${HERMES_SKILLS:-.hermes/skills}"
+  mkdir -p "$out/${IR_NAME:-_stub}" 2>/dev/null || true
+}
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode config-bridge ".hermes/config.yaml" "instructions" "AGENTS.md"
+}

package/scripts/adapters/iflow.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# story: e37s13
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode symlink "${1:-AGENTS.md}"
+}

package/scripts/adapters/kilocode.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# story: e37s11
+render_skill() {
+  local out="${KILOCODE_RULES:-.kilocode/rules}"
+  mkdir -p "$out" 2>/dev/null || true
+  [[ -n "${IR_NAME:-}" ]] && touch "$out/$IR_NAME.md" 2>/dev/null || true
+}
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode copy "${1:-AGENTS.md}"
+}

package/scripts/adapters/omp.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# story: e37s10
+render_skill() {
+  local out="${OMP_SKILLS:-.omp/skills}"
+  mkdir -p "$out/${IR_NAME:-_stub}" 2>/dev/null || true
+}
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode symlink "${1:-CLAUDE.md}"
+}

package/scripts/adapters/pi.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# story: e37s05 e37s07
+
+render_skill() {
+  if declare -f render_pi_skill >/dev/null 2>&1; then
+    render_pi_skill
+    render_pi_prompt
+    return
+  fi
+  mkdir -p "${PI_SKILLS:-.pi/skills}/$IR_NAME"
+  cp "${SKILL_MD_PATH:-}" "${PI_SKILLS}/$IR_NAME/SKILL.md" 2>/dev/null || {
+    {
+      echo "---"
+      echo "name: $IR_NAME"
+      [[ -n "$IR_MODEL" ]] && echo "model: $IR_MODEL"
+      echo "description: \"$IR_DESC_ESCAPED\""
+      echo "---"
+      echo ""
+      echo "$IR_BODY"
+    } > "${PI_SKILLS}/$IR_NAME/SKILL.md"
+  }
+
+  mkdir -p "${PI_PROMPTS:-.pi/prompts}"
+  {
+    echo "---"
+    echo "name: $IR_NAME"
+    echo "description: \"$IR_DESC_ESCAPED\""
+    echo "---"
+    echo ""
+    echo "$IR_BODY"
+  } > "${PI_PROMPTS}/$IR_NAME.md"
+}
+
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode symlink "${1:-CLAUDE.md}"
+}

package/scripts/adapters/qwen.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# story: e37s11
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode symlink "${1:-QWEN.md}"
+}

package/scripts/adapters/shai.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# story: e37s13
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode symlink "${1:-AGENTS.md}"
+}

package/scripts/adapters/vibe.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# story: e37s13
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode symlink "${1:-AGENTS.md}"
+}

package/scripts/adapters/zed.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# story: e37s10
+render_skill() {
+  local out="${ZED_OUT:-.zed/skills}"
+  mkdir -p "$out/${IR_NAME:-_stub}" 2>/dev/null || true
+}
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode copy "${1:-AGENTS.md}"
+}

package/scripts/check-blind-spots.sh

@@ -11,6 +11,9 @@
 
 set -euo pipefail
 source "$(dirname "${BASH_SOURCE[0]}")/lib/python-env.sh"
+source "$(dirname "${BASH_SOURCE[0]}")/lib/skill-common.sh"
+resolve_repo_root
+
 
 BLIND_SPOTS_JSON="$REPO_ROOT/specs/blind-spots.json"
 EXEC_STATUS="$REPO_ROOT/specs/execution-status.yaml"

package/scripts/generate-context-bundle.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# story: e37s06
+# scenario: SC-e37s06-P1-01
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/lib/skill-common.sh"
+resolve_repo_root
+
+DRY_RUN=0
+for arg in "$@"; do
+  case "$arg" in
+    --dry-run) DRY_RUN=1 ;;
+    --help|-h)
+      echo "Usage: generate-context-bundle.sh [--dry-run]"
+      exit 0
+      ;;
+  esac
+done
+
+bash "$SCRIPT_DIR/validate-targets-yaml.sh" >/dev/null
+
+TARGETS_FILE="$SCRIPT_DIR/targets.yaml"
+command -v yq >/dev/null || { echo "generate-context-bundle: yq required" >&2; exit 1; }
+
+cd "$REPO_ROOT"
+agents_src="AGENTS.md"
+[[ -f "$agents_src" ]] || agents_src="docs/templates/AGENTS.md"
+
+while IFS= read -r row; do
+  id=$(echo "$row" | yq -r '.id')
+  mode=$(echo "$row" | yq -r '.context.mode // ""')
+  [[ "$mode" == "null" || -z "$mode" || "$mode" == "native" ]] && continue
+
+  file=$(echo "$row" | yq -r '.context.file // ""')
+  bridge_file=$(echo "$row" | yq -r '.context.bridge_file // ""')
+  bridge_key=$(echo "$row" | yq -r '.context.bridge_key // "read"')
+  adapter=$(echo "$row" | yq -r '.context.adapter')
+
+  dest="${file:-$bridge_file}"
+  if [[ "$DRY_RUN" -eq 1 ]]; then
+    echo "would wire $id → $dest (mode=$mode, source=$agents_src)"
+    continue
+  fi
+
+  adapter_script="$SCRIPT_DIR/adapters/${adapter}.sh"
+  # shellcheck source=/dev/null
+  source "$adapter_script"
+  case "$mode" in
+    symlink) wire_context_mode symlink "$file" ;;
+    copy) wire_context_mode copy "$file" ;;
+    config-bridge) wire_context_mode config-bridge "$bridge_file" "$bridge_key" "$agents_src" ;;
+  esac
+  echo "wired $id → $dest"
+done < <(yq -o=json '.targets[] | select(.context != null)' "$TARGETS_FILE" | jq -c '.')
+
+echo "generate-context-bundle: done (source=$agents_src)"

package/scripts/install.sh

@@ -225,6 +225,25 @@ uninstall_pi() {
   fi
 }
 
+# ── Codex CLI (e37s15) ───────────────────────────────────────────────────────
+
+CODEX_DIR="$HOME/.codex"
+CODEX_AGENTS="$CODEX_DIR/AGENTS.md"
+CODEX_TEMPLATE="$REPO_ROOT/docs/templates/codex/AGENTS.md"
+
+install_codex() {
+  echo ""
+  echo "Codex CLI → $CODEX_AGENTS"
+  [[ -f "$CODEX_TEMPLATE" ]] || { echo "  skip: template missing $CODEX_TEMPLATE" >&2; return 0; }
+  link "$CODEX_TEMPLATE" "$CODEX_AGENTS"
+}
+
+uninstall_codex() {
+  echo ""
+  echo "Codex CLI → removing $CODEX_AGENTS"
+  unlink_if_managed "$CODEX_AGENTS" "$REPO_ROOT/"
+}
+
 # ── main ──────────────────────────────────────────────────────────────────────
 
 echo "bigpowers install.sh — REPO: $REPO_ROOT"
@@ -236,6 +255,7 @@ if $UNINSTALL; then
   uninstall_gemini
   uninstall_pi
   uninstall_cursor
+  uninstall_codex
   echo ""
   echo "bigpowers uninstalled."
 else
@@ -243,6 +263,7 @@ else
   install_gemini
   install_pi
   install_cursor
+  install_codex
   echo ""
   echo "bigpowers installed. Future updates:"
   if [[ -d "$REPO_ROOT/.git" ]]; then

package/scripts/lib/context-wire.sh

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# story: e37s05 e37s06
+# scenario: SC-e37s06-P1-02
+# Shared Context Derivative wiring — symlink with copy fallback (Windows-safe).
+
+wire_symlink_or_copy() {
+  local src="$1"
+  local dest="$2"
+
+  [[ -f "$src" ]] || { echo "context-wire: source missing: $src" >&2; return 1; }
+
+  if [[ -L "$dest" ]] && [[ "$(readlink "$dest" 2>/dev/null)" == "$src" || "$(readlink "$dest" 2>/dev/null)" == "./$src" ]]; then
+    return 0
+  fi
+  if [[ -f "$dest" ]] && cmp -s "$src" "$dest" 2>/dev/null; then
+    return 0
+  fi
+
+  rm -f "$dest" 2>/dev/null || true
+  if ln -sf "$src" "$dest" 2>/dev/null; then
+    return 0
+  fi
+
+  echo "context-wire: symlink failed for $dest — using copy fallback" >&2
+  cp "$src" "$dest"
+}
+
+wire_config_bridge() {
+  local bridge_file="$1"
+  local bridge_key="$2"
+  local agents_path="${3:-AGENTS.md}"
+
+  mkdir -p "$(dirname "$bridge_file")"
+  if [[ -f "$bridge_file" ]] && grep -q "^${bridge_key}:" "$bridge_file" 2>/dev/null; then
+    return 0
+  fi
+  printf '%s: %s\n' "$bridge_key" "$agents_path" > "$bridge_file"
+}
+
+wire_context_mode() {
+  local mode="$1"
+  local file="${2:-}"
+  local bridge_file="${3:-}"
+  local bridge_key="${4:-read}"
+  local src="${5:-AGENTS.md}"
+
+  case "$mode" in
+    native) return 0 ;;
+    symlink|copy)
+      [[ -n "$file" ]] || { echo "context-wire: file required for mode=$mode" >&2; return 1; }
+      if [[ "$mode" == "copy" ]]; then
+        cp "$src" "$file"
+      else
+        wire_symlink_or_copy "$src" "$file"
+      fi
+      ;;
+    config-bridge)
+      [[ -n "$bridge_file" ]] || { echo "context-wire: bridge_file required" >&2; return 1; }
+      wire_config_bridge "$bridge_file" "$bridge_key" "$src"
+      ;;
+    *)
+      echo "context-wire: unknown mode: $mode" >&2
+      return 1
+      ;;
+  esac
+}

package/scripts/lib/target-contracts.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+# story: e37s08
+# scenario: SC-e37s08-P1-01
+
+assert_agents_md() {
+  local id="$1"
+  if [[ -f AGENTS.md ]] || [[ -f docs/templates/AGENTS.md ]]; then
+    echo "PASS $id:agents_md_exists"
+    return 0
+  fi
+  echo "FAIL $id:agents_md_exists — AGENTS.md missing"
+  return 1
+}
+
+assert_symlink_claude_md() {
+  local id="$1"
+  if [[ -L CLAUDE.md ]] || [[ -f CLAUDE.md ]]; then
+    echo "PASS $id:symlink_claude_md"
+    return 0
+  fi
+  echo "FAIL $id:symlink_claude_md — CLAUDE.md missing"
+  return 1
+}
+
+assert_cursor_rules_nonempty() {
+  local id="$1"
+  if [[ -d .cursor/rules ]] && [[ -n "$(ls -A .cursor/rules 2>/dev/null)" ]]; then
+    echo "PASS $id:cursor_rules_nonempty"
+    return 0
+  fi
+  echo "FAIL $id:cursor_rules_nonempty — .cursor/rules empty"
+  return 1
+}
+
+assert_gemini_ext_exists() {
+  local id="$1"
+  if [[ -d .gemini/extensions/bigpowers ]]; then
+    echo "PASS $id:gemini_ext_exists"
+    return 0
+  fi
+  echo "FAIL $id:gemini_ext_exists — gemini extension missing"
+  return 1
+}
+
+assert_pi_skills_nonempty() {
+  local id="$1"
+  if [[ -d .pi/skills ]] && [[ -n "$(ls -A .pi/skills 2>/dev/null)" ]]; then
+    echo "PASS $id:pi_skills_nonempty"
+    return 0
+  fi
+  echo "FAIL $id:pi_skills_nonempty — .pi/skills empty"
+  return 1
+}
+
+assert_aider_bridge() {
+  local id="$1"
+  if [[ -f .aider.conf.yml ]] && grep -q 'AGENTS.md' .aider.conf.yml 2>/dev/null; then
+    echo "PASS $id:aider_bridge"
+    return 0
+  fi
+  echo "SKIP $id:aider_bridge — opt_in not wired"
+  return 0
+}
+
+run_contract() {
+  local id="$1"
+  local contract="$2"
+  case "$contract" in
+    agents_md_exists) assert_agents_md "$id" ;;
+    symlink_claude_md) assert_symlink_claude_md "$id" ;;
+    cursor_rules_nonempty) assert_cursor_rules_nonempty "$id" ;;
+    gemini_ext_exists) assert_gemini_ext_exists "$id" ;;
+    pi_skills_nonempty) assert_pi_skills_nonempty "$id" ;;
+    aider_bridge) assert_aider_bridge "$id" ;;
+    *) echo "SKIP $id:$contract — unknown contract"; return 0 ;;
+  esac
+}

package/scripts/lib/trace-stories.py

@@ -30,6 +30,7 @@ MODE = sys.argv[6]
 # 1. Parse YAML files → story inventory
 # -----------------------------------------------------------------------
 _MIN_STORY_BASELINE = 50  # floor assertion: --strict FAILs if story count drops below this
+_STRICT_UNIMPLEMENTED_STATUSES = frozenset({"backlog", "todo", "planned"})
 
 def _load_yaml(path: Path) -> dict:
     """Load a YAML file with PyYAML. Exits with code 1 if parse fails."""
@@ -290,10 +291,10 @@ if STRICT:
         wsjf_sorted = sorted(set(s["wsjf"] for s in matrix_stories), reverse=True)
         cutoff_idx = max(0, len(wsjf_sorted) // 4 - 1)
         p0_threshold = wsjf_sorted[cutoff_idx] if cutoff_idx < len(wsjf_sorted) else 0
-        # Only flag non-backlog stories — backlog stories haven't been implemented yet
+        # Only flag stories expected to have implementation — skip backlog/todo/planned
         uncovered_p0 = [s["id"] for s in matrix_stories
             if s["wsjf"] >= p0_threshold and len(s["links"]) == 0
-            and s["status"] != "backlog"]
+            and s["status"] not in _STRICT_UNIMPLEMENTED_STATUSES]
         if uncovered_p0:
             print(f"trace-stories.sh: STRICT FAIL — P0 stories with 0% coverage: {', '.join(uncovered_p0)}", file=sys.stderr)
             sys.exit(2)

package/scripts/sync-bugs-registry.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
-# story: e45s03
 # sync-bugs-registry.sh — rebuild specs/bugs/registry.yaml + OKF concept bundles
 set -euo pipefail
 source "$(dirname "${BASH_SOURCE[0]}")/lib/python-env.sh"
 source "$(dirname "${BASH_SOURCE[0]}")/lib/skill-common.sh"
+resolve_repo_root
 BUGS="$REPO_ROOT/specs/bugs"
 mkdir -p "$BUGS"
 
@@ -18,6 +18,8 @@ repo_root = Path(sys.argv[2])
 # ---- Phase 1: Build registry.yaml ----
 entries = []
 for path in sorted(bugs_dir.glob("BUG-*.md")):
+    if ".okf" in path.name:
+        continue
     text = path.read_text(encoding="utf-8")
     if not text.startswith("---"):
         continue

package/scripts/sync-skills.sh

@@ -254,11 +254,18 @@ parse_frontmatter_okf() {
   return 0
 }
 
-# ── Target registry ─────────────────────────────────────────────────
-# Order matters: render functions are called in this order per skill.
-TARGETS=(render_cursor render_gemini_skill render_gemini_command render_pi_skill render_pi_prompt)
-if [[ "$OKF_MODE" -eq 1 ]]; then
-  TARGETS+=(render_okf_concept)
+# ── Target registry (e37s07) ────────────────────────────────────────
+# Load skill adapters from scripts/targets.yaml — no hardcoded target list.
+TARGETS_FILE="$REPO_ROOT/scripts/targets.yaml"
+SKILL_ADAPTERS=()
+if [[ -f "$TARGETS_FILE" ]] && command -v yq >/dev/null 2>&1; then
+  bash "$REPO_ROOT/scripts/validate-targets-yaml.sh" >/dev/null
+  while IFS= read -r adapter; do
+    [[ -n "$adapter" && "$adapter" != "null" ]] && SKILL_ADAPTERS+=("$adapter")
+  done < <(yq -r '.targets[] | select(.skill != null) | .skill.adapter' "$TARGETS_FILE" | sort -u)
+else
+  echo "sync-skills: WARN — targets.yaml missing; using legacy render list" >&2
+  SKILL_ADAPTERS=(cursor gemini pi)
 fi
 
 skill_count=0
@@ -283,12 +290,20 @@ while IFS= read -r skill_dir; do
   [[ -z "$IR_NAME" ]] && continue
 
   IR_BODY=$(build_body "$skill_md" "$skill_dir")
-
-  # Dispatch to each render target
-  for target_fn in "${TARGETS[@]}"; do
-    "$target_fn"
+  SKILL_MD_PATH="$skill_md"
+
+  # Dispatch to each skill adapter from registry (e37s07)
+  for adapter_name in "${SKILL_ADAPTERS[@]}"; do
+    adapter_script="$REPO_ROOT/scripts/adapters/${adapter_name}.sh"
+    # shellcheck source=/dev/null
+    source "$adapter_script"
+    render_skill
   done
 
+  if [[ "$OKF_MODE" -eq 1 ]]; then
+    render_okf_concept
+  fi
+
   skill_count=$((skill_count + 1))
 done < <(iterate_skills)