bigpowers 2.86.6 → 2.86.8

package/skills/wire-ci/REFERENCE.md

@@ -5,11 +5,18 @@
 | Lines | Section |
 |-------|---------|
 | 1 | Title |
-| 3–14 | Navigation |
-| 16–38 | Examples |
-| 40–52 | Options |
-| 54–62 | Integration with build-epic |
-| 64–270 | Reference blocks 1–8 |
+| 3–20 | Navigation |
+| 21–22 | Examples |
+| 23–39 | Create CI for a Go project (TBR + optional deploy) |
+| 40–49 | Create CI for a CLI tool (TBR only, no deploy) |
+| 50–57 | Validate existing workflows (no generation) |
+| 58–70 | Options |
+| 71–79 | Integration with build-epic |
+| 80–154 | Reference block 1 — test-build-release.yml (Go, excerpt) |
+| 155–204 | Reference block 2 — deploy.yml (generic web app, excerpt) |
+| 205–232 | Reference block 3 — CLI dogfood (big-release pattern) |
+| 233–257 | Reference block 4 — validate script |
+| 258–268 | Reference block 5 — dry-run |
 
 ## Examples
 

package/skills/write-document/REFERENCE.md

@@ -7,10 +7,36 @@ Combined from dbader/readme-template and jehna/readme-best-practices. No TOC.
 | Lines | Section |
 |-------|---------|
 | 1 | Title |
-| 5–16 | Navigation |
-| 18–24 | Sections intro |
-| 26–178 | README section templates (1–15) |
-| 180–183 | Verify |
+| 5–40 | Navigation |
+| 41–42 | Sections |
+| 43–54 | 1. Title + Badges |
+| 55–60 | 2. Tagline |
+| 61–64 | 3. Description |
+| 65–67 | 4. Prerequisites |
+| 68–75 | Prerequisites |
+| 76–78 | 5. Installation |
+| 79–89 | Installation |
+| 90–92 | 6. Usage |
+| 93–102 | Usage |
+| 103–105 | 7. Features |
+| 106–113 | Features |
+| 114–116 | 8. Configuration |
+| 117–125 | Configuration |
+| 126–128 | 9. Development Setup |
+| 129–139 | Development |
+| 140–142 | 10. Running Tests |
+| 143–152 | Tests |
+| 153–155 | 11. Contributing |
+| 156–164 | Contributing |
+| 165–167 | 12. Changelog |
+| 168–172 | Changelog |
+| 173–175 | 13. Links |
+| 176–181 | Links |
+| 182–184 | 14. License |
+| 185–191 | License |
+| 192–194 | 15. Credits (optional) |
+| 195–199 | Credits |
+| 200–202 | Verify |
 
 ## Sections
 

package/skills/write-document/SKILL.md

@@ -48,7 +48,7 @@ Write the document focusing on "Expert Collaboration":
 
 1. Ask: "Project name? One-sentence description?"
 2. Generate `README.md` at project root using the template in [REFERENCE.md](REFERENCE.md) — no TOC, no second interview round.
-3. Fill gaps from `CLAUDE.md` commands if available; use `TODO` markers otherwise.
+3. Fill gaps from `CLAUDE.md` / `AGENTS.md` commands if available (prefer `AGENTS.md`); use `TODO` markers otherwise.
 4. Output and suggest `edit-document` for polish.
 
 → verify: `test -f README.md && [ "$(grep -c '^## ' README.md)" -ge 7 ]`

package/skills-lock.json

@@ -188,7 +188,7 @@
     },
     "kickoff-branch": {
       "description": "Create a git worktree and feature branch, then verify a clean test baseline before any code is written. Use when starting a new feature or task, when user wants to work in isolation from main, or mentions \"start a branch\" or \"new worktree\".",
-      "sha256": "256eefc13f0ec022",
+      "sha256": "d94be12d4b29895b",
       "path": "skills/kickoff-branchSKILL.md"
     },
     "maintain-wiki": {
@@ -398,7 +398,7 @@
     },
     "write-document": {
       "description": "Write, organize, and sync high-integrity technical documents using the BMAD methodology. Ensures every document is Bold, Minimal, Actionable, and Durable. Use when creating architectural docs, technical guides, or organizing the specs/ directory.",
-      "sha256": "445a7d0359fcbedf",
+      "sha256": "54f71fb8b725440a",
       "path": "skills/write-documentSKILL.md"
     }
   }

package/scripts/add-model-frontmatter.sh

