---
name: Advisor
description: "Manage budget-aware advisor mode — control model tiering for subagents based on weekly usage. USE WHEN user says 'advisor', 'budget mode', 'set advisor', 'save budget', '/advisor', 'how much budget', OR wants to control model tiering for subagents."
---

## Advisor Mode Management

USE WHEN user says 'advisor', 'budget mode', 'set advisor', 'save budget', '/advisor', 'how much budget', OR wants to control model tiering for subagents.

ALSO USE WHEN user says plain-language budget/mode phrases like:
- "go easy on the budget", "save tokens", "be conservative" → set mode to conservative
- "use haiku only", "strict mode", "budget is tight" → set mode to strict
- "lock it down", "critical mode", "almost out of budget" → set mode to critical
- "go full power", "use whatever model", "no budget constraints", "normal mode", "unrestricted" → set mode to normal
- "back to auto", "reset advisor", "let the budget decide" → set mode to auto

When you detect these, write the appropriate mode to `~/.claude/pai/advisor-mode.json` and confirm what you did.

Advisor mode controls which models subagents use, based on weekly budget consumption.

### Configuration

The config file is at `~/.claude/pai/advisor-mode.json`:
```json
{
  "weeklyBudgetPercent": 90,
  "mode": "auto"
}
```

### Usage

- `/advisor` — show current mode and budget
- `/advisor set <percent>` — set weekly budget percentage (triggers auto mode calculation)
- `/advisor mode <normal|conservative|strict|critical>` — force a specific mode
- `/advisor auto` — reset to auto mode (derives from weeklyBudgetPercent)
- `/advisor force <model>` — force all subagents to use a specific model (haiku/sonnet/opus)
- `/advisor reset` — remove the config file (no advisor guidance injected)
- Or just say it in plain language — see triggers above

### Mode Thresholds (auto mode)

| Budget Used | Mode | Subagent Model | Behavior |
|-------------|------|----------------|----------|
| < 60% | normal | Any | No constraints |
| 60-80% | conservative | Haiku preferred | Escalate to sonnet only if haiku insufficient |
| 80-92% | strict | Haiku only | Minimize spawning, no opus subagents |
| > 92% | critical | Haiku or none | Essential work only, minimize all token usage |

### Workflow

**Show current status:**
Read `~/.claude/pai/advisor-mode.json`. Display the mode, budget percentage, and what model constraints are active.

**Update budget percentage:**
The user reads their weekly budget from the statusline (e.g., "7d: 63% → Fr. 08:00").
Write the percentage to `weeklyBudgetPercent` in the config file.
If mode is "auto", the whisper hook will compute the appropriate tier.

**Force a mode:**
Set `mode` to the desired value. Overrides auto calculation.
Useful when the user wants to be aggressive (normal) or cautious (strict) regardless of actual budget.

**Force a model:**
Set `forceModel` to "haiku", "sonnet", or "opus". ALL subagents will use this model.
Useful for testing or when the user knows exactly what they want.

### Integration

The advisor config is read by the whisper-rules hook on every prompt. Changes take effect immediately — no restart needed. The guidance appears as an ADVISOR MODE line in the system-reminder alongside the whisper rules.