Mandatory Verification
Every plan must include verification steps with clear approaches (automated, manual, or hybrid). The skill recognizes hypotheses that need validation and ensures they're addressed before proceeding with implementation.
Skill
Write Plan
Create structured development plans with built-in verification and human oversight
Use in Claude Code
/intelligence-scale:write-plan The write-plan skill helps developers create detailed project plans before making changes. It ensures thorough documentation of files, hypotheses, and verification approaches while identifying when human review is needed. The skill produces structured plans with clear tasks and validation steps to guide development work.
Key Insights
Human Review Gates
Automatically identifies tasks requiring human verification based on four criteria: no computer use, subjective judgment, financial authorization, or security sensitivity. These tasks are prioritized at the start of the plan for early review.
Structured Templates
Uses standardized templates for plan components including project structure, tech stack, architecture, and algorithm design. This ensures consistency and completeness across all development plans.
Task Organization
Breaks down work into manageable tasks with clear dependencies and context awareness. Tasks are designed to be focused and appropriately sized for effective execution within context limitations.
How It Works
1
Skill Invocation
The skill is invoked at the start of planning with a specific announcement.
Before updating any plan files, you must explicitly call the write-plan skill. This ensures the planning process follows the structured approach defined by the skill's requirements.
2
Plan Creation
Generates a comprehensive plan using the mandatory template structure.
Creates a plan document with sections for goals, tasks, and verification. The plan includes all necessary details assuming the user has zero context about the codebase, ensuring thorough documentation.
3
Component Documentation
Documents project structure, tech stack, and architecture changes using specific templates.
When changes affect these areas, the skill uses predefined templates to show both before and after states. This provides clear visualization of how the project will evolve.
4
Verification Planning
Identifies verification needs and creates detailed testing approaches.
Lists all verification steps needed to confirm the plan's success. This includes both automated testing approaches and manual verification requirements with specific test cases and assertions.
5
Human Review Identification
Flags tasks requiring human verification and prioritizes them in the plan.
Analyzes the plan to identify where human judgment is needed based on four specific criteria. These tasks are moved to the beginning of the plan to ensure early review and approval.