doctor

Run the following checks IN ORDER. Execute each step via Bash (or by introspection where noted). Do NOT print results as you go — collect each result silently, then print only the final table at the end.

For each check, record one of: PASS, WARN, or FAIL, plus a brief evidence/fix string.

---

CHECK 0 — PLUGIN ROOT

echo "${CLAUDE_PLUGIN_ROOT}"

• Non-empty output AND the path exists on disk → PASS (record the path)
• Empty or path does not exist → FAIL: "plugin variable not resolving — reinstall the plugin"

---

CHECK 1 — DEPENDENCIES

command -v python3 && echo "python3 ok" || echo "python3 missing"
command -v git && echo "git ok" || echo "git missing"

• Both present → PASS
• python3 missing → FAIL: "Gearbox hooks are python3 scripts; install python3 — both hooks are currently failing silently"
• git missing only → WARN: "verifier baseline checks need git"

---

CHECK 2 — POLICY INJECTION

Introspect without reading any files: is the Gearbox tier table (T0/T1/T2 with gearbox:scout / gearbox:grunt / gearbox:builder / gearbox:architect) present in your context right now?

• Yes → PASS
• No → FAIL: "SessionStart hook not firing — check /plugin detail view for hook load errors, then restart the session"

---

CHECK 3 — AGENT REGISTRY

Introspect your available subagent types. Check for all five: gearbox:scout, gearbox:grunt, gearbox:builder, gearbox:architect, gearbox:verifier.

• 5/5 present → PASS
• Fewer than 5 → FAIL listing the missing names: "restart the session; agents only load at session start"

---

CHECK 4 — INSTALL SCOPE

python3 - <<'EOF'
import json, pathlib, sys
p = pathlib.Path.home() / ".claude/plugins/installed_plugins.json"
if not p.exists():
    print(f"MISSING:{p}")
    sys.exit(0)
data = json.loads(p.read_text())
entries = []
for key, installs in data.get("plugins", {}).items():
    if "gearbox" in key.lower():
        entries.extend(installs)
if not entries:
    print("NOT_FOUND")
    sys.exit(0)
scopes = [e.get("scope","?") for e in entries]
print("SCOPES:" + ",".join(scopes))
EOF