Our review
Creates a structured implementation plan for a feature or task by exploring the codebase and breaking work into sequenced steps.
Strengths
- Produces a detailed, phased plan with trade-off analysis
- Integrates existing codebase discovery for context-aware recommendations
- Uses TDD approach by suggesting tests before implementation
- Includes risk assessment and success criteria
Limitations
- Requires a clear feature description to be effective
- May be limited by ability to deeply explore very large codebases
- Does not write any code until the user confirms the plan
When implementing a complex feature that requires careful planning and understanding of the existing codebase.
For trivial fixes or very simple tasks that do not warrant a formal planning phase.
Security analysis
CautionThe skill instructs a planner agent to explore codebases and create implementation plans. It uses Bash for legitimate exploration but does not direct destructive or exfiltrating actions. The presence of Bash tool warrants caution due to its power, but the skill itself is safe.
No concerns found
Examples
Create an implementation plan for adding user authentication with JWT tokens. Include test strategies and consider security patterns used in the codebase.Plan the migration of REST API endpoints from v1 to v2, preserving backward compatibility and updating documentation.Create a structured plan to refactor the payment processing module, focusing on separating concerns and improving testability.name: my-plan description: "Create a structured implementation plan for a feature or task" allowed-tools:
- Read
- Grep
- Glob
- Bash
- WebSearch
- WebFetch
- TaskCreate
- TaskUpdate
- TaskList
- TaskGet
- AskUserQuestion context: fork agent: planner
You are now in planning mode. Your goal is to create a thorough implementation plan.
Instructions
-
Understand the Request
- Read CLAUDE.md for project conventions
- Read relevant rules/ files for the domain
- If the requirement is ambiguous, ask clarifying questions via AskUserQuestion
-
Explore the Codebase
- Search for existing patterns similar to the requested feature
- Identify all files that will need changes
- Check existing tests for conventions and patterns
- Look for reusable utilities, types, and components
-
Design the Solution
- Propose an architecture with trade-off analysis
- Identify dependencies between components
- Plan the TDD approach: which tests to write first
- Consider edge cases and error handling
-
Create the Plan
- Use TaskCreate to build a sequenced implementation list
- Each task should be small enough to complete in <50% context
- Include test files in the sequence (RED before GREEN)
- Note file paths for every change
-
Output the Plan
- Analysis of what exists
- Recommended approach with rationale
- Step-by-step implementation tasks (phased)
- Trade-off analysis for key decisions
- Risks and mitigation strategies (with severity)
- Success criteria checklist
-
Wait for Confirmation
- End with:
**WAITING FOR CONFIRMATION**: Proceed? (yes / no / modify) - Do NOT write any code until the user explicitly confirms
- If user says "modify", revise the plan accordingly
- End with:
Arguments
The user will provide a feature description or requirement as the command argument.
Next.js App Router Expert
Development
A skill that turns Claude into a Next.js App Router expert.
README Generator
Development
Creates professional and comprehensive README.md files for your projects.
API Documentation Writer
Development
Generates comprehensive API documentation in OpenAPI/Swagger format.