plan-guardian

Detect plan drift by sampling active work against a plan digest.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/turbobeest/dev-system --skill plan-guardian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-guardian
Source: https://github.com/turbobeest/dev-system/tree/main/skills/plan-guardian
Command: npx skills add https://github.com/turbobeest/dev-system --skill plan-guardian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and scripts (resource) and references (resource) components.

What problem does it solve?

Background monitoring agent that detects drift from the original plan. It samples work-in-progress and compares against a plan digest to catch misalignment early.

Core Features & Use Cases

  • Drift detection: Continuous sampling against plan digest and thresholds.
  • Guardian injections: Injects warnings or drift signals into active agent context.
  • Signals & logging: Emits drift-related signals for audit and decision-making.

Quick Start

Enable plan guardian and let it run alongside active development to catch drift early.

Frequently Asked Questions about plan-guardian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect when my development work drifts from the original plan?

Plan drift detection compares your active development work against a plan digest stored at .claude/plan-digest.json. The Skill samples work streams and phase transitions continuously, raising warnings when misalignment exceeds your configured sensitivity thresholds, so you catch deviations early before they compound.

Can I monitor plan drift while agents are actively working?

Yes. Plan guardian runs as a background monitoring agent alongside active development, sampling work-in-progress without blocking agent execution. It injects drift warnings or signals directly into the active agent context when deviations are detected.

What configuration do I need to set up plan monitoring?

Create a lightweight plan digest at .claude/plan-digest.json, enable the plan-guardian-hook.sh sampling script, and configure sampling_rate and sensitivity parameters. Multi-criteria drift assessment then runs automatically against your specified thresholds.

How does plan guardian signal drift when it's detected?

Plan guardian emits structured WARN or DRIFT injections into the active agent context, alongside drift-related signals for audit and decision-making. This allows agents to adjust course or raise alerts based on detected misalignment severity.

What's the difference between sampling rate and sensitivity in drift detection?

Sampling rate controls how frequently work streams are checked against the plan digest, while sensitivity determines the threshold at which deviations trigger warnings. Tuning both lets you balance detection coverage with alert noise.