Agent skill
plan-lint
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.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/plan-lint
SKILL.md
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?
- Page Standards (for new pages):
- Plan includes AIPanel with agentType
- Plan includes contextScope configuration
- No solid backgrounds on page containers
- Canvas Header follows h-24, bg-white/5 pattern
- Org-Scoped Features (if org-specific):
- org_id column included in relevant tables
- RLS policies enforce org isolation
- RAG scope includes orgId filtering
Blast Radius
| Factor | Points |
|---|---|
| Auth/RLS | +3 |
| Billing/credits | +3 |
| AI/prompts | +2 |
| Schema/migrations | +2 |
| 3+ features | +2 |
| Org-scoped content | +2 |
| New page without AI Panel spec | +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
- Output templates: See reference/output-templates.md
- Common failures: See reference/failure-patterns.md
- If blast radius >= 6: Escalate to @doc-agent
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?