What problem does it solve?
Prevents surprise, scope creep, and unreviewable diffs by forcing agents to declare intent, scope changes, and assumptions before touching code. It ensures humans can verify what changed, why it changed, and how to validate it, reducing risky multi-file edits and regression-prone refactors.
Core Features & Use Cases
- Intent-first workflow: Agents must present a concise intent block (goal, files, approach, done criteria) and receive confirmation before making edits.
- Task sizing & chunking: Rules for single-pass vs split-pass changes based on touched-file counts make large changes reviewable.
- Assumptions, scope guards, and summaries: Surface design choices, verify dependencies exist, avoid collateral refactors, and produce a review-friendly “What changed / How to verify / Assumptions” summary after edits.
- Use when performing feature work, multi-file refactors, database or auth-impacting changes, or any production-risk coding task to keep reviewers confident and reduce rework.
Quick Start
Before modifying code, write an intent block that lists the goal, every file you'll touch, your approach, and the done condition, then ask the user to confirm.