name: advisory-protocol description: > Advisory Protocol checkpoint for tiered self-escalation. Invoke before selecting an implementation approach when multiple options carry meaningfully different long-term consequences.
Advisory Protocol
Triggers
| Code | Condition | Example |
|---|---|---|
| ADV.1 | Architecture fork: 2+ approaches with different long-term consequences | Rate limiting in proxy vs. application handler |
| ADV.2 | Infrastructure change: live deployment configs, DNS, storage, network rules | Ingress routing rule or database resize via Terraform |
| ADV.3 | Structural boundary rework: public interface, module seam, or data contract | Splitting a module into a new package with new contracts |
| ADV.4 | Stuck on reasoning: same root cause failed twice, failure is logic not capacity | Two wrong theories on the same bug with all evidence present |
| ADV.5 | Irreversible and ambiguous: hard to undo, right path unclear | Schema migration with no tested rollback path |
If unsure, trigger. Full definitions and worked examples: docs/advisory-protocol.md
Steps
- Check ADV.1–ADV.5.
- Build brief: Decision (1 sentence) · Options (A/B/C with tradeoffs) · Lean (preference + uncertainty source) · Context (file paths, constraints, prior attempts).
- Invoke advisor agent, wait for all four response sections before proceeding.
- Override? Log
date | trigger | recommendation | decision | rationaletodocs/overrides.mdin your own project — not the installed skill copy (install.shreplaces it on every upgrade).
Tier Ladder
| Tier | Use for |
|---|---|
| Haiku | Classification, formatting, retries, mechanical transforms |
| Sonnet | Implementation, debugging, multi-file edits, diagnosed fixes |
| Opus | Architecture, irreversible choices within the known solution space, stuck reasoning |
| Fable | Decisions where the frame itself may be wrong — agents/fable-advisor.md |
Upward escalation uses this ladder. Downward dispatch is governed by docs/dispatch-mandates.md — rules apply recursively to every agent you spawn. Full ladder and quality bar: docs/tier-selection.md.
Customization
Rename tiers, add triggers, or change the briefing format: docs/customization.md.