What is a Plan Digest in Plan Guardian?

A Plan Digest is a lightweight JSON file generated from your PRD and design docs that summarizes core problems, boundaries, and technical constraints to serve as the 'source of truth' for the guardian.

Can I bypass a drift warning if I intentionally change the plan?

Yes, you can respond to warnings with 'Continue anyway' or 'Update plan' commands, which logs the justification and adjusts the monitoring context accordingly.

What happens when a 'HALT' signal is triggered?

A HALT signal blocks the current work stream and requires manual human intervention, preventing the AI from proceeding with a high-confidence violation of the original plan.

How does Plan Guardian detect project drift?

It uses a sampling hook to monitor file changes and bash commands, evaluating them against the Plan Digest based on scope, architecture, and previous key decisions.

Does this skill interfere with my coding speed?

No, it runs as a background process with configurable sampling rates (e.g., every 5 actions), ensuring it provides oversight without causing significant latency.

Plan Guardian

Name: Plan Guardian
Author: turbobeest

byturbobeest

0•

Analytics & Monitoring

Monitors development progress in real-time to detect and prevent deviations from original project requirements and architectural plans.

Plan Guardian acts as an autonomous oversight agent that runs alongside Claude to ensure every code change aligns with your project's initial scope and technical constraints. By sampling work-in-progress and comparing it against a lightweight plan digest, it proactively catches scope creep and architectural violations before they require significant rework. It provides a multi-level alerting system—ranging from subtle warnings to hard halts—enabling developers to maintain project integrity and consistency throughout the entire development lifecycle without constant manual review.

Key Features

01Real-time work sampling via file-write and command hooks

02Lightweight plan digest generation from PRDs and ideation documents

03Multi-level drift detection including Notice, Warn, Drift, and Halt thresholds

040 GitHub stars

05Automated injection of alignment reminders directly into the active agent's context

06Comprehensive drift logging and end-of-pipeline summary reports for auditability

Use Cases

01Auditing autonomous AI development to ensure compliance with original business requirements

02Preventing scope creep during rapid implementation phases by flagging unplanned features

03Enforcing architectural patterns and technology stack constraints across complex codebases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add turbobeest/squawk plan-guardian

For use in Claude.ai and ChatGPT

Download Skill