advisory-protocol

star 0

Advisory Protocol checkpoint for tiered self-escalation. Invoke before selecting an implementation approach when multiple options carry meaningfully different long-term consequences.

petersimmons1972 By petersimmons1972 schedule Updated 6/11/2026

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

  1. Check ADV.1–ADV.5.
  2. Build brief: Decision (1 sentence) · Options (A/B/C with tradeoffs) · Lean (preference + uncertainty source) · Context (file paths, constraints, prior attempts).
  3. Invoke advisor agent, wait for all four response sections before proceeding.
  4. Override? Log date | trigger | recommendation | decision | rationale to docs/overrides.md in your own project — not the installed skill copy (install.sh replaces 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.

Install via CLI
npx skills add https://github.com/petersimmons1972/claude-advisory-protocol --skill advisory-protocol
Repository Details
star Stars 0
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator
petersimmons1972
petersimmons1972 Explore all skills →