bigpowers 2.50.0 → 2.52.0

package/scripts/validate-okf.sh

@@ -0,0 +1,198 @@
+#!/usr/bin/env bash
+#
+# validate-okf.sh — provenance gate for OKF story-metrics bundles (e40/e31 style).
+#
+# A bundle is valid iff:
+#   1. The generator ran (generator field matches scripts/record-cycle-time.sh).
+#   2. commit_range resolves to real commits in the repo.
+#   3. Source enum is valid (measured|estimated|backfilled).
+#   4. Required keys are present with correct aggregation tags.
+#
+# This script gates on PROVENANCE, NEVER on a specific metric value.
+# Gate on freshness (did the right generator run?) not on outcomes.
+#
+# Usage:
+#   scripts/validate-okf.sh [--dir <path>] [--help]
+#   scripts/validate-okf.sh --bundle <file>      # validate a single bundle
+#
+set -euo pipefail
+
+ROOT="$(git rev-parse --show-toplevel 2>/dev/null)" || { echo "validate-okf: not inside a git repo"; exit 1; }
+METRICS_DIR="$ROOT/specs/metrics"
+EXIT_CODE=0
+REQUIRED_KEYS="id epic bcps commit_range source generated_at generator"
+VALID_SOURCES="measured estimated backfilled"
+
+RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[0;33m'; NC='\033[0m'
+
+usage() {
+  cat <<'EOF'
+Usage: scripts/validate-okf.sh [flags]
+
+Flags:
+  --dir <path>       Validate all OKF bundles in directory (default: specs/metrics/)
+  --bundle <file>    Validate a single OKF bundle
+  --help             Show this message
+
+Description:
+  Provenance gate for OKF story-metrics bundles. Validates that:
+  - Required keys are present (id, epic, bcps, commit_range, source, generated_at, generator)
+  - Source enum is valid (measured|estimated|backfilled)
+  - Generator matches scripts/record-cycle-time.sh
+  - commit_range resolves to real commits
+  - Aggregation tags are present (Σ, ⌀, %, •)
+
+  NEVER gates on a specific metric value — only on provenance and freshness.
+EOF
+  exit 0
+}
+
+# Parse a single YAML frontmatter block from an OKF bundle .md file.
+# Returns the frontmatter as JSON via Python (which handles YAML safely).
+parse_frontmatter() {
+  local file="$1"
+  # Extract YAML frontmatter between --- markers
+  python3 -c "
+import yaml, sys
+content = open('$file').read()
+parts = content.split('---')
+if len(parts) < 3:
+    sys.exit(1)
+try:
+    fm = yaml.safe_load(parts[1])
+    if fm is None:
+        sys.exit(1)
+    # Emit as JSON for bash
+    import json
+    print(json.dumps(fm))
+except Exception as e:
+    print(f'validate-okf: YAML parse error in $file: {e}', file=sys.stderr)
+    sys.exit(1)
+" 2>/dev/null
+}
+
+validate_bundle() {
+  local file="$1"
+  local bundle_name; bundle_name="$(basename "$file")"
+
+  # Parse frontmatter
+  local fm
+  fm="$(parse_frontmatter "$file")" || {
+    printf "${RED}FAIL${NC} %s: cannot parse YAML frontmatter\n" "$bundle_name"
+    EXIT_CODE=1
+    return
+  }
+
+  # Check okf_kind
+  local kind
+  kind="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('okf_kind',''))" 2>/dev/null)"
+  if [ "$kind" != "story-metrics" ]; then
+    printf "${YELLOW}SKIP${NC} %s: not a story-metrics bundle (kind=%s)\n" "$bundle_name" "${kind:-none}"
+    return
+  fi
+
+  # Check required keys
+  for key in $REQUIRED_KEYS; do
+    local val
+    val="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('$key',''))" 2>/dev/null)"
+    if [ -z "$val" ] || [ "$val" = "null" ] || [ "$val" = "None" ]; then
+      printf "${RED}FAIL${NC} %s: missing required key '%s'\n" "$bundle_name" "$key"
+      EXIT_CODE=1
+      return
+    fi
+  done
+
+  # Check source enum
+  local source
+  source="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d['source'])" 2>/dev/null)"
+  if ! echo "$VALID_SOURCES" | grep -qw "$source"; then
+    printf "${RED}FAIL${NC} %s: invalid source '%s' — must be one of: %s\n" "$bundle_name" "$source" "$VALID_SOURCES"
+    EXIT_CODE=1
+    return
+  fi
+
+  # Check generator
+  local generator
+  generator="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d['generator'])" 2>/dev/null)"
+  if [ "$generator" != "scripts/record-cycle-time.sh" ]; then
+    printf "${RED}FAIL${NC} %s: wrong generator '%s' — expected scripts/record-cycle-time.sh\n" "$bundle_name" "$generator"
+    EXIT_CODE=1
+    return
+  fi
+
+  # Check commit_range resolves
+  local commit_range
+  commit_range="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d['commit_range'])" 2>/dev/null)"
+  if ! git -C "$ROOT" log --oneline -1 "$commit_range" >/dev/null 2>&1; then
+    printf "${RED}FAIL${NC} %s: commit_range '%s' does not resolve\n" "$bundle_name" "$commit_range"
+    EXIT_CODE=1
+    return
+  fi
+
+  # Check aggregation tags exist (not empty, but don't validate correctness)
+  local effort_hours
+  effort_hours="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); e=d.get('effort',{}); print(e.get('effort_hours',''))" 2>/dev/null)"
+  if [ -z "$effort_hours" ] || [ "$effort_hours" = "null" ]; then
+    printf "${RED}FAIL${NC} %s: effort.effort_hours missing or null\n" "$bundle_name"
+    EXIT_CODE=1
+    return
+  fi
+
+  # Bounds sanity (effort can't be negative)
+  python3 -c "
+import json, sys
+d = json.load(sys.stdin)
+eff = d.get('effort', {}).get('effort_hours')
+if eff is not None and eff < 0:
+    sys.exit(1)
+" <<< "$fm" 2>/dev/null || {
+    printf "${RED}FAIL${NC} %s: effort_hours out of bounds\n" "$bundle_name"
+    EXIT_CODE=1
+    return
+  }
+
+  printf "${GREEN}PASS${NC} %s (source=%s, generator=%s, commit_range resolves)\n" "$bundle_name" "$source" "$generator"
+}
+
+# ---- main ----------------------------------------------------------------
+DIR=""
+BUNDLE=""
+
+[ $# -ge 1 ] || set -- "--dir" "$METRICS_DIR"  # default: validate specs/metrics/
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --dir) DIR="$2"; shift 2 ;;
+    --bundle) BUNDLE="$2"; shift 2 ;;
+    --help|-h) usage ;;
+    *) echo "validate-okf: unknown flag: $1" >&2; usage ;;
+  esac
+done
+
+echo "validate-okf: scanning for OKF bundles..."
+
+if [ -n "$BUNDLE" ]; then
+  validate_bundle "$BUNDLE"
+elif [ -n "$DIR" ]; then
+  if [ ! -d "$DIR" ]; then
+    printf "${YELLOW}SKIP${NC} directory not found: %s\n" "$DIR"
+    exit 0
+  fi
+  count=0
+  while IFS= read -r -d '' f; do
+    # Only process .md files with YAML frontmatter
+    if head -1 "$f" 2>/dev/null | grep -q '^---$'; then
+      validate_bundle "$f"
+      count=$((count + 1))
+    fi
+  done < <(find "$DIR" -maxdepth 1 -name '*.md' -print0 2>/dev/null || true)
+  if [ "$count" -eq 0 ]; then
+    printf "${YELLOW}SKIP${NC} no OKF bundles found in %s\n" "$DIR"
+  else
+    echo "validate-okf: scanned $count bundle(s)"
+  fi
+else
+  echo "validate-okf: nothing to validate" >&2
+fi
+
+exit "$EXIT_CODE"

