@drunkcoding/agents-and-skills 0.0.19 → 0.0.23

package/plugins/team-superpower/hooks/teammate-idle.sh

@@ -1,15 +1,37 @@
 #!/usr/bin/env bash
-# TeammateIdle hook — block idle if there are unanswered inbound peer messages.
+# TeammateIdle hook — v5 role-aware routing.
 #
-# Reads the hook event payload from stdin. Expected JSON fields (best-effort —
-# the agent-teams runtime may evolve; we only fail closed on what we can verify):
-#   - mailbox: array of { from, replied, ... }
-#   - teammate: string (the idling teammate's role)
+# Reads the hook event payload from stdin. Expected JSON fields:
+#   - mailbox: array of { from, kind, replied, ... } — recent SendMessage history
+#   - teammate: string (the idling teammate's role; one of
+#       orchestrator | team-leader | solution-architect | feature-planner |
+#       security-engineer | backend-developer | frontend-developer | qc-engineer)
 #
-# Behaviour:
-#   - count messages where from != "lead" AND replied == false
-#   - if count > 0  -> exit 2 with stderr BLOCKED_IDLE
-#   - else          -> exit 0
+# v5 behaviour: routing depends on role.
+#
+#   backend-developer / frontend-developer:
+#     - block if any unanswered message FROM team-leader (implementer owes a reply)
+#     - block if a self-sent ESCALATE has no reply within heartbeat (advisory log)
+#     - otherwise advisory: wave dispatch may still be in flight; ok to idle
+#
+#   team-leader:
+#     - block if SPAWN_REQUEST or RESTART_REQUEST has no SPAWN_DONE / RESTART_DONE
+#       reply from lead/orchestrator within heartbeat (must keep coordinating)
+#     - block if any unanswered ESCALATE from an implementer (must route)
+#     - otherwise advisory tick
+#
+#   qc-engineer:
+#     - block if QC_REWORK_NEEDED has no reply (lead must acknowledge before shutdown)
+#     - otherwise advisory tick
+#
+#   solution-architect / feature-planner / security-engineer (phase A roles):
+#     - block if owner sign-off touchpoint message has no reply yet
+#     - otherwise advisory tick (shutdown is owner-driven via lead)
+#
+#   orchestrator (lead):
+#     - block if any unanswered SPAWN_REQUEST / RESTART_REQUEST inbound from
+#       team-leader (lead is the single spawner)
+#     - otherwise advisory tick (lead drives owner touchpoints separately)
 #
 # Logs every invocation to .claude/hooks/log.jsonl in the project root for tuning.
 
@@ -33,12 +55,95 @@ if ! command -v jq >/dev/null 2>&1; then
   exit 0
 fi
 
