bigpowers 2.72.0 → 2.73.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [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)
+
+
+### Bug Fixes
+
+* **specs:** close 9 audit gaps for e37 Reach epic plan ([#58](https://github.com/danielvm-git/bigpowers/issues/58)) ([e5d44f4](https://github.com/danielvm-git/bigpowers/commit/e5d44f4bb9378dc16d34561432e79957af3fd613))
+
 # [2.72.0](https://github.com/danielvm-git/bigpowers/compare/v2.71.0...v2.72.0) (2026-07-06)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.72.0",
+  "version": "2.73.0",
   "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/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/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)