package/scripts/wait-for-ci.sh

@@ -0,0 +1,130 @@
+#!/usr/bin/env bash
+# wait-for-ci.sh — Poll GitHub Actions until all workflow runs complete
+# Usage: wait-for-ci.sh [--timeout SECONDS] [--interval SECONDS] [--branch BRANCH]
+#   --timeout   Max seconds to wait (default: 600)
+#   --interval  Seconds between polls (default: 30)
+#   --branch    Branch to check (default: current branch)
+#   --commit    Specific commit SHA to verify (default: HEAD)
+#   --json      Output machine-readable JSON on completion
+#   --help      Show this message
+#
+# Exit codes: 0 = all workflows green, 1 = any workflow failed, 2 = timeout, 3 = no gh CLI
+
+set -euo pipefail
+
+TIMEOUT=600
+INTERVAL=30
+BRANCH=$(git branch --show-current 2>/dev/null || echo "main")
+COMMIT=""
+OUTPUT_JSON=false
+
+usage() {
+  sed -n '2,12p' "$0" | sed 's/^# //'
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --timeout) TIMEOUT="$2"; shift 2 ;;
+    --interval) INTERVAL="$2"; shift 2 ;;
+    --branch) BRANCH="$2"; shift 2 ;;
+    --commit) COMMIT="$2"; shift 2 ;;
+    --json) OUTPUT_JSON=true; shift ;;
+    --help) usage; exit 0 ;;
+    *) echo "Unknown flag: $1"; usage; exit 2 ;;
+  esac
+done
+
+COMMIT="${COMMIT:-$(git rev-parse HEAD)}"
+COMMIT_SHORT="${COMMIT:0:7}"
+
+# ── Git-only fallback ─────────────────────────────────────────────────
+if ! command -v gh >/dev/null 2>&1; then
+  echo "⚠️  gh CLI not found — using git-only fallback (cannot verify CI status)"
+  git fetch origin "$BRANCH" 2>/dev/null || true
+  REMOTE_SHA=$(git rev-parse "origin/$BRANCH" 2>/dev/null || echo "")
+  if [[ -n "$REMOTE_SHA" ]] && [[ "$REMOTE_SHA" == "$COMMIT" ]]; then
+    echo "✅ Push confirmed: remote $BRANCH matches $COMMIT_SHORT"
+    echo "⚠️  CI status UNVERIFIED — gh CLI required for workflow polling"
+    exit 0
+  else
+    echo "❌ Push unconfirmed: remote $BRANCH does not match $COMMIT_SHORT"
+    exit 1
+  fi
+fi
+
+# ── Verify gh auth ────────────────────────────────────────────────────
+if ! gh auth status 2>/dev/null; then
+  echo "⚠️  gh CLI not authenticated — falling back to git-only"
+  git fetch origin "$BRANCH" 2>/dev/null || true
+  REMOTE_SHA=$(git rev-parse "origin/$BRANCH" 2>/dev/null || echo "")
+  if [[ -n "$REMOTE_SHA" ]] && [[ "$REMOTE_SHA" == "$COMMIT" ]]; then
+    echo "✅ Push confirmed: remote $BRANCH matches $COMMIT_SHORT"
+    echo "⚠️  CI status UNVERIFIED — gh auth required for workflow polling"
+    exit 0
+  else
+    echo "❌ Push unconfirmed"
+    exit 1
+  fi
+fi
+
+# ── Poll CI ───────────────────────────────────────────────────────────
+REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null || echo "unknown")
+echo "==> Polling CI for $BRANCH ($COMMIT_SHORT) in $REPO"
+echo "    Timeout: ${TIMEOUT}s, Interval: ${INTERVAL}s"
+
+ELAPSED=0
+FAILED_WORKFLOWS=()
+PASSED_WORKFLOWS=()
+
+while [[ $ELAPSED -lt $TIMEOUT ]]; do
+  # Fetch all runs for the branch
+  RUNS_JSON=$(gh run list --branch "$BRANCH" --limit 20 --json workflowName,status,conclusion,headSha,databaseId,displayTitle 2>/dev/null || echo "[]")
+
+  # Filter to runs matching our commit
+  MATCHING_RUNS=$(echo "$RUNS_JSON" | jq --arg sha "$COMMIT" '[.[] | select(.headSha == $sha)]' 2>/dev/null || echo "[]")
+
+  RUN_COUNT=$(echo "$MATCHING_RUNS" | jq 'length' 2>/dev/null || echo "0")
+
+  if [[ "$RUN_COUNT" -eq 0 ]]; then
+    echo "  (${ELAPSED}s) No runs found for $COMMIT_SHORT — waiting for CI to start..."
+    sleep "$INTERVAL"
+    ELAPSED=$((ELAPSED + INTERVAL))
+    continue
+  fi
+
+  # Check completion
+  INCOMPLETE=$(echo "$MATCHING_RUNS" | jq '[.[] | select(.status != "completed")] | length' 2>/dev/null || echo "0")
+  FAILURES=$(echo "$MATCHING_RUNS" | jq '[.[] | select(.status == "completed" and .conclusion == "failure")]' 2>/dev/null || echo "[]")
+  FAILURE_COUNT=$(echo "$FAILURES" | jq 'length' 2>/dev/null || echo "0")
+  SUCCESSES=$(echo "$MATCHING_RUNS" | jq '[.[] | select(.status == "completed" and .conclusion == "success")]' 2>/dev/null || echo "[]")
+  SUCCESS_COUNT=$(echo "$SUCCESSES" | jq 'length' 2>/dev/null || echo "0")
+
+  echo "  (${ELAPSED}s) $RUN_COUNT runs: $SUCCESS_COUNT passed, $FAILURE_COUNT failed, $INCOMPLETE pending"
+
+  # All complete?
+  if [[ "$INCOMPLETE" -eq 0 ]]; then
+    if [[ "$FAILURE_COUNT" -eq 0 ]]; then
+      echo "✅ All $SUCCESS_COUNT workflow(s) passed for $COMMIT_SHORT"
+      if $OUTPUT_JSON; then
+        echo "$SUCCESSES" | jq '{status:"success",commit:$sha,workflows:.}' --arg sha "$COMMIT_SHORT"
+      fi
+      exit 0
+    else
+      echo "❌ $FAILURE_COUNT workflow(s) FAILED:"
+      echo "$FAILURES" | jq -r '.[] | "    \(.workflowName) — https://github.com/'"$REPO"'/actions/runs/\(.databaseId)"'
+      echo ""
+      echo "Handoff: set handoff.next_skill = fix-bug in specs/state.yaml"
+      if $OUTPUT_JSON; then
+        echo "$FAILURES" | jq '{status:"failure",commit:$sha,failed_workflows:.}' --arg sha "$COMMIT_SHORT"
+      fi
+      exit 1
+    fi
+  fi
+
+  sleep "$INTERVAL"
+  ELAPSED=$((ELAPSED + INTERVAL))
+done
+
+echo "❌ Timeout: CI did not complete within ${TIMEOUT}s"
+echo "    Branch: $BRANCH, Commit: $COMMIT_SHORT"
+exit 2