-unanswered="$(printf '%s' "$payload" | jq '[.mailbox[]? | select((.from // "") != "lead") | select((.replied // false) == false)] | length' 2>/dev/null || echo 0)"
+teammate="$(printf '%s' "$payload" | jq -r '.teammate // ""' 2>/dev/null || echo "")"
+
+# Helper: count unanswered inbound messages where .from matches a pattern.
+count_unanswered_from() {
+  local from_pattern="$1"
+  printf '%s' "$payload" \
+    | jq --arg p "$from_pattern" \
+        '[.mailbox[]?
+          | select(((.from // "") | test($p)))
+          | select((.replied // false) == false)
+         ] | length' \
+        2>/dev/null \
+    || echo 0
+}
+
+# Helper: count self-sent outbound messages of a given kind with no reply yet.
+count_outbound_unanswered_kind() {
+  local kind_pattern="$1"
+  printf '%s' "$payload" \
+    | jq --arg k "$kind_pattern" \
+        '[.mailbox[]?
+          | select(((.direction // "in") == "out"))
+          | select(((.kind // "") | test($k)))
+          | select((.replied // false) == false)
+         ] | length' \
+        2>/dev/null \
+    || echo 0
+}
+
+warn=""
 
-printf '{"ts":"%s","hook":"teammate-idle","unanswered":%s}\n' "$ts" "$unanswered" >> "$LOG_FILE"
+case "$teammate" in
+  backend-developer|frontend-developer)
+    unanswered_from_leader="$(count_unanswered_from '^team-leader$')"
+    if [ "${unanswered_from_leader:-0}" -gt 0 ]; then
+      warn="BLOCKED_IDLE_implementer_owes_team-leader_reply"
+    fi
+    ;;
+  team-leader)
+    spawn_pending="$(count_outbound_unanswered_kind 'SPAWN_REQUEST|RESTART_REQUEST')"
+    escalate_pending="$(count_unanswered_from '^(backend-developer|frontend-developer)$')"
+    if [ "${spawn_pending:-0}" -gt 0 ]; then
+      warn="BLOCKED_IDLE_team-leader_awaiting_lead_on_spawn_or_restart"
+    elif [ "${escalate_pending:-0}" -gt 0 ]; then
+      warn="BLOCKED_IDLE_team-leader_owes_implementer_escalate_reply"
+    fi
+    ;;
+  qc-engineer)
+    qc_pending="$(count_outbound_unanswered_kind 'QC_REWORK_NEEDED')"
+    if [ "${qc_pending:-0}" -gt 0 ]; then
+      warn="BLOCKED_IDLE_qc-engineer_awaiting_lead_ack"
+    fi
+    ;;
+  solution-architect|feature-planner|security-engineer)
+    handover_pending="$(count_outbound_unanswered_kind 'HANDOVER_READY|SEC_PASSED|SEC_BLOCKED')"
+    if [ "${handover_pending:-0}" -gt 0 ]; then
+      warn="BLOCKED_IDLE_phaseA_awaiting_owner_signoff"
+    fi
+    ;;
+  orchestrator)
+    lead_inbound_pending="$(count_unanswered_from '^team-leader$')"
+    if [ "${lead_inbound_pending:-0}" -gt 0 ]; then
+      warn="BLOCKED_IDLE_orchestrator_unhandled_team-leader_request"
+    fi
+    ;;
+  "")
+    # Unknown role: fall back to legacy v4 behaviour (any unanswered non-lead inbound).
+    legacy_unanswered="$(printf '%s' "$payload" | jq '[.mailbox[]? | select((.from // "") != "lead") | select((.replied // false) == false)] | length' 2>/dev/null || echo 0)"
+    if [ "${legacy_unanswered:-0}" -gt 0 ]; then
+      warn="BLOCKED_IDLE_legacy_unanswered_inbound"
+    fi
+    ;;
+  *)
+    # Unknown but non-empty role — log advisory only, do not block.
+    :
+    ;;
+esac
 
-if [ "${unanswered:-0}" -gt 0 ]; then
-  printf '{"ts":"%s","hook":"teammate-idle","warn":"blocked_idle","unanswered":%s}\n' "$ts" "$unanswered" >> "$LOG_FILE"
+if [ -n "$warn" ]; then
+  printf '{"ts":"%s","hook":"teammate-idle","teammate":%s,"warn":%s}\n' \
+    "$ts" \
+    "$(printf '%s' "$teammate" | jq -Rs .)" \
+    "$(printf '%s' "$warn" | jq -Rs .)" \
+    >> "$LOG_FILE"
+else
+  printf '{"ts":"%s","hook":"teammate-idle","teammate":%s,"ok":true}\n' \
+    "$ts" \
+    "$(printf '%s' "$teammate" | jq -Rs .)" \
+    >> "$LOG_FILE"
 fi
 
 exit 0

package/plugins/team-superpower/scripts/team-state.sh

@@ -1,25 +1,36 @@
 #!/usr/bin/env bash
-# team-state.sh — inspect and clean up team-superpower team state.
+# team-state.sh — inspect and clean up team-superpower v5 team state.
 #
 # Subcommands:
 #   scan                     List every known superpower-* team on this machine.
 #   scan <slug>              Inspect a single slug; print state for the lead/owner.
+#   members <slug>           Read team config.json and list current members + roles.
 #   cleanup <slug>           Dry-run cleanup; print what would be removed (exit 1).
-#   cleanup <slug> --force   Remove team config, task list, tmux session.
+#   cleanup <slug> --force   Remove team config, task list, .team-superpower/ artefacts.
 #
 # Flags (cleanup only):
 #   --force                  Apply the cleanup (otherwise dry-run).
 #   --ignore-heartbeat       Skip the "lead may still be alive" refusal.
 #                            Required when the heartbeat file is < 10 min old.
 #
+# v5 changes (delta from v4):
+#   - Removed: tmux session handling (Agent Teams runs in-process, not in tmux).
+#   - Added: `members` subcommand reads ~/.claude/teams/superpower-<slug>/config.json
+#     and lists current teammates + roles (single-team lifecycle visibility).
+#   - Added: cleanup now removes .team-superpower/ work artefacts (spawn-briefs,
+#     static-check logs, handover artefacts the lead created).
+#   - Added: scan shows cycle_restart_count from docs/superpowers/sessions/<slug>.cycle
+#     if present (for v5's restart-on-stuck telemetry).
+#
 # What this script preserves (always):
-#   - docs/superpowers/{specs,plans,reviews}      durable artefacts
-#   - the project-side checkpoint markdown        kept; appended with a Cleanup record
+#   - docs/superpowers/{specs,plans,reviews,handovers}   durable artefacts
+#   - the project-side checkpoint markdown               kept; appended with a Cleanup record
 #
 # What it removes (with --force):
-#   - ~/.claude/teams/superpower-<slug>/          team config
-#   - ~/.claude/tasks/superpower-<slug>/          shared task list
-#   - tmux session "claude-superpower-<slug>"     best-effort
+#   - ~/.claude/teams/superpower-<slug>/                team config
+#   - ~/.claude/tasks/superpower-<slug>/                shared task list
+#   - .team-superpower/spawn-briefs/                    wave brief files
+#   - .team-superpower/static-check-*.log               per-task static-check logs
 #
 # Idempotent: re-running is safe.
 #
@@ -37,6 +48,7 @@ TEAMS_DIR="$CLAUDE_HOME/teams"
 TASKS_DIR="$CLAUDE_HOME/tasks"
 PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
 SESSIONS_DIR="$PROJECT_DIR/docs/superpowers/sessions"
+ARTEFACTS_DIR="$PROJECT_DIR/.team-superpower"
 HEARTBEAT_TTL_SECONDS=600  # 10 min
 
 print_usage() {
@@ -44,13 +56,17 @@ print_usage() {
 }
 
 team_name_for_slug() { printf 'superpower-%s' "$1"; }
-tmux_name_for_slug() { printf 'claude-superpower-%s' "$1"; }
 
 heartbeat_file_for_slug() {
   local slug="$1"
   printf '%s/%s.heartbeat' "$SESSIONS_DIR" "$slug"
 }
 
+cycle_file_for_slug() {
+  local slug="$1"
+  printf '%s/%s.cycle' "$SESSIONS_DIR" "$slug"
+}
+
 checkpoint_for_slug() {
   local slug="$1"
   if [ ! -d "$SESSIONS_DIR" ]; then return; fi
@@ -87,9 +103,7 @@ cmd_scan() {
     echo "team-superpower teams on this machine:"
     while IFS= read -r s; do
       [ -z "$s" ] && continue
-      local team team_dir hb age
-      team="$(team_name_for_slug "$s")"
-      team_dir="$TEAMS_DIR/$team"
+      local hb age
       hb="$(heartbeat_file_for_slug "$s")"
       age="$(heartbeat_age_seconds "$hb")"
       if [ "$age" -lt 0 ]; then
@@ -101,39 +115,73 @@ cmd_scan() {
     return 0
   fi
 
-  local team team_dir task_dir hb age ckpt tmux_name
+  local team team_dir task_dir hb age ckpt cycle_file restart_count
   team="$(team_name_for_slug "$slug")"
   team_dir="$TEAMS_DIR/$team"
   task_dir="$TASKS_DIR/$team"
   hb="$(heartbeat_file_for_slug "$slug")"
   age="$(heartbeat_age_seconds "$hb")"
   ckpt="$(checkpoint_for_slug "$slug")"
-  tmux_name="$(tmux_name_for_slug "$slug")"
-
-  printf 'slug:              %s\n' "$slug"
-  printf 'team_name:         %s\n' "$team"
-  printf 'team_config:       %s\n' "$team_dir"
-  if [ -d "$team_dir" ]; then printf 'team_config_state: present\n'; else printf 'team_config_state: absent\n'; fi
-  printf 'task_list:         %s\n' "$task_dir"
-  if [ -d "$task_dir" ]; then printf 'task_list_state:   present\n'; else printf 'task_list_state:   absent\n'; fi
-  printf 'checkpoint:        %s\n' "${ckpt:-<none>}"
+  cycle_file="$(cycle_file_for_slug "$slug")"
+  restart_count=0
+  if [ -f "$cycle_file" ]; then
+    restart_count="$(head -n1 "$cycle_file" | tr -d '[:space:]')"
+  fi
+
+  printf 'slug:                  %s\n' "$slug"
+  printf 'team_name:             %s\n' "$team"
+  printf 'team_config:           %s\n' "$team_dir"
+  if [ -d "$team_dir" ]; then printf 'team_config_state:     present\n'; else printf 'team_config_state:     absent\n'; fi
+  printf 'task_list:             %s\n' "$task_dir"
+  if [ -d "$task_dir" ]; then printf 'task_list_state:       present\n'; else printf 'task_list_state:       absent\n'; fi
+  printf 'checkpoint:            %s\n' "${ckpt:-<none>}"
+  printf 'cycle_restart_count:   %s\n' "${restart_count:-0}"
   if [ "$age" -lt 0 ]; then
-    printf 'heartbeat:         <none>\n'
-    printf 'liveness:          unknown (no heartbeat — treat as stale)\n'
+    printf 'heartbeat:             <none>\n'
+    printf 'liveness:              unknown (no heartbeat — treat as stale)\n'
   else
-    printf 'heartbeat:         %s (%ds ago)\n' "$hb" "$age"
+    printf 'heartbeat:             %s (%ds ago)\n' "$hb" "$age"
     if [ "$age" -lt "$HEARTBEAT_TTL_SECONDS" ]; then
-      printf 'liveness:          LIKELY ALIVE (heartbeat < %ds)\n' "$HEARTBEAT_TTL_SECONDS"
+      printf 'liveness:              LIKELY ALIVE (heartbeat < %ds)\n' "$HEARTBEAT_TTL_SECONDS"
     else
-      printf 'liveness:          stale\n'
+      printf 'liveness:              stale\n'
     fi
   fi
-  printf 'tmux_session:      %s\n' "$tmux_name"
-  if command -v tmux >/dev/null 2>&1 && tmux has-session -t "$tmux_name" 2>/dev/null; then
-    printf 'tmux_state:        present\n'
+  if [ -d "$ARTEFACTS_DIR" ]; then
+    local brief_count log_count
+    brief_count="$(find "$ARTEFACTS_DIR/spawn-briefs" -maxdepth 1 -type f -name '*.md' 2>/dev/null | wc -l | tr -d ' ')"
+    log_count="$(find "$ARTEFACTS_DIR" -maxdepth 1 -type f -name 'static-check-*.log' 2>/dev/null | wc -l | tr -d ' ')"
+    printf 'spawn_briefs:          %s file(s)\n' "${brief_count:-0}"
+    printf 'static_check_logs:     %s file(s)\n' "${log_count:-0}"
   else
-    printf 'tmux_state:        absent\n'
+    printf 'artefacts_dir:         absent\n'
+  fi
+}
+
+cmd_members() {
+  local slug="${1:-}"
+  if [ -z "$slug" ]; then
+    echo "usage: team-state.sh members <slug>" >&2
+    return 2
+  fi
+  local team team_dir config
+  team="$(team_name_for_slug "$slug")"
+  team_dir="$TEAMS_DIR/$team"
+  config="$team_dir/config.json"
+  if [ ! -f "$config" ]; then
+    echo "team config not found: $config" >&2
+    return 4
   fi
+  if ! command -v jq >/dev/null 2>&1; then
+    echo "jq not installed; raw config follows:" >&2
+    cat "$config"
+    return 0
+  fi
+  printf 'team:    %s\n' "$team"
+  printf 'config:  %s\n' "$config"
+  printf 'members:\n'
+  jq -r '.members[]? | "  - " + (.role // "<no-role>") + "  (id: " + (.id // "<no-id>") + ", status: " + (.status // "unknown") + ")"' "$config" 2>/dev/null \
+    || jq -r '. | tostring' "$config"
 }
 
 cmd_cleanup() {
@@ -153,21 +201,27 @@ cmd_cleanup() {
     return 2
   fi
 
-  local team team_dir task_dir hb age ckpt tmux_name
+  local team team_dir task_dir hb age ckpt
   team="$(team_name_for_slug "$slug")"
   team_dir="$TEAMS_DIR/$team"
   task_dir="$TASKS_DIR/$team"
   hb="$(heartbeat_file_for_slug "$slug")"
   age="$(heartbeat_age_seconds "$hb")"
   ckpt="$(checkpoint_for_slug "$slug")"
-  tmux_name="$(tmux_name_for_slug "$slug")"
 
   # Build the work list.
   local items=()
   [ -d "$team_dir" ] && items+=("team_config:$team_dir")
   [ -d "$task_dir" ] && items+=("task_list:$task_dir")
-  if command -v tmux >/dev/null 2>&1 && tmux has-session -t "$tmux_name" 2>/dev/null; then
-    items+=("tmux_session:$tmux_name")
+  if [ -d "$ARTEFACTS_DIR/spawn-briefs" ]; then
+    local n
+    n="$(find "$ARTEFACTS_DIR/spawn-briefs" -maxdepth 1 -type f -name '*.md' 2>/dev/null | wc -l | tr -d ' ')"
+    [ "${n:-0}" -gt 0 ] && items+=("spawn_briefs:$ARTEFACTS_DIR/spawn-briefs (${n} files)")
+  fi
+  if [ -d "$ARTEFACTS_DIR" ]; then
+    local n
+    n="$(find "$ARTEFACTS_DIR" -maxdepth 1 -type f -name 'static-check-*.log' 2>/dev/null | wc -l | tr -d ' ')"
+    [ "${n:-0}" -gt 0 ] && items+=("static_check_logs:$ARTEFACTS_DIR/static-check-*.log (${n} files)")
   fi
 
   if [ ${#items[@]} -eq 0 ]; then
@@ -202,10 +256,24 @@ cmd_cleanup() {
     echo "removed: $task_dir"
     removed=$((removed+1))
   fi
-  if command -v tmux >/dev/null 2>&1 && tmux has-session -t "$tmux_name" 2>/dev/null; then
-    tmux kill-session -t "$tmux_name" && echo "killed tmux session: $tmux_name"
+  if [ -d "$ARTEFACTS_DIR/spawn-briefs" ]; then
+    rm -rf -- "$ARTEFACTS_DIR/spawn-briefs"
+    echo "removed: $ARTEFACTS_DIR/spawn-briefs"
     removed=$((removed+1))
   fi
+  if [ -d "$ARTEFACTS_DIR" ]; then
+    local cleared
+    cleared="$(find "$ARTEFACTS_DIR" -maxdepth 1 -type f -name 'static-check-*.log' 2>/dev/null | wc -l | tr -d ' ')"
+    if [ "${cleared:-0}" -gt 0 ]; then
+      find "$ARTEFACTS_DIR" -maxdepth 1 -type f -name 'static-check-*.log' -delete 2>/dev/null || true
+      echo "removed: ${cleared} static-check log(s) under $ARTEFACTS_DIR"
+      removed=$((removed+1))
+    fi
+    # If .team-superpower/ is now empty, drop it too.
+    if [ -z "$(ls -A "$ARTEFACTS_DIR" 2>/dev/null)" ]; then
+      rmdir "$ARTEFACTS_DIR" 2>/dev/null || true
+    fi
+  fi
   # Heartbeat is informational; remove it so future scans don't see a stale "alive" signal.
   if [ -f "$hb" ]; then
     rm -f -- "$hb"
@@ -219,7 +287,7 @@ cmd_cleanup() {
       {
         printf '\n## Cleanup\n'
         printf -- '- cleaned at: %s\n' "$ts"
-        printf -- '- removed: %d resource(s) (team_config, task_list, tmux_session as applicable)\n' "$removed"
+        printf -- '- removed: %d resource(s) (team_config, task_list, spawn_briefs, static_check_logs as applicable)\n' "$removed"
         printf -- '- status: cleaned\n'
       } >> "$ckpt"
       echo "appended cleanup record to: $ckpt"
@@ -235,6 +303,7 @@ main() {
   shift || true
   case "$sub" in
     scan)    cmd_scan "$@" ;;
+    members) cmd_members "$@" ;;
     cleanup) cmd_cleanup "$@" ;;
     -h|--help|help|"") print_usage; [ -z "$sub" ] && return 2 || return 0 ;;
     *) echo "unknown subcommand: $sub" >&2; print_usage; return 2 ;;

package/plugins/tech-graph/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tech-graph",
-  "version": "0.0.19",
+  "version": "0.0.23",
   "description": "Step-by-step wizard for generating technical diagrams as SVG+PNG.",
   "author": {
     "name": "steven"

package/plugins/team-superpower/agents/designer.md

@@ -1,65 +0,0 @@
----
-name: designer
-description: Runs the Superpowers `brainstorming` skill end-to-end to produce an owner-approved design document. Owns phase 1 of the team-superpower workflow. Cannot write code, plans, or any artifact outside `docs/superpowers/specs/`.
-tools: Read, Write, Glob, Grep
-model: opus
-effort: high
----
-
-# Designer — Phase 1 (Brainstorming)
-
-## First-turn directive (v3)
-
-At the start of your first turn, run `/effort high` to set your reasoning effort. In your first heartbeat/checkpoint message back to the lead, include the self-report fields:
-
-```
-effort_set: high
-model_actual: <the model you are running on per /model output>
-```
-
-The lead captures these and verifies them against your pinned `model: opus`. If `model_actual` does not match the pinned alias (e.g. a usage-threshold fallback dropped you to Sonnet), the lead surfaces a single owner touchpoint asking whether to continue.
-
-## Thinking discipline
-
-Default thinking level: **high**. Before any non-trivial step (problem decomposition, acceptance criteria, sub-project boundaries, design alternatives, spec self-review), take extended thinking time before acting. The team relies on your output being correct, not fast. Routine prose tightening and reformatting may be quick; everything load-bearing is high.
-
-You are the **designer** teammate on a team-superpower agent team. The lead spawned you to run **one** Superpowers skill: `brainstorming`. Your output is a committed design document that the owner has signed off on. Nothing more.
-
-## AGENTS.md (read-only, v4 §7)
-
-At start of your first turn, read `docs/superpowers/AGENTS.md` if it exists. Apply documented patterns and pitfalls when shaping the design (e.g. if a pattern requires `ICurrentUserContext` injection, design any new feature around that abstraction). You may NEVER write to `docs/superpowers/AGENTS.md` — only the reviewer suggests, only the owner promotes.
-
-## Hard rules
-
-1. Run the unmodified Superpowers `brainstorming` skill at `~/.claude/plugins/cache/claude-plugins-official/superpowers/5.1.0/skills/brainstorming/SKILL.md`. Follow it verbatim. Do not invent steps, skip the visual-companion offer, or collapse the clarifying-question loop. Read the SKILL.md before you do anything else.
-2. **Never** write code, plans, worktree commands, or anything outside `docs/superpowers/specs/`.
-3. Save the design doc to `docs/superpowers/specs/YYYY-MM-DD-<slug>-design.md` and commit it. The brainstorming skill already prescribes this; do not deviate from its filename pattern. The `<slug>` is given to you by the lead in your spawn prompt.
-4. Before sending a clarifying question to the owner, **post it to the lead via mailbox first**. The lead may answer from project context or escalate. Never DM the owner directly.
-5. Every escalation you do raise MUST use the template in `docs/superpowers/ESCALATION.md`. No exceptions, even for one-line questions.
-6. When the owner signs off on the design, post `DESIGN_APPROVED <path>` to the lead's mailbox where `<path>` is the absolute path of the design doc. Then idle.
-
-## Output
-
-A committed design document at `docs/superpowers/specs/YYYY-MM-DD-<slug>-design.md`, owner-approved per the brainstorming skill's sign-off step. Signals completion by posting `DESIGN_APPROVED <path>` to the lead's mailbox.
-
-## What you must NOT do
-
-- Decide implementation strategy. The plan is the planner's job.
-- Pick a stack, framework, or library beyond what the brainstorming skill explicitly asks you to discuss with the owner.
-- Touch the worktree. There is no worktree yet — it is created in phase 2.
-- Skip the owner sign-off step inside the brainstorming skill. Phase 2 cannot start without an approved design.
-
-## When you idle
-
-- If you have unanswered inbound peer messages (`from != "lead"`, `replied == false`), the `TeammateIdle` hook will block your idle with `BLOCKED_IDLE`. Either reply or escalate per the template before going idle.
-- After `DESIGN_APPROVED` is posted, idle. The lead will not call you again for this feature.
-
-## Clarification routing
-
-Use the 4-class decision table in `assets/ESCALATION.md` to classify every clarification you face. Your per-role buckets:
-
-- **I decide alone (tactical):** doc structure, prose tightness, example phrasing, internal section ordering, choice of mermaid-vs-table format. Log each as one line in the session checkpoint `## Assumptions` block.
-- **I consult planner (cross-role):** whether an acceptance criterion is measurable enough for the plan to size a test; whether a goal can be split into independent design units.
-- **I escalate to owner (owner-only):** scope, success criteria, external policy, anything the design doc does not already pin and that changes what "done" looks like.
-
-Every escalation MUST include the `Peer attempts:` field per `assets/ESCALATION.md`. If you classify as `tactical`, do NOT escalate — log to `## Assumptions` instead.