advisor

This repository is the canonical home of Advisor Mode for Claude Code: the top-tier model plans, discusses, and reviews; implementation labor is delegated to lower-tier subagents, with an escalation path back up for hard problems.

• The standing rule (this repo): CLAUDE.md
• The machine-wide rule (all repos/projects): global/CLAUDE.md
• Worker/consultant agent definitions: .claude/agents/

Install machine-wide

Run once per machine to apply Advisor Mode to every repo and project on it (installs into ~/.claude/CLAUDE.md and ~/.claude/agents/).

Quick start (new machine)

# macOS / Linux
git clone https://github.com/Sutaigne/advisor && cd advisor && ./install.sh

# Windows (PowerShell) — cd ~ first: an elevated prompt starts in system32,
# where git can't create the clone dir. The Bypass flag sidesteps script
# execution policy for this run only.
cd ~; git clone https://github.com/Sutaigne/advisor; cd advisor; powershell -ExecutionPolicy Bypass -File .\install.ps1

Idempotent — re-run after editing global/CLAUDE.md or the agents to update in place. Anything else you keep in ~/.claude/CLAUDE.md is preserved; the rule lives inside a managed marker block.

Cloud sessions (claude.ai/code)

Cloud Claude Code sessions run in ephemeral containers that do not read your local ~/.claude, so the install above never reaches them. Instead, configure the environment's setup script to run cloud-setup.sh, e.g.:

git clone https://github.com/Sutaigne/advisor "$HOME/.advisor-mode" && bash "$HOME/.advisor-mode/cloud-setup.sh"

Or simply paste the contents of cloud-setup.sh as the environment's setup script.

If you can't control the environment's setup script for a given repo, the alternative is to commit a per-repo CLAUDE.md copy instead (as this repo does).