package/skills/align-grid/SKILL.md

@@ -2,6 +2,7 @@
 name: align-grid
 description: "Build editorial/magazine/report webpages on a GENUINE Müller-Brockmann modular grid (International Typographic Style) — not a decorative one. Encodes the discipline (columns + modules + baseline, grotesque type, flush-left, restrained black/white/red palette) AND the hard-won front-end engineering to make the grid real, visible, and verified: one CSS-variable source of truth, an interactive grid-toggle overlay that lives in the SAME content box as the content, subgrid \"bands\" so every element snaps to a column line, an 8px baseline lock, and runtime OPTICAL ALIGNMENT that puts display type's ink (not its box) on the line. Ships with a scaffold generator and a Puppeteer verification harness that proves 0px adherence."
 model: sonnet
+effort: standard
 ---
 
 # Müller-Brockmann Grid Systems — built real, visible, and verified

package/skills/assess-impact/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: assess-impact
 model: sonnet
+effort: standard
 description: Analyze the blast radius of a proposed change before any code is written. Maps dependents, affected stories, and test coverage. Produces specs/IMPACT_LATEST.md. Use before plan-work on any non-trivial change, when touching a shared module, or when the user asks "what does this break?".
 ---
 

package/skills/audit-code/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: audit-code
 model: haiku
