@arthai/agents 1.0.0

package/dist/plugins/prime/hooks/triage-router.sh

@@ -0,0 +1,740 @@
+#!/bin/bash
+set -euo pipefail
+# UserPromptSubmit hook: Route requests to appropriate agents/skills.
+# v2: Injects full routing table ONCE per session, compact reminders afterward.
+# Saves ~1,400 tokens per message after the first (95% context reduction).
+# stdout is injected as context into the conversation.
+#
+# CONFIG-AWARE: Sources .claude-agents.conf to build routing table dynamically.
+# AUTO-DISCOVERY: Scans for project-specific agents/skills (regular files, not symlinks).
+# FALLBACK: If no config found, emits hardcoded table for backwards compatibility.
+
+# ---------------------------------------------------------------------------
+# Resolve project directory
+# ---------------------------------------------------------------------------
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+CONF_FILE="$PROJECT_DIR/.claude/.claude-agents.conf"
+MARKER_FILE="$PROJECT_DIR/.claude/.triage-full-emitted"
+
+# ---------------------------------------------------------------------------
+# Conversational filter — skip routing for short follow-up messages
+# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
+# Step 1: Autopilot intercept — runs FIRST, before any filtering
+# ---------------------------------------------------------------------------
+USER_MSG="${CLAUDE_USER_PROMPT:-}"
+WORKFLOW_STATE="$PROJECT_DIR/.claude/.workflow-state.json"
+if [ -f "$WORKFLOW_STATE" ]; then
+    _ap_mode=$(python3 -c "import json; print(json.load(open('$WORKFLOW_STATE')).get('mode',''))" 2>/dev/null || echo "")
+    if [ "$_ap_mode" = "autopilot" ]; then
+        # Auto-pause stale workflows (older than 24 hours)
+        _ap_age=$(python3 -c "
+import json, datetime
+s = json.load(open('$WORKFLOW_STATE'))
+started = s.get('started_at','')
+if started:
+    dt = datetime.datetime.fromisoformat(started.replace('Z','+00:00'))
+    age_hours = (datetime.datetime.now(datetime.timezone.utc) - dt).total_seconds() / 3600
+    print(int(age_hours))
+else:
+    print(0)
+" 2>/dev/null || echo "0")
+        if [ "${_ap_age:-0}" -gt 24 ]; then
+            # Stale — auto-pause and fall through to normal routing
+            python3 << PYEOF
+import json
+path = "$WORKFLOW_STATE"
+with open(path) as f: s = json.load(f)
+s["mode"] = "paused"
+with open(path, "w") as f: json.dump(s, f, indent=2)
+PYEOF
+            echo "Autopilot auto-paused (stale — started ${_ap_age}h ago). Resume with /autopilot."
+            # Fall through to normal routing below
+        else
+            # Active and fresh — route to autopilot
+            _ap_phase=$(python3 -c "import json; print(json.load(open('$WORKFLOW_STATE')).get('phase','assess'))" 2>/dev/null || echo "assess")
+            _ap_item=$(python3 -c "import json; i=json.load(open('$WORKFLOW_STATE')).get('current_item'); print(f'#{i[\"number\"]} {i[\"title\"]}' if i else 'none')" 2>/dev/null || echo "none")
+            cat <<AUTOPILOT
+AUTOPILOT ACTIVE — phase: $_ap_phase | item: $_ap_item
+
+Continue the /autopilot workflow. Read .claude/.workflow-state.json for full context.
+
+If the user says "stop", "pause", or "exit autopilot": set mode to "paused" in workflow state and stop.
+If the user gives a specific unrelated instruction: pause autopilot and handle their request normally.
+Otherwise: continue from current phase.
+AUTOPILOT
+            exit 0
+        fi
+    fi
+fi
+
+# ---------------------------------------------------------------------------
+# Step 2: Conversational filter — skip routing for short follow-ups
+# ---------------------------------------------------------------------------
+# When the user says "ok", "why?", "what are you doing", etc., injecting the
+# full routing table disrupts in-progress work and can cause the model to stall.
+if [ -n "$USER_MSG" ]; then
+    WORD_COUNT=$(echo "$USER_MSG" | wc -w | tr -d ' ')
+    if [ "$WORD_COUNT" -lt 8 ]; then
+        # Greetings → /onboard
+        if echo "$USER_MSG" | grep -qiE '^(hey|hi|hello|yo|sup|help|what should|what can|what.s up|good morning|howdy|what.s new|status|brief)'; then
+            echo "MANDATORY: Use the Skill tool to invoke the \"onboard\" skill NOW. Do not respond with a greeting. Do not say hi back. Invoke the skill immediately with no other output."
+            exit 0
+        # Explicit /pr command → precheck gate (before keyword fallthrough)
+        elif echo "$USER_MSG" | grep -qiE '^\s*/pr(\s|$)'; then
+            if [ -f "$PROJECT_DIR/tests/run.sh" ]; then
+                _precheck_ok=false
+                if [ -f "$PROJECT_DIR/.claude/.precheck-passed" ]; then
+                    _pc_ts=$(awk '{print $1}' "$PROJECT_DIR/.claude/.precheck-passed" 2>/dev/null || echo "0")
+                    _pc_commit=$(awk '{print $2}' "$PROJECT_DIR/.claude/.precheck-passed" 2>/dev/null || echo "")
+                    _current_commit=$(cd "$PROJECT_DIR" && git rev-parse --short HEAD 2>/dev/null || echo "")
+                    _pc_age=$(( $(date +%s) - ${_pc_ts:-0} ))
+                    if [ "$_pc_commit" = "$_current_commit" ] && [ "$_pc_age" -lt 1800 ]; then
+                        _precheck_ok=true
+                    fi
+                fi
+                if ! $_precheck_ok; then
+                    echo "⛔ PRECHECK REQUIRED. Run /precheck before /pr on toolkit projects."
+                    echo "Use the Skill tool to invoke the \"precheck\" skill NOW. Do NOT invoke /pr until precheck passes."
+                    exit 0
+                fi
+            fi
+            : # Fall through — let harness handle /pr normally
+        # ANY keyword that matches a workflow → fall through to pattern matching
+        elif echo "$USER_MSG" | grep -qiE 'down|outage|crash|500|broke|fail|error|slow|timeout|incident|prod|deploy|fix|bug|build|add|create|implement|plan|test|lint|review|pr|merge|push|commit|restart|start|stop|check|health|debug|ship|release|refactor|migrate|search|find|where|show|login|auth|can.t|cannot|unable|exhaust|regress|wrong|broken|validate|verify|calibrate|autopilot|explain|how does'; then
+            : # Fall through — pattern matching in compact section will handle it
+        # Explicit slash commands always get routed
+        elif echo "$USER_MSG" | grep -qiE '^\s*/'; then
+            : # Fall through to routing
+        else
+            exit 0  # Conversational follow-up — no routing needed
+        fi
+    fi
+fi
+
+# ---------------------------------------------------------------------------
+# Non-engineer role detection — route vague messages to /welcome
+# ---------------------------------------------------------------------------
+USER_ROLE=""
+if [ -f "$CONF_FILE" ]; then
+    USER_ROLE=$(grep '^USER_ROLE=' "$CONF_FILE" 2>/dev/null | head -1 | sed 's/^USER_ROLE="//' | sed 's/"$//' || true)
+fi
+
+# Non-engineer roles get /welcome for vague/greeting messages
+if [ -n "$USER_ROLE" ] && [ "$USER_ROLE" != "engineer" ] && [ "$USER_ROLE" != "dev" ] && [ "$USER_ROLE" != "developer" ]; then
+    if [ -n "$USER_MSG" ]; then
+        WORD_COUNT_CHECK=$(echo "$USER_MSG" | wc -w | tr -d ' ')
+        # Vague/greeting messages from non-engineers → /welcome
+        if [ "$WORD_COUNT_CHECK" -lt 8 ]; then
+            if echo "$USER_MSG" | grep -qiE '^(hey|hi|hello|yo|sup|help|what|how|who)' && \
+               ! echo "$USER_MSG" | grep -qiE '^\s*/'; then
+                echo "NON-ENGINEER WELCOME — Role: $USER_ROLE"
+                echo "Route to /welcome skill. This user is a $(echo "$USER_ROLE" | tr '-' ' '). Show the role-appropriate menu."
+                echo "Do NOT show the full routing table. Do NOT mention agents, skills, hooks, or model tiers."
+                date +%s > "$MARKER_FILE" 2>/dev/null || true
+                exit 0
+            fi
+        fi
+    fi
+fi
+
+# ---------------------------------------------------------------------------
+# Determine: full table or compact reminder?
+# ---------------------------------------------------------------------------
+needs_full=false
+
+# No marker → first message this session → need full table
+if [ ! -f "$MARKER_FILE" ]; then
+    needs_full=true
+else
+    # Check marker freshness (re-inject if stale >2 hours)
+    if [ "$(uname)" = "Darwin" ]; then
+        marker_age=$(( $(date +%s) - $(stat -f%m "$MARKER_FILE") ))
+    else
+        marker_age=$(( $(date +%s) - $(stat -c%Y "$MARKER_FILE") ))
+    fi
+    if [ "$marker_age" -gt 7200 ]; then
+        needs_full=true
+    fi
+fi
+
+# Force full table if user is asking about available tools/skills/agents
+if [ -n "$USER_MSG" ]; then
+    if echo "$USER_MSG" | grep -qiE '(what|which|list|show|available).*(skill|agent|tool|command|can I|can you)'; then
+        needs_full=true
+    fi
+fi
+
+# ---------------------------------------------------------------------------
+# COMPACT ROUTING — pattern-matched direct routing for ALL workflows
+# Checks patterns in priority order. First match wins.
+# ---------------------------------------------------------------------------
+if ! $needs_full; then
+    if [ -n "$USER_MSG" ]; then
+
+        # ===================================================================
+        # PRIORITY 1: INCIDENTS (urgent — act immediately)
+        # ===================================================================
+
+        # Critical production incidents → /incident
+        if echo "$USER_MSG" | grep -qiE 'down|outage|crash|data.?loss|security.?breach|breach|corrupt|site.*(not|is).*(work|respond)|can.?t.*(access|reach|connect|login|log.?in|sign.?in)|service.*(unavail|unreach)|users?.*(can.?t|cannot|unable)'; then
+            echo "CRITICAL INCIDENT. Use the Skill tool to invoke the \"incident\" skill NOW with the user's description. Do not ask questions."
+            exit 0
+        fi
+
+        # Production/staging errors → /incident
+        if echo "$USER_MSG" | grep -qiE '(prod|production|staging|live).*(error|issue|problem|broken|slow|timeout|degrad)|50[0-4].?(error|in prod|in staging)|gateway.?timeout|bad.?gateway|service.?unavail'; then
+            echo "PRODUCTION ISSUE. Use the Skill tool to invoke the \"incident\" skill with the user's description."
+            exit 0
+        fi
+
+        # Performance issues → /incident
+        if echo "$USER_MSG" | grep -qiE '(extremely|very|super).?slow|latency.*(spike|increas|high)|memory.?(leak|spike|full)|cpu.*(spike|100|high)|disk.?(full|space)|connection.?(pool|exhaust|limit)|exhaust|out.?of.?(memory|connections|space)'; then
+            echo "PERFORMANCE INCIDENT. Use the Skill tool to invoke the \"incident\" skill with the user's description."
+            exit 0
+        fi
+
+        # ===================================================================
+        # PRIORITY 2: CI/CD (broken pipeline — needs fast fix)
+        # ===================================================================
+
+        # CI failures → /ci-fix
+        if echo "$USER_MSG" | grep -qiE 'ci.*(fail|broke|red|down)|pipeline.*(fail|broke|error)|build.*(fail|broke|error)|actions.*(fail|red)|workflow.*(fail|error)|tests?.*(fail|broke).*(ci|pipeline|actions)|lint.*(fail|error).*(ci|pipeline)|type.*(error|fail).*(ci|pipeline)|checks?.*(fail|red)|fail.*(in|on).*(ci|pipeline|actions|workflow)'; then
+            echo "CI FAILURE. Use the Skill tool to invoke the \"ci-fix\" skill. It handles 3-attempt diagnosis and fix."
+            exit 0
+        fi
+
+        # ===================================================================
+        # PRIORITY 3: BUG FIXES (broken code — needs formal pipeline)
+        # ===================================================================
+
+        # Bug fix with issue reference → /fix #N
+        if echo "$USER_MSG" | grep -qiE 'fix.*(issue|bug|ticket|#[0-9])|#[0-9]+.*(fix|bug|broken|regression)|resolve.*(issue|bug|#[0-9])|close.*(issue|bug|#[0-9])'; then
+            echo "BUG FIX. Use the Skill tool to invoke the \"fix\" skill with the user's description. Formal pipeline: root cause → scope lock → behavior contract → test."
+            exit 0
+        fi
+
+        # Bug fix without issue reference → /fix
+        if echo "$USER_MSG" | grep -qiE 'fix.*(bug|crash|error|regression|issue|broken)|debug.*(this|the|a|why)|why.*(crash|fail|error|broken|wrong)|broken.*(feature|endpoint|page|button|form|api|login|auth)|regression.*(in|on|with|from)|not.?working.*(correct|proper|right|anymore)|stopped.?working|wrong.*(output|result|behavior|response)|(page|endpoint|feature|api|login|form|button).*(is|are).*(broken|wrong|not working)|there.?s.?a.?(bug|regression|issue|problem)'; then
+            echo "BUG FIX. Use the Skill tool to invoke the \"fix\" skill with the user's description."
+            exit 0
+        fi
+
+        # ===================================================================
+        # PRIORITY 4: PR CREATION (ship code — before feature check so "create a PR" doesn't match feature)
+        # ===================================================================
+
+        # Create PR → /pr (with precheck gate for toolkit projects)
+        if echo "$USER_MSG" | grep -qiE 'create.*(a |the )?pr|make.*(a |the )?pr|open.*(a |the )?pr|submit.*(a |the )?pr|push.*(and|&).*(pr|pull)|ship.*(this|it|the code|changes)|ready.?to.?(ship|merge|pr)|let.?s.?(ship|pr|merge|push)|merge.*(this|it|the|my)'; then
+            # Precheck gate: if this is a toolkit project, require /precheck first
+            if [ -f "$PROJECT_DIR/tests/run.sh" ]; then
+                _precheck_ok=false
+                if [ -f "$PROJECT_DIR/.claude/.precheck-passed" ]; then
+                    _pc_ts=$(awk '{print $1}' "$PROJECT_DIR/.claude/.precheck-passed" 2>/dev/null || echo "0")
+                    _pc_commit=$(awk '{print $2}' "$PROJECT_DIR/.claude/.precheck-passed" 2>/dev/null || echo "")
+                    _current_commit=$(cd "$PROJECT_DIR" && git rev-parse --short HEAD 2>/dev/null || echo "")
+                    _pc_age=$(( $(date +%s) - ${_pc_ts:-0} ))
+                    # Valid if: same commit AND less than 30 minutes old
+                    if [ "$_pc_commit" = "$_current_commit" ] && [ "$_pc_age" -lt 1800 ]; then
+                        _precheck_ok=true
+                    fi
+                fi
+                if ! $_precheck_ok; then
+                    echo "⛔ PRECHECK REQUIRED. This is a toolkit project — run /precheck before creating a PR."
+                    echo "Use the Skill tool to invoke the \"precheck\" skill NOW. Do NOT invoke /pr until precheck passes."
+                    exit 0
+                fi
+            fi
+            echo "CREATE PR. Use the Skill tool to invoke the \"pr\" skill. It runs QA first, then creates the PR."
+            exit 0
+        fi
+
+        # ===================================================================
+        # PRIORITY 5: FEATURE DEVELOPMENT (new work — needs planning)
+        # ===================================================================
+
+        # New feature → /planning (exclude PR-related phrases)
+        if echo "$USER_MSG" | grep -qiE 'build.*(a|the|new|me)|create.*(a|the|new|me).*(feature|endpoint|page|component|system|service|module|api|app)|add.*(a|the|new|feature|support|ability|endpoint|page|component|functionality)|implement.*(a|the|new)|develop.*(a|the|new)|make.*(a|the|new)|design.*(a|the|new|system)|plan.*(a|the|new|feature|how)|new.?feature|feature.?request|i.?want.*(to add|to build|to create|a new)|let.?s.*(build|create|add|make|design)|we.?need.*(a|to add|to build|to create)'; then
+            echo "FEATURE DEVELOPMENT. Use the Skill tool to invoke the \"planning\" skill with the feature name extracted from the user's description. This spawns PM + architect to create an implementation plan."
+            exit 0
+        fi
+
+        # Implement from existing plan → /implement
+        if echo "$USER_MSG" | grep -qiE 'implement.*(plan|the plan|from plan)|build.*(from plan|the plan)|start.*(implement|building|coding)|execute.*(the plan|plan)|let.?s.?(code|implement|build).?it|ready.?to.?(build|implement|code)|go.?ahead.?(and)?.?(build|implement|code)'; then
+            echo "IMPLEMENTATION. Use the Skill tool to invoke the \"implement\" skill. It reads the plan from .claude/plans/ and spawns dev agents."
+            exit 0
+        fi
+
+        # ===================================================================
+        # PRIORITY 5: QA & REVIEW (validation — before shipping)
+        # ===================================================================
+
+        # Run tests/QA → /qa
+        if echo "$USER_MSG" | grep -qiE 'run.*(test|qa|check|validat|lint|type.?check)|test.*(this|it|everything|all|the)|check.*(quality|code|if.*work|if.*pass)|validate|verify.*(this|the|code|changes|it)|does.*(this|it).*(work|pass)|make.?sure.*(it|this|everything).*(work|pass)|qa.*(this|check|run|full)|are.*(tests|checks).*(pass|green)'; then
+            echo "QA. Use the Skill tool to invoke the \"qa\" skill. Modes: /qa (commit), /qa full (comprehensive), /qa staging, /qa prod."
+            exit 0
+        fi
+
+        # Review PR → /review-pr
+        if echo "$USER_MSG" | grep -qiE 'review.*(pr|pull|code|this|the|my|changes|diff)|code.?review|check.*(my|the|this).*(pr|code|changes|diff)|look.?(at|over).*(my|the|this).*(pr|code|changes)|pr.*(review|feedback)|give.*(feedback|review)'; then
+            echo "CODE REVIEW. Use the Skill tool to invoke the \"review-pr\" skill. Auto-detects bug fix vs feature PR."
+            exit 0
+        fi
+
+        # ===================================================================
+        # PRIORITY 7: OPS & SRE (infrastructure, deployment, health)
+        # ===================================================================
+
+        # SRE operations → /sre
+        if echo "$USER_MSG" | grep -qiE 'deploy.*(to|status|check|log)|check.*(deploy|health|status|infra|prod|staging)|health.?(check|status|endpoint)|infra.?(status|health|check)|service.?(status|health)|what.?s.*(the status|running|deployed)|is.*(prod|staging|deploy).*(ok|healthy|up|running)|show.*(logs|status|health|deploy)|monitor|uptime'; then
+            echo "SRE. Use the Skill tool to invoke the \"sre\" skill. Commands: /sre status, /sre health, /sre logs, /sre deploy-check, /sre debug."
+            exit 0
+        fi
+
+        # Restart → /restart
+        if echo "$USER_MSG" | grep -qiE 'restart.*(server|service|app|dev|local|frontend|backend)|stop.*(server|service|app)|start.*(server|service|app|dev)|kill.*(server|port|process)|server.*(not|isn.t).*(starting|running|responding)'; then
+            echo "RESTART. Use the Skill tool to invoke the \"restart\" skill to restart local dev servers."
+            exit 0
+        fi
+
+        # ===================================================================
+        # PRIORITY 7: SEARCH & EXPLORE (codebase questions)
+        # ===================================================================
+
+        # Codebase search → explore-light agent (Haiku, cheap)
+        if echo "$USER_MSG" | grep -qiE 'find.*(file|function|class|where|code|import|usage|reference|middleware|handler|route|endpoint|component)|search.*(for|the|codebase)|where.*(is|are|does|do)|show.*(me|the).*(file|code|function|class|import|route|endpoint|api|component)|how.*(does|is|do).*(this|the|it|the.*flow|payment|auth|login).*(work|implement|structured|flow)|what.*(file|function|class|module|service).*(is|has|contains|does)|look.?(up|for)|locate|grep.?for|explain.*(the|this|how)'; then
+            echo "CODEBASE SEARCH. Spawn an explore-light agent (Haiku, 1x cost) to search the codebase. Do NOT search yourself — delegate to explore-light."
+            exit 0
+        fi
+
+        # ===================================================================
+        # PRIORITY 8: GIT OPS (cheap operations)
+        # ===================================================================
+
+        # Git operations → ops agent (Haiku, cheap)
+        if echo "$USER_MSG" | grep -qiE 'git.*(status|log|diff|branch|stash|pull|fetch|checkout|rebase|cherry)|commit.*(this|the|changes|code)|push.*(this|the|code|branch)|branch.*(create|switch|delete|list|name)|what.*(branch|commit|changed)|show.*(diff|changes|log|history)|stash|merge.*(branch|conflict|this)'; then
+            echo "GIT OPS. Spawn an ops agent (Haiku, 1x cost) to handle git operations. Do NOT do git ops yourself — delegate to ops."
+            exit 0
+        fi
+
+        # Run commands → ops agent
+        if echo "$USER_MSG" | grep -qiE 'run.*(lint|build|format|clean|install|migrate|seed)|lint.*(this|the|code|all)|build.*(this|the|app|project)|format.*(this|the|code)|clean.*(cache|build|node_modules)|install.*(deps|dependencies|packages)|migrate.*(database|db|schema)|seed.*(database|db|data)'; then
+            echo "OPS. Spawn an ops agent (Haiku, 1x cost) to run the command."
+            exit 0
+        fi
+
+        # ===================================================================
+        # PRIORITY 9: CODE CHANGES (targeted edits)
+        # ===================================================================
+
+        # Frontend code changes → frontend agent
+        if echo "$USER_MSG" | grep -qiE '(change|update|edit|modify|style|tweak|adjust).*(component|page|button|form|modal|ui|css|style|layout|header|footer|nav|sidebar|theme|color|font|icon|image)|frontend.*(change|update|fix)|ui.*(change|update|fix|tweak)|css.*(change|fix|update)|style.*(change|fix|update)|responsive|mobile.?(view|layout|design)'; then
+            echo "FRONTEND. Spawn a frontend agent (Sonnet, 10x) for UI/frontend code changes."
+            exit 0
+        fi
+
+        # Backend code changes → backend agent
+        if echo "$USER_MSG" | grep -qiE '(change|update|edit|modify|add).*(endpoint|route|api|model|schema|service|controller|middleware|migration|query|database)|backend.*(change|update|fix)|api.*(change|update|fix|add)|database.*(change|update|query|add)|model.*(change|update|add|field)|endpoint.*(change|update|add|remove)|migration.*(create|add|run)'; then
+            echo "BACKEND. Spawn a backend agent (Sonnet, 10x) for backend/API code changes."
+            exit 0
+        fi
+
+        # ===================================================================
+        # PRIORITY 10: AUTONOMOUS & CALIBRATE
+        # ===================================================================
+
+        # Autopilot → /autopilot
+        if echo "$USER_MSG" | grep -qiE 'autopilot|auto.?pilot|work.*(on|through).*(issues|tickets|backlog)|pick.?up.*(issues|work|tickets)|be.*(a|my).*(junior|engineer|dev)|handle.*(the|my).*(backlog|issues|tickets)|autonomous|auto.?mode'; then
+            echo "AUTOPILOT. Use the Skill tool to invoke the \"autopilot\" skill. It picks up issues, implements, QAs, and creates PRs autonomously."
+            exit 0
+        fi
+
+        # Calibrate → /calibrate
+        if echo "$USER_MSG" | grep -qiE 'calibrate|setup.*(toolkit|agents|mcp)|configure.*(toolkit|agents|mcp)|learn.*(my|the|this).*(project|codebase)|scan.*(codebase|project)|what.*(tools|mcp|agents).*(need|should|install|recommend)'; then
+            echo "CALIBRATE. Use the Skill tool to invoke the \"calibrate\" skill. It deep-learns the project and configures MCP servers, agents, skills, and workflows."
+            exit 0
+        fi
+
+        # ===================================================================
+        # PRIORITY 11: ARCHITECTURE (expensive — Opus, last resort)
+        # ===================================================================
+
+        # Architecture decisions → architect agent (Opus)
+        if echo "$USER_MSG" | grep -qiE 'architect.*(this|the|a|system|service)|system.?design|how.?should.*(we|i).*(structure|design|architect|organize)|what.*(approach|pattern|architecture)|trade.?off|scale.*(this|the|system|service)|microservice|monolith|event.?driven|should.*(we|i).*(use|pick|choose).*(pattern|framework|approach)'; then
+            echo "ARCHITECTURE. Spawn an architect agent (Opus, 60x — expensive). Only use for genuine architecture decisions, not for implementation."
+            exit 0
+        fi
+
+    fi
+    # No pattern matched → generic compact reminder
+    cat <<'COMPACT'
+TRIAGE — Use SPEED scoring. 2+ → toolkit agent/skill. 0-1 → built-in tools.
+If mid-task, finish the work — don't re-route.
+COMPACT
+    exit 0
+fi
+
+# ===========================================================================
+# FULL TABLE — first message of session (or refresh triggered)
+# ===========================================================================
+
+# ---------------------------------------------------------------------------
+# Known agent/skill metadata (pattern, display name, cost)
+# Bash 3 doesn't have associative arrays — use parallel indexed arrays.
+# ---------------------------------------------------------------------------
+KNOWN_NAMES=()
+KNOWN_PATTERNS=()
+KNOWN_DISPLAYS=()
+KNOWN_COSTS=()
+
+_register() {
+    KNOWN_NAMES+=("$1")
+    KNOWN_PATTERNS+=("$2")
+    KNOWN_DISPLAYS+=("$3")
+    KNOWN_COSTS+=("$4")
+}
+
+# Core agents
+_register "explore-light"          "find/search/where/what files"       "explore-light (Haiku)"    "1x"
+
+# Strategy & Design agents
+_register "architect"              "architecture/system design"         "architect agent"           "10x"
+_register "code-reviewer"          "code review"                       "code-reviewer agent"       "10x"
+_register "design-studio-create"   "UI/UX design implementation"       "design-studio:create"      "10x"
+_register "design-studio-critique" "design review/critique"            "design-studio:critique"     "10x"
+_register "design-studio-think"    "design exploration/thinking"       "design-studio:think"        "10x"
+_register "gtm-expert"            "go-to-market/launch strategy"      "gtm-expert agent"          "10x"
+_register "product-manager"        "product specs/PRD/roadmap"         "product-manager agent"     "10x"
+
+# Development agents
+_register "frontend"               "frontend/UI code change"           "frontend agent (Sonnet)"   "10x"
+_register "python-backend"         "backend/API code change"           "backend agent (Sonnet)" "10x"
+_register "ops"                    "run tests/lint/restart/git ops"    "ops agent (Haiku)"         "1x"
+
+# Quality agents
+_register "qa"                     "QA/test validation"                "qa orchestrator"           "10x"
+_register "qa-e2e"                 "E2E browser tests"                 "qa-e2e agent"              "10x"
+_register "qa-challenger"          "adversarial QA/red-team"           "qa-challenger agent"       "10x"
+_register "qa-test-promoter"       "promote tests to baseline"         "qa-test-promoter agent"    "10x"
+_register "qa-baseline-updater"    "update test baselines"             "qa-baseline-updater"       "10x"
+_register "qa-domain"              "domain logic validation"           "qa-domain agent"           "10x"
+
+# Operations agents
+_register "sre"                    "SRE/infra/deploy/debug"            "sre agent (Sonnet)"        "10x"
+
+# Skills
+_register "sync"                   "sync claude-agents tooling"        "/sync skill"               "1x"
+_register "calibrate"              "calibrate/adapt toolkit to project" "/calibrate skill"          "10x"
+_register "scan"                   "scan codebase → update CLAUDE.md"  "/scan skill"               "1x"
+_register "explore"                "deep codebase exploration"         "/explore skill"            "1x"
+_register "discord-ops"            "Discord ChatOps"                   "/discord-ops skill"        "1x"
+_register "fix"                    "bug fix with formal pipeline"      "/fix skill"                "team"
+_register "incident"               "incident triage (anything broken)" "/incident skill"           "team"
+_register "implement"              "implementation from plan"          "/implement skill"          "team"
+_register "issue"                  "GitHub issue management"           "/issue skill"              "1x"
+_register "planning"               "feature planning"                  "/planning skill"           "team"
+_register "pr"                     "create PR with QA"                 "/pr skill"                 "1x-10x"
+_register "review-pr"              "PR review (bug/feature)"           "/review-pr skill"          "10x"
+_register "superpowers"            "advanced operations"               "/superpowers skill"        "varies"
+_register "skill-qa"               "QA test suite"                     "/qa skill"                 "10x"
+_register "ci-fix"                 "fix CI/deploy failures"            "/ci-fix skill"             "10x"
+_register "qa-incident"            "log QA incident"                   "/qa-incident skill"        "1x"
+_register "qa-learn"               "QA knowledge review"              "/qa-learn skill"           "1x"
+_register "skill-sre"              "SRE operations"                    "/sre skill"                "10x"
+_register "restart"                "restart local servers"             "/restart skill"            "1x"
+_register "onboard"                "getting started/what to do"        "/onboard skill"            "1x"
+_register "continue"               "continue/resume/what was I doing"  "/continue skill"           "1x"
+_register "autopilot"              "autonomous work loop"              "/autopilot skill"          "team"
+_register "welcome"                "role-based welcome/menu"           "/welcome skill"            "1x"
+_register "share"                  "share/export plan or strategy"     "/share skill"              "1x"
+
+# ---------------------------------------------------------------------------
+# Lookup helpers
+# ---------------------------------------------------------------------------
+_lookup_index() {
+    local name="$1"
+    local i
+    for i in "${!KNOWN_NAMES[@]}"; do
+        if [ "${KNOWN_NAMES[$i]}" = "$name" ]; then
+            echo "$i"
+            return 0
+        fi
+    done
+    return 1
+}
+
+# ---------------------------------------------------------------------------
+# Emit a single markdown table row
+# ---------------------------------------------------------------------------
+_row() {
+    printf '| %s | %s | %s |\n' "$1" "$2" "$3"
+}
+
+# ---------------------------------------------------------------------------
+# Build the routing table
+# ---------------------------------------------------------------------------
+build_table() {
+    local has_config=false
+    local rows=()
+
+    # ------------------------------------------------------------------
+    # 1. Source config if it exists
+    # ------------------------------------------------------------------
+    if [ -f "$CONF_FILE" ]; then
+        has_config=true
+        # shellcheck disable=SC1090
+        . "$CONF_FILE"
+    fi
+
+    if $has_config; then
+        # --------------------------------------------------------------
+        # 2a. Emit rows for INSTALLED_AGENTS from config
+        # --------------------------------------------------------------
+        if [ -n "${INSTALLED_AGENTS:-}" ]; then
+            for agent in $INSTALLED_AGENTS; do
+                local idx
+                if idx=$(_lookup_index "$agent"); then
+                    rows+=("$(_row "${KNOWN_PATTERNS[$idx]}" "${KNOWN_DISPLAYS[$idx]}" "${KNOWN_COSTS[$idx]}")")
+                else
+                    # Agent in config but not in known metadata — generic row
+                    rows+=("$(_row "$agent tasks" "$agent agent" "10x")")
+                fi
+            done
+        fi
+
+        # --------------------------------------------------------------
+        # 2b. Emit rows for INSTALLED_SKILLS from config
+        # --------------------------------------------------------------
+        if [ -n "${INSTALLED_SKILLS:-}" ]; then
+            for skill in $INSTALLED_SKILLS; do
+                local idx
+                # Try skill-prefixed key first (disambiguates qa/sre which exist as both agent+skill)
+                if idx=$(_lookup_index "skill-$skill"); then
+                    rows+=("$(_row "${KNOWN_PATTERNS[$idx]}" "${KNOWN_DISPLAYS[$idx]}" "${KNOWN_COSTS[$idx]}")")
+                elif idx=$(_lookup_index "$skill"); then
+                    rows+=("$(_row "${KNOWN_PATTERNS[$idx]}" "${KNOWN_DISPLAYS[$idx]}" "${KNOWN_COSTS[$idx]}")")
+                else
+                    # Skill in config but not in known metadata — generic row
+                    rows+=("$(_row "$skill tasks" "/$skill skill" "1x")")
+                fi
+            done
+        fi
+
+        # --------------------------------------------------------------
+        # 3. Auto-discover project-specific agents (regular files, NOT symlinks)
+        # --------------------------------------------------------------
+        if [ -d "$PROJECT_DIR/.claude/agents" ]; then
+            for agent_file in "$PROJECT_DIR/.claude/agents/"*.md; do
+                [ ! -f "$agent_file" ] && continue
+                [ -L "$agent_file" ] && continue  # Skip symlinks (managed by portable install)
+                local name
+                name="$(basename "$agent_file" .md)"
+
+                # Skip if already emitted from config
+                local already=false
+                if [ -n "${INSTALLED_AGENTS:-}" ]; then
+                    for a in $INSTALLED_AGENTS; do
+                        if [ "$a" = "$name" ]; then
+                            already=true
+                            break
+                        fi
+                    done
+                fi
+                $already && continue
+
+                # Check known metadata
+                local idx
+                if idx=$(_lookup_index "$name"); then
+                    rows+=("$(_row "${KNOWN_PATTERNS[$idx]}" "${KNOWN_DISPLAYS[$idx]}" "${KNOWN_COSTS[$idx]}")")
+                else
+                    rows+=("$(_row "$name tasks" "$name agent" "10x")")
+                fi
+            done
+        fi
+
+        # --------------------------------------------------------------
+        # 4. Auto-discover project-specific skills (regular dirs, NOT symlinks)
+        # --------------------------------------------------------------
+        if [ -d "$PROJECT_DIR/.claude/skills" ]; then
+            for skill_entry in "$PROJECT_DIR/.claude/skills/"*; do
+                # Handle both dirs and .md files (some skills are single files)
+                [ ! -e "$skill_entry" ] && continue
+                [ -L "$skill_entry" ] && continue  # Skip symlinks
+
+                local name
+                name="$(basename "$skill_entry")"
+                # Strip .md extension if present
+                name="${name%.md}"
+
+                # Skip if already emitted from config
+                local already=false
+                if [ -n "${INSTALLED_SKILLS:-}" ]; then
+                    for s in $INSTALLED_SKILLS; do
+                        if [ "$s" = "$name" ]; then
+                            already=true
+                            break
+                        fi
+                    done
+                fi
+                $already && continue
+
+                # Check known metadata
+                local idx
+                if idx=$(_lookup_index "$name"); then
+                    rows+=("$(_row "${KNOWN_PATTERNS[$idx]}" "${KNOWN_DISPLAYS[$idx]}" "${KNOWN_COSTS[$idx]}")")
+                else
+                    rows+=("$(_row "$name tasks" "/$name skill" "1x")")
+                fi
+            done
+        fi
+    else
+        # ------------------------------------------------------------------
+        # FALLBACK: No config found — emit full hardcoded table
+        # ------------------------------------------------------------------
+        for i in "${!KNOWN_NAMES[@]}"; do
+            rows+=("$(_row "${KNOWN_PATTERNS[$i]}" "${KNOWN_DISPLAYS[$i]}" "${KNOWN_COSTS[$i]}")")
+        done
+
+        # Auto-discover project-specific agents (regular files, NOT symlinks)
+        if [ -d "$PROJECT_DIR/.claude/agents" ]; then
+            for agent_file in "$PROJECT_DIR/.claude/agents/"*.md; do
+                [ ! -f "$agent_file" ] && continue
+                [ -L "$agent_file" ] && continue
+                local name
+                name="$(basename "$agent_file" .md)"
+                # Skip if already in KNOWN_NAMES
+                local already=false
+                for kn in "${KNOWN_NAMES[@]}"; do
+                    if [ "$kn" = "$name" ]; then
+                        already=true
+                        break
+                    fi
+                done
+                $already && continue
+                rows+=("$(_row "$name tasks" "$name agent" "10x")")
+            done
+        fi
+
+        # Auto-discover project-specific skills (regular files/dirs, NOT symlinks)
+        if [ -d "$PROJECT_DIR/.claude/skills" ]; then
+            for skill_entry in "$PROJECT_DIR/.claude/skills/"*; do
+                [ ! -e "$skill_entry" ] && continue
+                [ -L "$skill_entry" ] && continue
+                local name
+                name="$(basename "$skill_entry")"
+                name="${name%.md}"
+                # Skip if already in KNOWN_NAMES
+                local already=false
+                for kn in "${KNOWN_NAMES[@]}"; do
+                    if [ "$kn" = "$name" ]; then
+                        already=true
+                        break
+                    fi
+                done
+                $already && continue
+                rows+=("$(_row "$name tasks" "/$name skill" "1x")")
+            done
+        fi
+    fi
+
+    # ------------------------------------------------------------------
+    # Output
+    # ------------------------------------------------------------------
+    echo "TRIAGE — BEFORE ANY ACTION, ROUTE THIS REQUEST:"
+    echo ""
+    echo "| Pattern | Route to | Cost |"
+    echo "|---------|----------|------|"
+
+    # Emit collected rows
+    for row in "${rows[@]}"; do
+        echo "$row"
+    done
+
+    # Static rows — only emit if the EXACT pattern column isn't already in dynamic rows.
+    # This prevents true duplicates while keeping different patterns for the same tool.
+    local all_rows
+    all_rows=$(printf '%s\n' "${rows[@]}" 2>/dev/null || true)
+
+    # Helper: emit static row only if its PATTERN (first column) isn't in dynamic rows
+    _static_row() {
+        local pattern="$1" row="$2"
+        if ! echo "$all_rows" | grep -qF "$pattern" 2>/dev/null; then
+            echo "$row"
+        fi
+    }
+
+    _static_row "git status/pull"              "| git status/pull/branch/checkout | ops agent (Haiku) | 1x |"
+    _static_row "restart/start/stop"           "| restart/start/stop servers | /restart skill | 1x |"
+    _static_row "run tests/lint/build"         "| run tests/lint/build/type-check | ops agent (Haiku) | 1x |"
+    _static_row "commit + push + PR"           "| commit + push + PR | /pr skill | 1x-10x |"
+    _static_row "railway/deploy/status"        "| railway/deploy/status/logs/health | /sre skill | 10x |"
+    _static_row "CI/CD failures (fix)"         "| CI/CD failures (fix) | /ci-fix skill | 10x |"
+    _static_row "CI/CD failures (investigate)" "| CI/CD failures (investigate) | /sre ci | 10x |"
+    _static_row "new feature (multi-layer)"    "| new feature (multi-layer) | /planning → /implement | team |"
+    _static_row "bug fix (any)"                "| bug fix (any scope) | /fix skill | team |"
+    _static_row "review PR"                    "| review PR/code review | /review-pr skill | 10x |"
+    _static_row "frontend-only code change"    "| frontend-only code change | frontend agent (Sonnet) | 10x |"
+    _static_row "backend-only code change"     "| backend-only code change | backend agent (Sonnet) | 10x |"
+    _static_row "QA/test validation"           "| QA/test validation | /qa skill | 10x |"
+
+    cat <<'STATIC'
+| share/export plan or strategy ("share this", "format for slack", "make shareable") | /share skill | 1x |
+| autonomous work loop ("work on issues", "autopilot", "be a junior engineer") | /autopilot skill | team |
+| vague/greeting/broad first message ("hey", "hi", "hello", "yo", "sup", "help", "what's up", "what should I work on") | /welcome (non-engineers) or /onboard (engineers) | 1x |
+| architecture/complex reasoning | You (Opus) | 60x — LAST RESORT |
+| doesn't fit above | CREATE a new skill/agent, then use it | — |
+STATIC
+
+    cat <<'FOOTER'
+
+You are the ORCHESTRATOR. Route to the best tool for each NEW task.
+If you are already mid-task (e.g., restarting servers, running a multi-step operation),
+finish the work — don't delegate verification steps or quick follow-ups.
+
+ROUTING DECISION — use the SPEED test (takes 2 seconds):
+
+  S — Scope:    How many files/steps?  1-2 files = defaults, 3+ = toolkit
+  P — Project:  Needs CLAUDE.md context?  Yes = toolkit (agents read it)
+  E — Expertise: Domain-specific?  QA/SRE/design/architecture = toolkit agents
+  E — Effort:   Multi-turn workflow?  PR/deploy/planning = toolkit skills
+  D — Dollars:  Cheaper model enough?  Haiku/Sonnet agents save $$$ vs Opus
+
+  Score: 0-1 → Claude Code defaults.  2+ → toolkit agent or skill.
+
+ROUTING RULES (after SPEED scoring):
+1. Score 2+ AND skill match → use the skill (encodes multi-step workflows)
+2. Score 2+ AND agent match → spawn the agent (domain expertise + project context)
+3. Score 3+ AND multi-layer → /planning or /implement (team orchestration)
+4. Score 0-1 → Claude Code built-in tools:
+   - Read/Grep/Glob for quick lookups
+   - Edit/Write for small targeted changes
+   - Bash for single commands
+   - Built-in plugins (code review, setup) when they fit
+5. Nothing fits → CREATE a new skill/agent, then use it
+
+EXAMPLES:
+  "what's in config.py?"          → S:1 P:no E:no E:no D:no → 0 → use Read
+  "find all API routes"           → S:1 P:no E:no E:no D:yes → 1 → use Grep
+  "fix the auth bug"              → S:3+ P:yes E:yes E:yes D:yes → 4 → backend agent
+  "create a PR"                   → S:multi P:yes E:no E:yes D:yes → 3 → /pr skill
+  "deploy to staging"             → S:multi P:yes E:yes E:yes D:yes → 4 → /sre skill
+  "run tests"                     → S:1 P:no E:no E:no D:yes → 1 → ops (Haiku, cheap)
+
+VAGUE/ONBOARDING: If the user's first message is a greeting or vague ("hey",
+"hi", "hello", "yo", "sup", "help", "what's up", "what should I work on",
+or ANY message under 5 words with no specific task) → route to /onboard skill.
+NEVER respond to greetings yourself — always use /onboard for the full briefing.
+
+SELF-IMPROVEMENT: When you use Claude Code defaults over toolkit, note WHY
+in 1 line at the end. Example:
+  "Note: Used Grep — single-file search, SPEED score 0."
+This helps identify toolkit gaps. If you notice a pattern of defaults being
+chosen for a task category, suggest creating a new agent/skill for it.
+FOOTER
+}
+
+build_table
+
+# Update marker — full table has been emitted for this session
+mkdir -p "$(dirname "$MARKER_FILE")"
+date +%s > "$MARKER_FILE"