Advisor

advisor


A one-command, Opus-led code review-and-fix pipeline for Claude Code. Opus goes first — does its own Glob+Grep discovery, ranks files P1–P5, and **writes a unique, file-aware prompt for every agent** based on what it just learned. Then it stays online and **actively steers the team throughout**: redirecting drift, answering questions in real time, verifying each output the moment it lands, and adjusting the plan when a finding changes the picture. Opus is the strategist that never goes idle until the final report ships. Optional fix wave applies edits the same way.

No external API calls. Runs entirely through Claude Code's native `TeamCreate` / `Agent` / `SendMessage` tools.

**Implementation:** Rust (`advisor-rs` crate, `advisor` CLI). The Python package has been superseded on `main`; see [`RUST_PORT_PLAN.md`](RUST_PORT_PLAN.md) and [`PORT_NOTES.md`](PORT_NOTES.md) for migration status.

Team (three-tier, default)

Role	Model	Agent type	Job
Advisor	Opus 4.8 (claude-opus-4-8)	generalPurpose	Glob+Grep discovery, P1–P5 ranking, sizes explorer + coder pools, writes per-agent prompts, dispatches explore + fix waves — stays live: redirects drift, answers questions, verifies each output, adjusts plan mid-wave
Explorer pool	Haiku 4.5 (claude-haiku-4-5) × N	explore	Read-only structural discovery on advisor-assigned file batches; reports findings to team-lead → advisor
Coder pool	Sonnet 4.6 (claude-sonnet-4-6) × N	generalPurpose	Long-lived fix workers; each gets a domain-specific prompt (with exploration context on fix assignments); reports findings + diffs to team-lead → advisor

Priority scale: **P5** auth/secrets · **P4** user input/parsing · **P3** handlers/DB/exec · **P2** config/crypto/logging · **P1** utils/tests.

Loop: **Explorer discovers → Advisor reasons → Coder fixes.**

Legacy two-tier mode