+effort: standard
 description: Self-review checklist for the coding agent to run before dispatching a reviewer. Checks CONVENTIONS.md compliance, Boy Scout Rule, test coverage, types, and SOLID. Produces a pass/fail checklist. Use before request-review, before committing, or when user asks for a code quality check.
 ---
 

package/skills/audit-plan/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: audit-plan
 model: sonnet
+effort: standard
 description: Evaluate an incoming project plan against bigpowers principles and conventions, surface gaps, and produce a READY/NOT READY verdict before engagement begins. Use when a new project arrives, when adapting a foreign plan, or before running seed-conventions on an unfamiliar codebase.
 ---
 

package/skills/build-epic/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: build-epic
 model: sonnet
+effort: standard
 description: Eight-step epic build cycle — reads state.yaml, execution-status.yaml, and one epic capsule; updates status via bp-yaml-set or direct edit. Resume mode runs one step per invocation. Use instead of ad-hoc execute-plan for release work.
 ---
 

package/skills/change-request/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: change-request
 model: sonnet
+effort: standard
 description: Add a new requirement or reorder epics by WSJF against specs/release-plan.yaml and epic capsule directories. Modes Add and Reorder. Use when a new requirement arrives mid-release or the plan needs prioritization.
 ---
 

package/skills/commit-message/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: commit-message
 model: haiku
