| name | plan-lint |
| description | Validates a plan against documentation constraints before coding. Use after doc-discovery and before implementation. Returns PASS, WARN, or FAIL with specific issues. Gate 1 of 2-gate flow. |
| allowed-tools | Read, Glob, Grep |
Plan Lint
Ensure plan is doc-consistent before coding. Gate 1 of 2-gate flow.
When to Use
- After
/doc-discovery, before coding
- When reviewing someone else's plan
- Before spawning implementation agents
- When user asks "is this plan safe?"
Required Plan Elements
| Element |
Required |
| Primary Feature |
Yes |
| Impacted Features |
Yes |
| User-Facing Changes |
Yes |
| Files/Surfaces to modify |
Yes |
| Data Impact (tables, RLS) |
If applicable |
| Invariants (min 3) |
Yes |
| Test Plan |
Yes |
| Docs to Update |
Yes |
Checks
- Feature Coverage: Primary named? Exists in index? Coupled features included?
- Invariant Coverage: At least 3? Match feature docs? High-risk addressed?
- Data Safety: Tables listed? RLS documented? Migration + rollback plan?
- Test Coverage: Verification steps? Workflow smoke test? Regression areas?
- Workflow Impact: Affected workflows identified? No journeys broken?
Blast Radius
| Factor |
Points |
| Auth/RLS |
+3 |
| Billing/credits |
+3 |
| AI/prompts |
+2 |
| Schema/migrations |
+2 |
| 3+ features |
+2 |
| Shared components |
+1 |
| User workflow change |
+1 |
0-2: Low → Standard review
3-5: Medium → Careful review
6+: High → Doc Agent validation required
Output
## Plan Lint: [PASS/WARN/FAIL]
**Blast Radius**: [score] ([low/medium/high])
### Validation
- [x/] Primary feature: [name]
- [x/] Impacted features: [count]
- [x/] Invariants: [count]
- [x/] Test plan: [status]
- [x/] Workflow impact: [status]
### Issues (if any)
1. **[Category]**: [Problem] → [Fix]
### Ready to Implement
[Yes / Conditional / No]
Related