@@ -1,32 +0,0 @@
-#!/usr/bin/env bash
-# add-model-frontmatter.sh — one-time helper; idempotent model: injection
-set -euo pipefail
-# SKILLS_ROOT: use skills/ when it exists, fall back to repo root
-source "$(dirname "${BASH_SOURCE[0]}")/lib/skill-common.sh"
-resolve_repo_root
-
-# Bash 3.2-compatible model mapping (no declare -A)
-model_for() {
-  case "$1" in
-    survey-context|verify-work|validate-fix|audit-code|enforce-first|trace-requirement|commit-message|release-branch|kickoff-branch|guard-git|hook-commits|execute-plan|organize-workspace|terse-mode|session-state|search-skills|setup-environment|reset-baseline) echo "haiku" ;;
-    elaborate-spec|grill-with-docs|design-interface|plan-work|request-review|evolve-skill) echo "opus" ;;
-    *) echo "sonnet" ;;
-  esac
-}
-
-for skill_dir in "$SKILLS_ROOT"/*/; do
-  skill_md="$skill_dir/SKILL.md"
-  [[ -f "$skill_md" ]] || continue
-  name=$(basename "$skill_dir")
-  model=$(model_for "$name")
-  if grep -q '^model:' "$skill_md" 2>/dev/null; then
-    continue
-  fi
-  # Insert model: after name: line in frontmatter
-  awk -v m="$model" '
-    /^---$/ { fm++; print; next }
-    fm==1 && /^name:/ { print; print "model: " m; next }
-    { print }
-  ' "$skill_md" > "$skill_md.tmp" && mv "$skill_md.tmp" "$skill_md"
-  echo "model: $model → $name"
-done

package/scripts/golden-g13-test-orphans.sh

@@ -1,70 +0,0 @@
-#!/usr/bin/env bash
-# story: e37s05
-# golden-g13-test-orphans.sh — every scripts/test-*.sh must be wired into a gate.
-#
-# Before this gate, 33 of 35 test scripts were reachable from nothing: not CI,
-# not Preflight, not package.json, not another script. Writing a test was not
-# enough to make it run, so tests accumulated as dead weight and regressions
-# they would have caught shipped anyway (test-adapters.sh silently exercised 1
-# of 21 adapters for months).
-#
-# Usage: bash scripts/golden-g13-test-orphans.sh [--self-test]
-# Exit 0: every test script is referenced by the gate list
-# Exit 1: at least one orphan (or, under --self-test, the gate failed to notice
-#         a deliberately unlisted script)
-
-set -euo pipefail
-source "$(dirname "${BASH_SOURCE[0]}")/lib/skill-common.sh"
-resolve_repo_root
-cd "$REPO_ROOT"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-NC='\033[0m'
-
-GATES_FILE="scripts/lib/golden-suite-gates.sh"
-
-find_orphans() { # $1 = extra script basename to consider (may be empty)
-  local extra="${1:-}"
-  local orphans=""
-  local f b
-  for f in scripts/test-*.sh; do
-    [[ -e "$f" ]] || continue
-    b="$(basename "$f")"
-    grep -q "$b" "$GATES_FILE" || orphans+="  $b"$'\n'
-  done
-  if [[ -n "$extra" ]]; then
-    grep -q "$extra" "$GATES_FILE" || orphans+="  $extra"$'\n'
-  fi
-  printf '%s' "$orphans"
-}
-
-if [[ "${1:-}" == "--self-test" ]]; then
-  echo "=== G-13 self-test: prove the gate can fail ==="
-  # A name that is definitely not in the gate list must be reported.
-  if [[ -n "$(find_orphans "test-definitely-not-wired.sh")" ]]; then
-    echo -e "${GREEN}PASS${NC} G-13 reports an unlisted test script"
-    echo "G-13 self-test: PASS"
-    exit 0
-  fi
-  echo -e "${RED}FAIL${NC} G-13 did not report an unlisted script — vacuous gate"
-  echo "G-13 self-test: FAIL"
-  exit 1
-fi
-
-echo "=== G-13: test-script orphan check ==="
-ORPHANS="$(find_orphans "")"
-TOTAL=$(ls scripts/test-*.sh 2>/dev/null | wc -l | tr -d ' ')
-
-if [[ -z "$ORPHANS" ]]; then
-  echo "  ok  : all $TOTAL test script(s) are wired into $GATES_FILE"
-  echo -e "${GREEN}PASS${NC}"
-  echo "G-13: PASS"
-  exit 0
-fi
-
-echo "  orphaned test scripts (present but reachable from no gate):"
-printf '%s' "$ORPHANS"
-echo -e "${RED}FAIL${NC} add them to GOLDEN_GATES in $GATES_FILE, or delete them"
-echo "G-13: FAIL"
-exit 1

package/scripts/install-cursor-skills-local.sh

@@ -1,15 +0,0 @@
-#!/usr/bin/env bash
-# story: e78
-# DEPRECATED wrapper — project-local Cursor rules symlink (not .cursor/skills copies).
-# Usage: ./scripts/install-cursor-skills-local.sh [INSTALL_ROOT]
-set -euo pipefail
-
-REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-INSTALL_ROOT="$(cd "${1:-$PWD}" && pwd)"
-export TARGET_DIR="${TARGET_DIR:-$INSTALL_ROOT/.cursor/rules}"
-export SOURCE_DIR="${SOURCE_DIR:-$REPO_ROOT/.cursor/rules}"
-
-echo "NOTE: install-cursor-skills-local.sh is deprecated; prefer bigpowers setup (local) or:" >&2
-echo "  ln -sfn $SOURCE_DIR $TARGET_DIR" >&2
-
-exec "$REPO_ROOT/scripts/install-cursor-skills.sh"

package/scripts/install-cursor-skills.sh

@@ -1,24 +0,0 @@
-#!/usr/bin/env bash
-# story: e78
-# DEPRECATED wrapper — Cursor integration is Rules (.mdc), not ~/.cursor/skills copies.
-# Canonical install: bash scripts/install.sh  OR  node bin/setup.js (bigpowers setup)
-# This script now symlinks repo .cursor/rules → TARGET_DIR (default: ~/.cursor/rules).
-set -euo pipefail
-
-REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-SOURCE_DIR="${SOURCE_DIR:-$REPO_ROOT/.cursor/rules}"
-TARGET_DIR="${TARGET_DIR:-$HOME/.cursor/rules}"
-
-echo "NOTE: install-cursor-skills.sh is deprecated; use scripts/install.sh or bigpowers setup." >&2
-echo "      Redirecting to rules symlink: $TARGET_DIR → $SOURCE_DIR" >&2
-
-if [[ ! -d "$SOURCE_DIR" ]]; then
-  echo "SOURCE_DIR missing: $SOURCE_DIR — run bash scripts/sync-skills.sh first" >&2
-  exit 1
-fi
-
-mkdir -p "$(dirname "$TARGET_DIR")"
-ln -sfn "$SOURCE_DIR" "$TARGET_DIR"
-echo "Done. Linked $TARGET_DIR → $SOURCE_DIR"
-echo "NOTE: Cursor does not scan ~/.cursor/rules/ globally; also symlink into each project:"
-echo "  ln -sfn $SOURCE_DIR .cursor/rules"

package/scripts/project-survey.sh

@@ -1,63 +0,0 @@
-#!/usr/bin/env bash
-# project-survey.sh — automated project status for session-start hooks
-
-set -euo pipefail
-
-# 1. Gather file existence info
-has_conventions=$([[ -f "CONVENTIONS.md" ]] && echo "true" || echo "false")
-has_claude=$([[ -f "CLAUDE.md" ]] && echo "true" || echo "false")
-has_specs=$([[ -d "specs" ]] && echo "true" || echo "false")
-
-# 2. Scan specs/ (YAML-first)
-specs_files=""
-if [[ "$has_specs" == "true" ]]; then
-  specs_files=$( {
-    ls specs/*.yaml 2>/dev/null || true
-    ls specs/product/*.yaml 2>/dev/null || true
-    ls specs/*.md 2>/dev/null || true
-  } | xargs -n1 basename 2>/dev/null | sort -u | tr '\n' ',' | sed 's/,$//')
-fi
-
-# 3. Git state
-current_branch=$(git branch --show-current 2>/dev/null || echo "not-a-repo")
-git_status=$(git status --short 2>/dev/null | head -n 5 | tr '\n' ' ' | sed 's/"/\\"/g')
-recent_logs=$(git log --oneline -3 2>/dev/null | tr '\n' ' ' | sed 's/"/\\"/g')
-
-# 4. Phase mapping logic (YAML-first)
-phase="Discover"
-if [[ -f "specs/state.yaml" ]]; then
-  flow=$(grep -E '^active_flow:' specs/state.yaml | sed 's/active_flow:[[:space:]]*//')
-  case "$flow" in
-    fix_bug) phase="Bug" ;;
-    build_epic) phase="Execute" ;;
-    planning) phase="Plan" ;;
-  esac
-elif [[ -f "specs/release-plan.yaml" ]]; then
-  phase="Plan"
-elif [[ -f "specs/product/SCOPE_LATEST.yaml" ]] || [[ -f "specs/SCOPE.md" ]]; then
-  phase="Design"
-elif [[ "$current_branch" != "main" && "$current_branch" != "master" ]]; then
-  phase="Initiate"
-fi
-
-if [[ -f "specs/DIAGNOSIS.md" ]]; then
-  phase="Bug"
-fi
-
-# 5. Output concise text for context injection
-cat <<EOF
-[PROJECT SURVEY]
-Phase: $phase
-Branch: $current_branch
-Files: CONVENTIONS=$has_conventions, CLAUDE=$has_claude, SPECS=$has_specs
-Specs Found: $specs_files
-Git Status: $git_status
-Recent Logs: $recent_logs
-
-Welcome to Bigpowers. I have analyzed the project state. 
-You are currently in the '$phase' phase on the '$current_branch' branch.
-EOF
-
-if [[ -f "specs/release-plan.yaml" ]]; then
-  echo "release-plan.yaml found. Read specs/state.yaml for active epic/story."
-fi