+effort: standard
 description: Reviews working-tree changes, then drafts a Conventional Commits title/body and states the semantic-release version bump a single such commit would imply. Also notes which defensive-code categories were touched. Use when the user wants to commit recent work, prepare a Conventional Commits message, or asks for semantic-release / semver-consistent messaging before git commit.
 ---
 

package/skills/compose-workflow/SKILL.md

@@ -2,6 +2,7 @@
 name: compose-workflow
 description: Chain multiple bigpowers skills into a custom workflow recipe saved in specs/. Use when a project repeats a non-standard skill sequence, or user wants a documented playbook beyond orchestrate-project modes.
 model: sonnet
+effort: standard
 ---
 
 # Compose Workflow

package/skills/craft-skill/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: craft-skill
 model: sonnet
+effort: standard
 description: Create new bigpowers skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill for the bigpowers lifecycle.
 ---
 

package/skills/deepen-architecture/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: deepen-architecture
 model: sonnet
+effort: standard
 description: Find deepening opportunities in a codebase, informed by the domain language in specs/tech-architecture/tech-stack.md and the decisions in specs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
 ---
 

package/skills/define-language/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: define-language
 model: sonnet
+effort: standard
 description: Extract a DDD-style ubiquitous language glossary from the current conversation, flagging ambiguities and proposing canonical terms. Saves to specs/UBIQUITOUS_LANGUAGE_LATEST.md. Use when user wants to define domain terms, build a glossary, harden terminology, create a ubiquitous language, or mentions "domain model" or "DDD".
 ---
 

package/skills/define-success/SKILL.md

@@ -3,6 +3,7 @@ ARCHIVED: content absorbed into plan-work
 ---
 name: define-success
 model: sonnet
+effort: standard
 description: Convert an imperative task statement into explicit "step → verify: <cmd>" pairs before implementation begins. Use before plan-work when success criteria are unclear, when a task lacks verifiable checkpoints, or when user says "how will we know this is done?".
 ---
 

package/skills/delegate-task/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: delegate-task
 model: sonnet
+effort: standard
 description: Delegate one complex task to a single subagent, review its work in two stages before merging back. Sequential — one agent at a time, with oversight. Use when a task is complex and requires careful review before the result is accepted. Distinct from dispatch-agents (no parallelism here; reviewer sees full diff before proceeding).
 ---
 

package/skills/deploy/SKILL.md

@@ -2,6 +2,7 @@
 name: deploy
 description: "Build → verify artifact → deploy → wait → smoke deployment pipeline. Platform-agnostic (MCP or CLI), with configurable timeout, retry with exponential backoff, and integrated health-check. The deploy half of CI/CD: run after build to push to production."
 model: sonnet
+effort: standard
 ---
 
 # Deploy

package/skills/design-interface/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: design-interface
 model: opus
+effort: standard
 description: Generate multiple radically different interface designs for a module using parallel sub-agents, then compare trade-offs. Based on "Design It Twice" from A Philosophy of Software Design. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".
 ---
 

package/skills/develop-tdd/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: develop-tdd
 model: sonnet
+effort: standard
 description: Test-driven development with red-green-refactor loop using vertical slices. Use for features (epic tasks) or bugs (specs/bugs/BUG-*.md).
 ---
 

package/skills/diagnose-root/SKILL.md

@@ -2,6 +2,7 @@
 name: diagnose-root
 description: Run 4-phase root cause analysis — reproduce, isolate, hypothesize, verify. Use when a bug is confirmed but root cause is unclear, after investigate-bug, or when user mentions root cause analysis.
 model: sonnet
+effort: standard
 ---
 
 # Diagnose Root

package/skills/dispatch-agents/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: dispatch-agents
 model: sonnet
+effort: standard
 description: Dispatch multiple subagents in parallel on independent tasks. No waiting between them — all run concurrently. Use when tasks are truly decoupled and speed matters. Distinct from delegate-task (concurrent here, no inter-task review gate).
 ---
 

package/skills/edit-document/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: edit-document
 model: sonnet
+effort: standard
 description: Edit and improve documents by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, restructure, or improve any document — including specs/ files, articles, READMEs, or technical writing.
 ---
 

package/skills/elaborate-spec/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: elaborate-spec
 model: opus
+effort: standard
 description: Refine a rough idea into a clear, detailed specification through dialogue. Does not produce code. Use when user has a vague idea, wants to think through a feature before planning, or needs to turn "I want X" into a concrete spec.
 ---
 

package/skills/enforce-first/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: enforce-first
 model: haiku
