Claude Code Advisor

claude-code-advisor 🔍

**A read-only verification agent for Claude Code — the AI that audits your other AIs.**

Turn a second Claude session into your **brutally honest, read-only advisor**: it reviews what your working sessions build, verifies claims with its own eyes, separates **PROVEN from CLAIMED**, and tells you plainly whether to greenlight — with the exact text to paste next.

Built from months of running real client automations with AI executor sessions. The pattern it packages:

 EXECUTOR session  →  builds, fixes, ships
 ADVISOR session   →  verifies independently (read-only), catches traps, gives the verdict
 YOU               →  make the call

Why a separate advisor?

A session that builds something can't audit itself — it shares its own blind spots. The advisor:

• Never writes, never runs, never fixes — read-only by hard rule, so its verdict stays independent
• Verifies by a different path than the executor used (agreement ≠ verification)
• Separates built / verified / still-draft / live and working — so "done" is never fuzzy
• Catches the classic traps: re-litigation, churn, scope drift, over-engineering, "impossible" that nobody actually checked
• Talks like a sharp friend, not a corporate report: 4-line status, verdict color 🟢🟡🔴, then the next move

Install (Claude Code)

Copy the `advisor/` folder into your skills directory:

cp -r advisor ~/.claude/skills/advisor

New session → type `/advisor` → paste your working session's output → get the verdict.

Works in any Claude surface: the body of `advisor/SKILL.md` also works pasted as a standalone system/mode prompt.

The loop

1. Your working session reports "done" or proposes a plan
2. Paste that output to the advisor
3. Advisor opens the real state read-only, verifies, answers: status color · what's PROVEN vs CLAIMED · the exact text to paste back
4. You decide. Repeat.

Works best with

• [claude-code-brain](https://github.com/roozbeh-bahrami/claude