@drunkcoding/agents-and-skills 0.0.25 → 0.0.26

package/plugins/team-superpower/commands/team-feature.md

@@ -1,319 +0,0 @@
----
-description: Launch a Superpowers-compliant agent team (v6 single-session lifecycle) to deliver a feature end-to-end with at most 3 owner touchpoints, with automatic cleanup after the finish phase.
-argument-hint: <one-line feature idea>
----
-
-You are the **main session** of the team-superpower v6 single-session lifecycle. The main session owns the full lifecycle directly — no separate lead/coordinator agent is spawned. You run mode pick, TeamCreate, phase A → H, SPAWN_REQUEST handling, RESTART_REQUEST handling, qc-engineer spawn, cleanup, push. You are the **sole spawner** for the team — no teammate can spawn (platform rule: "no nested teams").
-
-> **Main-session model:** run this command in an **Opus** session. The main session carries cross-phase reasoning (mode pick, escalation triage, restart approval, finish-branch recovery). Teammates are pinned via their agent frontmatter — they spawn on their pinned model regardless of the main session's model. If the main session is started on Sonnet, halt and ask the owner to relaunch on Opus.
->
-> **Thinking discipline:** adaptive. Use extended (high-effort) thinking for every gate decision, SPAWN_REQUEST classification, RESTART_REQUEST approval, escalation triage, FINISH_BLOCKED recovery, worktree cleanup branching. Routine heartbeats, SendMessage forwarding, and shared-task-list status reads may be quick.
-
-Set effort high at the start of your first turn: `/effort xhigh` and report `effort_set: xhigh`.
-
-Owner's feature request:
-
-$ARGUMENTS
-
-## Parsing the launch flags
-
-Before doing anything else, parse override flags from the owner's request. Tokens are space-separated, may appear before the feature description, and use `=` to bind their value:
-
-- `--mode=<solo|single-agent|team>` — force execution mode; skip the heuristic ladder.
-- `--size=<minimal|standard|full>` — force team size (only meaningful with `--mode=team`).
-- `--explain` — run mode pick, print the decision, and STOP. Do not spawn anything.
-
-If any of these flags appear, strip them from `$ARGUMENTS` and treat the remainder as the actual launch message. Record the flags used in the checkpoint field `overrides_applied:`.
-
-## Required prechecks (run these first, in order)
-
-0. **Main-session model self-attestation.** State which model you are running on. If not Opus, halt and instruct the owner: "Main session must be on Opus. Relaunch with `claude --model opus` and rerun `/team-feature`."
-1. Confirm Superpowers plugin is installed: `claude plugin list | grep superpowers`. If missing, halt and instruct: `/plugin install superpowers@claude-plugins-official`. Capture version (`claude plugin list --json`) — write it to the checkpoint.
-2. Confirm Claude Code version `2.1.32` or later: `claude --version`. If older, halt.
-3. Confirm `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` is set. If not, halt and instruct the owner to add it to `~/.claude/settings.json` under `env`.
-4. Generate a kebab-case `<slug>` from the owner's request. Use it in every artifact filename. The team MUST be named exactly `superpower-<slug>` — every cleanup primitive depends on that convention.
-5. Create directories if missing: `docs/superpowers/{sessions,specs,plans,handovers,reviews}`.
-6. Seed `docs/superpowers/ESCALATION.md` from `${CLAUDE_PLUGIN_ROOT}/assets/ESCALATION.md` if not present. Seed `docs/superpowers/README.md` from `${CLAUDE_PLUGIN_ROOT}/assets/SESSION_README.md` if missing. Commit any seeded files.
-
-## Auto-resume detection (run before mode pick)
-
-On invocation, before picking mode, scan for in-progress features:
-
-1. List `~/.claude/teams/superpower-*/config.json` files. Each is a candidate slug.
-2. List `docs/superpowers/handovers/*-handover.md` files with NO matching `docs/superpowers/reviews/*-qc-report.md`.
-3. List plans referenced by handovers in (2) with incomplete `PHASE_COMPLETE` markers.
-4. Check `git log --oneline <base>..HEAD` for partial plan-task commits not pushed.
-5. Match slug against the worktree dir name or the owner's launch text.
-
-If any candidate matches, present:
-
-```
-Found in-progress feature: <slug> at phase <X>
-  Spec:        <path>
-  Arch-map:    <path>
-  Plan:        <path>
-  Handover:    <path>
-  Last commit: <sha> "<msg>"
-Continue this feature, or start fresh?
-  [1] Continue (re-spawn teammates per current phase)
-  [2] Start fresh (archive prior artefacts; new feature)
-```
-
-On `[1] Continue`:
-- If team config (`~/.claude/teams/superpower-<slug>/`) still exists: skip TeamCreate.
-- If gone: `TeamCreate(superpower-<slug>)`.
-- Re-spawn teammates per current phase (team-leader for B–F, qc-engineer for G, finish flow for H).
-- Spawn prompts include `"this is a resume; read existing handover/spec/plan; continue from current state; do not re-run completed work"`.
-
-On `[2] Start fresh`:
-- Move existing artefacts under `docs/superpowers/archive/YYYY-MM-DD-<slug>/`.
-- Run cleanup on stale team config.
-- Proceed to mode pick for new feature.
-
-If multiple candidates: list all, owner picks one or `[0] start fresh`.
-If none: skip to mode pick.
-
-## Modes
-
-### Solo mode (1 touchpoint)
-
-For bug fix, typo, rename, version bump, single-file/≤10-line diff.
-
-No TeamCreate, no teammates. The main session runs the work itself: locates affected files, drafts a combined briefing (bug statement + diff preview + verification step), presents to owner for approval (touchpoint 1), applies the change, runs `test_command`, commits, pushes, notifies. See spec §9.1.
-
-### Single-agent mode (1 touchpoint)
-
-For small enhancement, 1–3 files, no architecture impact.
-
-The main session drafts a combined briefing (one-paragraph spec + one-task plan), presents to owner for combined approval (touchpoint 1). On approval: `TeamCreate`, spawn exactly 1 implementer (Sonnet/medium). Implementer runs TDD, static checks, commits. Main session shuts down implementer, spawns qc-engineer for a single round. On pass: push + cleanup + notify. On blocking after 3 rounds: recovery escalation. See spec §9.2.
-
-### Team mode (2 touchpoints + finish)
-
-For feature work spanning ≥2 modules or ≥4 files, or introducing a new component.
-
-The main session runs the full single-team lifecycle (below). Owner touchpoints: spec sign-off (after architect drives discussion), plan approval (after planner produces it), finish-branch decision (in phase H).
-
-#### Heuristic ladder (when `--mode` is not set)
-
-1. Trivial keywords (`typo`, `rename`, `bump`, `comment-out`, `revert`, `hotfix`) OR single-file scope OR ≤10-line diff → **solo**.
-2. Small-scope verb (`add`, `tweak`, `expose`) + single-side signal (BE-only or FE-only) + no discovery language → **single-agent**.
-3. Otherwise → **team**.
-
-Forced overrides:
-- `security.domain ∈ {payments, healthcare}` OR `security.pii: yes` in CLAUDE.md → forces `team` mode + `size=full` (security-engineer must run in phase A).
-- Regulated keywords (`PCI`, `HIPAA`, `GDPR`, `audit`, `compliance`, `legal`) in launch message → same.
-
-#### Team size (team mode only)
-
-- **minimal** — solution-architect + feature-planner + team-leader + 1 BE or 1 FE + qc-engineer (5).
-- **standard** (default) — adds the second implementer side when shape is full-stack (6).
-- **full** — adds security-engineer in phase A (7 lifetime).
-
-## Team-mode lifecycle (spec §3.1)
-
-1. `TeamCreate(superpower-<slug>)`.
-2. Spawn phase-A members:
-   - `solution-architect` (Opus / high)
-   - `feature-planner` (Sonnet / high)
-   - `security-engineer` IFF CLAUDE.md `security.domain` is one of `payments | healthcare | regulated`.
-3. Hand owner control. Architect drives spec discussion. **Touchpoint 1 = spec sign-off.**
-4. Architect produces arch-map. Planner produces plan. **Touchpoint 2 = plan approval.**
-5. Architect writes handover artefact at `docs/superpowers/handovers/YYYY-MM-DD-<slug>-handover.md`.
-6. Architect posts `HANDOVER_READY <slug>`.
-7. Main session shuts down planner, security-engineer, architect (SendMessage shutdown request; teammate approves and exits).
-8. Main session spawns `team-leader` (Opus / high). Spawn prompt names the handover path.
-9. Main session awaits messages from team-leader:
-   - `SPAWN_REQUEST wave=<id> roles_needed=<map> brief_path=<path> expected_tasks=<list>` → see "SPAWN_REQUEST handling" below.
-   - `PHASE_COMPLETE <N>` → ack; await next.
-   - `PLAN_COMPLETE` → shut down team-leader + all implementers. Transition to phase G.
-   - `RESTART_REQUEST <reason>` → see "RESTART_REQUEST handling" below.
-10. Phase G: spawn `qc-engineer` (Sonnet / high). Spawn prompt names spec + plan + handover paths.
-11. Await qc-engineer:
-    - `QC_PASS` → shut down qc-engineer. Phase H.
-    - `QC_REWORK_NEEDED <count>` → shut down qc-engineer; re-spawn team-leader for rework dispatch; loop back to step 9. Max `limits.max_qc_rounds` (default 3) QC rounds.
-12. Phase H: run finish-branch decision (below), then cleanup, then notify owner with final summary.
-
-There is **no architect standby**. Architecturally significant questions during phases B–F trigger `RESTART_REQUEST`, which presents a recovery touchpoint to the owner.
-
-## SPAWN_REQUEST handling
-
-When team-leader posts:
-
-```
-SPAWN_REQUEST wave=<plan-phase>.<wave>
-roles_needed: { backend-developer: N, frontend-developer: M }
-brief_path: .team-superpower/spawn-briefs/wave-<plan-phase>.<wave>.md
-expected_tasks: [<task-id-1>, <task-id-2>, ...]
-```
-
-Main session:
-1. Reads the brief file at `brief_path`.
-2. `TaskCreate` for each task-id in `expected_tasks`. Title carries the `impl:` prefix per spec §8.2; metadata carries `wave: <plan-phase>.<wave>` (so the TaskCreated hook accepts it); body excerpted from the brief.
-3. Spawns the requested `roles_needed` counts. Each implementer's spawn prompt:
-
-   ```
-   You are a <role> on team superpower-<slug>. Read the next unclaimed unblocked task in the shared task list at ~/.claude/tasks/superpower-<slug>/. Follow its brief: TDD (RED → GREEN → REFACTOR), then lint+format+typecheck (capture to .team-superpower/static-check-<task-id>.log), then commit per team format. After commit, self-claim next unclaimed unblocked task or shut down if none.
-   ```
-
-4. Replies to team-leader: `SPAWN_DONE wave=<plan-phase>.<wave> agent_ids=[...]`.
-
-Concurrency cap: refuse to spawn beyond `limits.max_concurrent_teammates` (default 5). Excess spawns are queued; reply notes `queued: <ids>`.
-
-## RESTART_REQUEST handling
-
-When team-leader (or qc-engineer) posts `RESTART_REQUEST <reason>`:
-
-1. Read `.team-superpower/restart-count` (default 0). If ≥ `limits.max_cycle_restarts` (default 2): escalate to owner with "Manual intervention required after N restarts. Feature appears not tractable in this shape."
-2. Otherwise present recovery touchpoint to owner:
-
-   ```
-   Cycle restart needed: <reason>
-   Current state:
-     Phase: <X>
-     Last commit: <sha> "<msg>"
-     Restart count: <n>/<max>
-
-   Approve restart from phase A?
-     [1] Approve restart
-     [2] Cancel feature (manual takeover)
-   ```
-
-3. On approval: increment `.team-superpower/restart-count`. Shut down all current teammates. Re-spawn solution-architect + feature-planner (+ security-engineer if originally spawned). Spawn prompts name the existing spec, arch-map, plan, and partial commits as input. Phase A re-runs with delta scope; the new handover supersedes the prior one.
-
-Recovery touchpoints from RESTART_REQUEST do **not** count against the 3-touchpoint budget.
-
-## Phase H — finish-branch and CI gate
-
-After QC pass, the main session drives the finish-branch decision:
-
-1. Push the branch.
-2. If `ci.provider != none`: poll the CI provider for `ci.required_checks` up to `ci.poll_timeout_minutes` (default 20).
-3. Surface one finish-branch menu (see below) to owner. This is the third (and final) touchpoint in team mode.
-
-### CI-specific menus
-
-| CI state | Menu |
-|---|---|
-| green | `merge / pr_opened / keep / discarded` |
-| red | `merge / pr_opened / keep / discarded / show_ci_logs` |
-| timeout | `re-poll / switch_to_pr_opened / escalate` |
-
-### 5-option merge-failure menu
-
-If merge fails (`conflict` / `non-ff` / `dirty-worktree` / `push-rejected`):
-
-```
-FINISH_BLOCKED <reason>
-  [1] retry           — re-attempt merge (cap 3)
-  [2] pr_opened       — open PR instead of merging
-  [3] kept            — leave branch alone, end session
-  [4] discarded       — discard branch
-  [5] escalate        — open an escalation
-```
-
-Retry cap: 3. After the 3rd failed retry the menu drops `retry` and forces a different choice.
-
-## Automatic cleanup (runs after `FINISH_DONE`)
-
-Main session runs cleanup immediately after `FINISH_DONE`:
-
-### Step A — Verify safety preconditions
-
-- All phases marked complete in checkpoint.
-- Every expected commit present on the branch.
-- Every teammate `idle` (no in-flight task).
-- `restart_count` and `qc_rounds` recorded in checkpoint.
-
-If any precondition fails, halt with the failed item and leave platform state intact for `/team-cleanup`.
-
-### Step B — Shut down teammates gracefully
-
-For each remaining teammate: request shutdown via SendMessage; teammate approves and exits. If any teammate refuses, escalate; do not force.
-
-### Step C — Run the canonical team cleanup
-
-Invoke the canonical Agent-Teams "clean up the team" primitive (removes `~/.claude/teams/superpower-<slug>/` and `~/.claude/tasks/superpower-<slug>/`).
-
-### Step D — Manual sweep (only if Step C left residue)
-
-Remove residual files via `bash plugins/team-superpower/scripts/team-state.sh cleanup <slug>` — this also clears `.team-superpower/spawn-briefs/` and `.team-superpower/static-check-*.log`.
-
-### Step D.5 — Worktree removal (on successful merge only)
-
-If `decision = merged` AND `worktree_origin != reused`: `git worktree remove <path>`. On failure surface the 4-option remove-failure menu (show files + retry / force-remove with confirmation / keep / escalate).
-
-If `worktree_origin = reused`, skip; record `worktree: removal-skipped:reused-existing-worktree`.
-
-### Step E — Final checkpoint commit
-
-Append `## Closing` block to the checkpoint:
-
-```
-finished at: <ISO datetime>
-decision: <merged|pr_opened|kept|discarded>
-cleanup: complete
-cycle_restart_count: <N>
-qc_rounds: <N>
-worktree: <state>
-worktree_path: <path>   (only when state implies the dir still exists)
-```
-
-Commit the checkpoint.
-
-### Step F — If anything failed
-
-Halt with the failure mode. The owner runs `/team-cleanup <slug>` from a fresh session.
-
-## Within-phase stall watchdog
-
-The main session detects no SendMessage activity AND no shared-task-list transitions for `limits.phase_stall_minutes` (default 30) within the current phase: pings the most-recently-active teammate. If the next 30-minute window is also silent, surfaces a §7 escalation. Heartbeat-at-phase-boundaries alone does not catch silent hangs.
-
-## Owner touchpoints (the ONLY allowed pings to the owner)
-
-Team mode (3 max):
-1. **Spec sign-off** (mid phase A).
-2. **Plan approval** (end phase A).
-3. **Finish-branch decision** (phase H).
-
-Single-agent mode (1):
-1. **Combined spec + plan approval**.
-
-Solo mode (1):
-1. **Diff preview + verification step**.
-
-Recovery touchpoints (these do **not** count against the budget):
-- Model fallback (teammate running on different model than pinned).
-- `RESTART_REQUEST` approval.
-- CI timeout decision.
-- Manual intervention after restart cap.
-
-Anything else that reaches the owner MUST use the §7 escalation template in `assets/ESCALATION.md`.
-
-## Checkpointing
-
-`docs/superpowers/sessions/YYYY-MM-DD-<slug>.md` is updated by the main session at every phase boundary. Frontmatter carries `slug`, `mode`, `size`, `mode_reasoning`, `overrides_applied`, `superpowers_version`, `worktree_origin`, `cycle_restart_count`.
-
-Body sections:
-
-```
-## Phases       — checklist with file paths to artefacts
-## Teammates    — role / agent id / current task or idle
-## Open escalations
-## Assumptions  — one line per non-owner decision
-## Cycle history — one row per RESTART_REQUEST
-## Closing      — final block written by Step E
-```
-
-The main session commits this file after every phase transition. If the main session crashes, the feature lives in this file.
-
-## Hard rules
-
-1. **Main session is the sole spawner.** team-leader, qc-engineer, and implementers never call `Agent` themselves — they post `SPAWN_REQUEST` and let the main session handle it. This honours the Claude Code Agent Teams "no nested teams" constraint.
-2. **Main session does not run phase work in team mode.** All feature implementation is delegated to teammates. In solo mode the main session does the work itself; in single-agent mode the main session spawns one implementer.
-3. **One team per feature.** A single `TeamCreate superpower-<slug>` runs the entire lifecycle. Membership rolls forward by spawn + shutdown across phases A–H.
-4. **No per-task QA loop.** Implementers self-enforce TDD + static checks; the `TaskCompleted` hook gates on `.team-superpower/static-check-<task-id>.log`.
-5. **Owner-touchpoint budget is sacred.** 3 in team mode, 1 in single-agent / solo. Recovery touchpoints are separate.
-6. **Restart cap is sacred.** 2 `RESTART_REQUEST` cycles per feature; a 3rd cycle escalates as "feature not tractable in this shape".
-7. **QC rounds cap is sacred.** 3 end-of-plan QC rounds; a 4th triggers owner escalation.
-8. **AGENTS.md is a read-only contract for agents.** The `TaskCompleted` hook rejects any commit that modifies it from inside a teammate; only the main session may write it.
-9. **No `--dangerously-skip-permissions`.** Hooks exist because Superpowers gates exist. Use the §7 escalation template instead.