+effort: standard
 description: Apply the F.I.R.S.T test quality rubric (Fast, Independent, Repeatable, Self-Validating, Timely) to a test suite or individual tests. Use when develop-tdd is writing tests, when test quality needs to be checked, or when user mentions F.I.R.S.T or "test quality".
 ---
 

package/skills/evolve-skill/SKILL.md

@@ -2,6 +2,7 @@
 name: evolve-skill
 description: Benchmark-gated skill evolution — consume bigpowers-benchmark report, propose plan-work change, edit skill via craft-skill, re-run benchmark, record ADR. Use when a skill underperforms on benchmark or stocktake finds systemic gap.
 model: opus
+effort: standard
 ---
 
 # Evolve Skill

package/skills/execute-plan/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: execute-plan
 model: haiku
+effort: standard
 description: Batch-execute tasks from the active epic capsule sequentially, with a human checkpoint after each step. Use when user has an approved plan and wants step-by-step oversight.
 ---
 

package/skills/extract-design/SKILL.md

@@ -2,6 +2,7 @@
 name: extract-design
 description: "Extract a Google DESIGN.md file from an HTML prototype (claude.ai/design or any styled page) using Puppeteer, producing machine-readable tokens and AI-generated prose. Use when the user has an HTML prototype and wants a DESIGN.md to anchor their project's visual identity, or when seed-conventions has just scaffolded a new project."
 model: sonnet
+effort: standard
 ---
 
 # Extract DESIGN.md from HTML

package/skills/fix-bug/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: fix-bug
 model: sonnet
+effort: standard
 description: Bug fix orchestrator — active_flow fix_bug; reads specs/bugs/BUG-*.md; chains investigate-bug, develop-tdd, validate-fix. Use when user reports a defect.
 ---
 

package/skills/grill-me/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: grill-me
 model: sonnet
+effort: standard
 description: Interactive assumption-surfacing Q&A that stress-tests a plan through relentless questioning until every decision is resolved. Use when user wants to challenge a plan, validate decisions from conversation/context, or mentions "grill me". For doc-grounded variant, use grill-with-docs.
 ---
 

package/skills/grill-with-docs/SKILL.md

@@ -2,6 +2,7 @@
 name: grill-with-docs
 description: Doc-grounded variant of grill-me — stress-tests plan assumptions by fetching and citing real library or API documentation. Every challenge must cite a real URL. Use when the plan depends on a specific library or external API.
 model: opus
+effort: standard
 ---
 
 # Grill With Docs

package/skills/guard-git/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: guard-git
 model: haiku
+effort: standard
 description: Block dangerous git commands (push, force push, reset --hard, clean, branch -D, checkout/restore .) and enforce Conventional Commits & Branch Protection before an AI agent runs them. Installs hook scripts for Claude Code, Cursor, Cursor CLI, and Gemini CLI; documents Google Antigravity Terminal deny lists. Use when the user wants git safety hooks, to block git push or destructive git in agents, or to mirror the same policy across AI coding tools.
 ---
 

package/skills/hook-commits/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: hook-commits
 model: haiku
+effort: standard
 description: Set up pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
 ---
 

package/skills/inspect-quality/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: inspect-quality
 model: sonnet
+effort: standard
 description: Interactive QA session where user reports bugs or issues conversationally, and the agent logs them to specs/bugs/registry.yaml with a structured audit schema. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, or mentions "QA session".
 ---
 

package/skills/investigate-bug/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: investigate-bug
 model: sonnet
+effort: standard
 description: Investigate a bug or issue by exploring the codebase to find root cause, then write a TDD-based fix plan to specs/bugs/BUG-*.md. Use when user reports a bug, wants to investigate a problem, mentions "triage", or wants to plan a fix.
 ---
 

package/skills/kickoff-branch/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: kickoff-branch
 model: haiku
+effort: standard
 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".
 ---
 

package/skills/map-codebase/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: map-codebase
 model: sonnet
+effort: standard
 description: "Derives the tech-stack doc from scratch by scanning the codebase — analyzes stack, architecture, and gray areas (error handling, API shapes) and persists findings into specs/tech-architecture/tech-stack.md. Run when the tech doc doesn't exist yet; use survey-context to consume it once it does."
 ---
 

package/skills/migrate-spec/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: migrate-spec
 model: sonnet
+effort: standard
 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.
 ---
 

package/skills/model-domain/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: model-domain
 model: sonnet
+effort: standard
 description: Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates specs/tech-architecture/tech-stack.md and specs/adr/ inline as decisions crystallise. Use when user wants to stress-test a plan against their project's domain language and documented decisions.
 ---