package/plugins/team-superpower/hooks/hooks.json

@@ -1,25 +0,0 @@
-{
-  "hooks": {
-    "TeammateIdle": [
-      {
-        "hooks": [
-          { "type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/hooks/teammate-idle.sh" }
-        ]
-      }
-    ],
-    "TaskCreated": [
-      {
-        "hooks": [
-          { "type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/hooks/task-created.sh" }
-        ]
-      }
-    ],
-    "TaskCompleted": [
-      {
-        "hooks": [
-          { "type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/hooks/task-completed.sh" }
-        ]
-      }
-    ]
-  }
-}

package/plugins/team-superpower/hooks/task-completed.sh

@@ -1,254 +0,0 @@
-#!/usr/bin/env bash
-# TaskCompleted hook — v5 gate for implementation completions.
-#
-# Accepts a JSON payload on stdin with at minimum:
-#   - task.title: string
-#   - task.metadata.wave: string (e.g. "1.1", "1.rework", "qc-rework")
-#   - task.metadata.iteration_count: integer (optional)
-#   - task.metadata.reflection: string (optional, required when iteration_count > cap)
-#   - task.metadata.retrieval_requests: integer (optional)
-#   - task.metadata.commits: array of git SHAs (optional)
-#   - task.metadata.contract_files: array of paths (optional, for contract-publish)
-#
-# v5 checks (delta from v4):
-#   - REMOVED: per-task QA verification (qa_verified_at, QA-verified commit line, qa_rounds cap, trivial=true claims)
-#   - REMOVED: 6-field escalation template validation (Phase/Context/Options/Recommendation/Need from you/Peer attempts)
-#   - REMOVED: v4 wave format (single integer); v5 wave is dotted (e.g. "1.1") or rework label
-#   - ADDED: MISSING_STATIC_CHECKS — every impl:* task must have a .team-superpower/static-check-<task-id>.log
-#     containing exit=0 for all sections (lint, format, typecheck).
-#   - ADDED: MISSING_REWORK_REFERENCE — every impl:rework-* task must have a `Reworks: <orig-id>` line
-#     in at least one commit body.
-#
-# v5 preserved checks:
-#   - migration serialization (impl:*-migration-* anti-race)
-#   - contract-publish must touch a contracts file
-#   - AGENTS.md protection (no agent commit may touch docs/superpowers/AGENTS.md)
-#   - retrieval budget cap + premature Flagged-assumptions guard
-#   - MAX_ITERATIONS guardrail
-
-set -euo pipefail
-
-LOG_DIR="${CLAUDE_PROJECT_DIR:-$PWD}/.claude/hooks"
-LOG_FILE="$LOG_DIR/log.jsonl"
-mkdir -p "$LOG_DIR"
-
-ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-
-payload="$(cat || true)"
-
-if [ -z "$payload" ]; then
-  printf '{"ts":"%s","hook":"task-completed","skipped":"empty payload"}\n' "$ts" >> "$LOG_FILE"
-  exit 0
-fi
-
-if ! command -v jq >/dev/null 2>&1; then
-  printf '{"ts":"%s","hook":"task-completed","skipped":"jq not installed"}\n' "$ts" >> "$LOG_FILE"
-  exit 0
-fi
-
-title="$(printf '%s' "$payload" | jq -r '.task.title // .title // ""' 2>/dev/null || echo "")"
-
-printf '{"ts":"%s","hook":"task-completed","title":%s}\n' \
-  "$ts" \
-  "$(printf '%s' "$title" | jq -Rs .)" \
-  >> "$LOG_FILE"
-
-# Resolve parse-claudemd.sh helper for limits.* lookups.
-parse_helper="${CLAUDE_PLUGIN_ROOT:-}/scripts/parse-claudemd.sh"
-if [ -z "${CLAUDE_PLUGIN_ROOT:-}" ]; then
-  hook_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-  parse_helper="$hook_dir/../scripts/parse-claudemd.sh"
-fi
-
-# v5: wave metadata. impl:* tasks must carry a `wave:` string. Accepted shapes:
-#   - "<plan-phase>.<wave>"  e.g. "1.1", "2.3"
-#   - "<plan-phase>.rework"  e.g. "1.rework"
-#   - "qc-rework"
-case "$title" in
-  impl:*)
-    wave="$(printf '%s' "$payload" | jq -r '.task.metadata.wave // .metadata.wave // ""' 2>/dev/null || echo "")"
-    if [ -z "$wave" ] || ! printf '%s' "$wave" | grep -qE '^([0-9]+\.[0-9]+|[0-9]+\.rework|qc-rework)$'; then
-      printf '{"ts":"%s","hook":"task-completed","warn":"MISSING_WAVE_METADATA","title":%s,"wave":%s}\n' \
-        "$ts" \
-        "$(printf '%s' "$title" | jq -Rs .)" \
-        "$(printf '%s' "$wave" | jq -Rs .)" \
-        >> "$LOG_FILE"
-    fi
-    ;;
-esac
-
-# v5 check 10: MISSING_STATIC_CHECKS. Every impl:* task must have a
-# .team-superpower/static-check-<task-id>.log with exit=0 across lint/format/typecheck.
-case "$title" in
-  impl:*)
-    project_dir="${CLAUDE_PROJECT_DIR:-$PWD}"
-    static_log="$project_dir/.team-superpower/static-check-${title}.log"
-    if [ ! -f "$static_log" ]; then
-      printf '{"ts":"%s","hook":"task-completed","warn":"MISSING_STATIC_CHECKS","title":%s,"reason":"log file not found","path":%s}\n' \
-        "$ts" \
-        "$(printf '%s' "$title" | jq -Rs .)" \
-        "$(printf '%s' "$static_log" | jq -Rs .)" \
-        >> "$LOG_FILE"
-    else
-      # Any exit= line with a non-zero value fails the check.
-      if grep -E '^exit=' "$static_log" | grep -qvE '^exit=0$'; then
-        bad="$(grep -E '^exit=' "$static_log" | grep -vE '^exit=0$' | head -n1 || true)"
-        printf '{"ts":"%s","hook":"task-completed","warn":"MISSING_STATIC_CHECKS","title":%s,"reason":"non-zero exit","line":%s}\n' \
-          "$ts" \
-          "$(printf '%s' "$title" | jq -Rs .)" \
-          "$(printf '%s' "$bad" | jq -Rs .)" \
-          >> "$LOG_FILE"
-      fi
-    fi
-    ;;
-esac
-
-# v5 check 11: MISSING_REWORK_REFERENCE. impl:rework-* tasks must carry a
-# `Reworks: <orig-id-or-qc-issue-id>` line in at least one commit body.
-case "$title" in
-  impl:rework-*)
-    if command -v git >/dev/null 2>&1; then
-      rw_commits="$(printf '%s' "$payload" | jq -r '(.task.metadata.commits // .metadata.commits // [])[]?' 2>/dev/null || true)"
-      if [ -n "$rw_commits" ]; then
-        rw_found=0
-        while IFS= read -r sha; do
-          [ -z "$sha" ] && continue
-          body="$(git show --no-color --no-patch --format=%B "$sha" 2>/dev/null || true)"
-          if printf '%s\n' "$body" | grep -qE '^Reworks:[[:space:]]*[^[:space:]]+'; then
-            rw_found=1; break
-          fi
-        done <<< "$rw_commits"
-        if [ "$rw_found" -ne 1 ]; then
-          printf '{"ts":"%s","hook":"task-completed","warn":"MISSING_REWORK_REFERENCE","title":%s,"reason":"no Reworks: line in commit body"}\n' \
-            "$ts" "$(printf '%s' "$title" | jq -Rs .)" >> "$LOG_FILE"
-        fi
-      else
-        printf '{"ts":"%s","hook":"task-completed","warn":"MISSING_REWORK_REFERENCE","title":%s,"reason":"no commits recorded"}\n' \
-          "$ts" "$(printf '%s' "$title" | jq -Rs .)" >> "$LOG_FILE"
-      fi
-    fi
-    ;;
-esac
-
-# MAX_ITERATIONS guardrail (preserved from v3/v4).
-case "$title" in
-  impl:*)
-    iteration_count="$(printf '%s' "$payload" | jq -r '.task.metadata.iteration_count // .metadata.iteration_count // 0' 2>/dev/null || echo 0)"
-    reflection="$(printf '%s' "$payload" | jq -r '.task.metadata.reflection // .metadata.reflection // ""' 2>/dev/null || echo "")"
-
-    cap=8
-    if [ -f "$parse_helper" ] && [ -f "${CLAUDE_PROJECT_DIR:-$PWD}/CLAUDE.md" ]; then
-      configured="$(bash "$parse_helper" get limits.max_iterations_per_task "${CLAUDE_PROJECT_DIR:-$PWD}/CLAUDE.md" 2>/dev/null || true)"
-      if [ -n "$configured" ] && printf '%s' "$configured" | grep -qE '^[0-9]+$'; then
-        cap="$configured"
-      fi
-    fi
-
-    if [ "${iteration_count:-0}" -gt "$cap" ] && [ -z "$reflection" ]; then
-      printf '{"ts":"%s","hook":"task-completed","warn":"ITERATION_CAP_EXCEEDED","title":%s,"iteration_count":%d,"cap":%d}\n' \
-        "$ts" \
-        "$(printf '%s' "$title" | jq -Rs .)" \
-        "$iteration_count" \
-        "$cap" \
-        >> "$LOG_FILE"
-    fi
-    ;;
-esac
-
-# Retrieval budget (preserved from v4).
-case "$title" in
-  impl:*)
-    retrieval_requests="$(printf '%s' "$payload" | jq -r '.task.metadata.retrieval_requests // .metadata.retrieval_requests // 0' 2>/dev/null || echo 0)"
-    retrieval_cap=2
-    if [ -f "$parse_helper" ] && [ -f "${CLAUDE_PROJECT_DIR:-$PWD}/CLAUDE.md" ]; then
-      configured_r="$(bash "$parse_helper" get limits.retrieval_budget_per_task "${CLAUDE_PROJECT_DIR:-$PWD}/CLAUDE.md" 2>/dev/null || true)"
-      if [ -n "$configured_r" ] && printf '%s' "$configured_r" | grep -qE '^[0-9]+$'; then
-        retrieval_cap="$configured_r"
-      fi
-    fi
-
-    if [ "${retrieval_requests:-0}" -gt "$retrieval_cap" ]; then
-      printf '{"ts":"%s","hook":"task-completed","warn":"RETRIEVAL_BUDGET_EXCEEDED","title":%s,"requests":%d,"cap":%d}\n' \
-        "$ts" "$(printf '%s' "$title" | jq -Rs .)" "$retrieval_requests" "$retrieval_cap" >> "$LOG_FILE"
-    fi
-
-    if command -v git >/dev/null 2>&1; then
-      r_commits="$(printf '%s' "$payload" | jq -r '(.task.metadata.commits // .metadata.commits // [])[]?' 2>/dev/null || true)"
-      if [ -n "$r_commits" ]; then
-        flagged=0
-        while IFS= read -r sha; do
-          [ -z "$sha" ] && continue
-          body="$(git show --no-color --no-patch --format=%B "$sha" 2>/dev/null || true)"
-          if printf '%s\n' "$body" | grep -qE '^Flagged-assumptions:'; then
-            flagged=1; break
-          fi
-        done <<< "$r_commits"
-        if [ "$flagged" -eq 1 ] && [ "${retrieval_requests:-0}" -lt "$retrieval_cap" ]; then
-          printf '{"ts":"%s","hook":"task-completed","warn":"PREMATURE_ASSUMPTION_FLAG","title":%s,"requests":%d,"cap":%d}\n' \
-            "$ts" "$(printf '%s' "$title" | jq -Rs .)" "$retrieval_requests" "$retrieval_cap" >> "$LOG_FILE"
-        fi
-      fi
-    fi
-    ;;
-esac
-
-# AGENTS.md protection (preserved from v4).
-if command -v git >/dev/null 2>&1; then
-  agm_commits="$(printf '%s' "$payload" | jq -r '(.task.metadata.commits // .metadata.commits // [])[]?' 2>/dev/null || true)"
-  if [ -n "$agm_commits" ]; then
-    while IFS= read -r sha; do
-      [ -z "$sha" ] && continue
-      files="$(git show --no-color --name-only --pretty=format: "$sha" 2>/dev/null || true)"
-      if printf '%s\n' "$files" | grep -qE '^docs/superpowers/AGENTS\.md$'; then
-        printf '{"ts":"%s","hook":"task-completed","warn":"AGENT_WROTE_AGENTS_MD","title":%s,"sha":%s}\n' \
-          "$ts" "$(printf '%s' "$title" | jq -Rs .)" "$(printf '%s' "$sha" | jq -Rs .)" >> "$LOG_FILE"
-      fi
-    done <<< "$agm_commits"
-  fi
-fi
-
-# Migration serialization (preserved). v5 widens the prefix match: any task
-# whose title contains the qualifier `-migration-` (e.g. impl:be-migration-*,
-# impl:rework-be-migration-*) is migration-class.
-case "$title" in
-  *-migration-*)
-    other_in_progress="$(printf '%s' "$payload" | jq -r --arg me "$title" '
-      [ .tasks[]?
-        | select((.title // "") != $me)
-        | select(((.title // "") | contains("-migration-")))
-        | select((.status // "") == "in_progress")
-      ] | length' 2>/dev/null || echo 0)"
-    if [ "${other_in_progress:-0}" -gt 0 ]; then
-      printf '{"ts":"%s","hook":"task-completed","warn":"MIGRATION_RACE","title":%s}\n' "$ts" "$(printf '%s' "$title" | jq -Rs .)" >> "$LOG_FILE"
-    fi
-    ;;
-esac
-
-# Contract-publish must touch a contracts file (preserved). v5 widens to any
-# task whose title contains the qualifier `-contract-publish-`.
-case "$title" in
-  *-contract-publish-*)
-    if command -v git >/dev/null 2>&1; then
-      commits="$(printf '%s' "$payload" | jq -r '(.task.metadata.commits // .metadata.commits // [])[]?' 2>/dev/null || true)"
-      patterns="$(printf '%s' "$payload" | jq -r '(.task.metadata.contract_files // .metadata.contract_files // ["contracts/"])[]?' 2>/dev/null || echo "contracts/")"
-      if [ -n "$commits" ]; then
-        touched=0
-        while IFS= read -r sha; do
-          [ -z "$sha" ] && continue
-          files="$(git show --no-color --name-only --pretty=format: "$sha" 2>/dev/null || true)"
-          while IFS= read -r pat; do
-            [ -z "$pat" ] && continue
-            if printf '%s\n' "$files" | grep -qE "(^|/)${pat//./\\.}"; then
-              touched=1; break 2
-            fi
-          done <<< "$patterns"
-        done <<< "$commits"
-        if [ "$touched" -ne 1 ]; then
-          printf '{"ts":"%s","hook":"task-completed","warn":"EMPTY_CONTRACT_PUBLISH","title":%s}\n' "$ts" "$(printf '%s' "$title" | jq -Rs .)" >> "$LOG_FILE"
-        fi
-      fi
-    fi
-    ;;
-esac
-
-exit 0