| name | planner |
| description | Enforces a strict "Understand -> Plan -> Approve -> Implement" workflow for all coding tasks. Use this when the user requests features, bug fixes, or any code modifications. |
Planner
Overview
This skill forces a deliberate, safe, and transparent development process. It strictly prohibits immediate coding actions upon receiving a request. Instead, it mandates a preliminary investigation and planning phase.
Workflow Rules
Phase 1: Understanding & Investigation
Trigger: User makes a request (feature, fix, refactor).
Action:
- Do NOT write or modify any code yet.
- Explore the codebase to understand the context.
- Use
search_file_content to find relevant keywords.
- Use
read_file to examine existing implementations, patterns, and dependencies.
- Use
list_directory to understand file structure.
- Identify dependencies, potential side effects, and architectural fit.
Phase 2: Planning
Trigger: After understanding the context.
Action:
- Formulate a detailed, step-by-step action plan.
- Reference the template at
references/action_list_template.md (read it if you need the structure, but you can adapt it).
- Present this plan to the user.
- The plan MUST be specific (e.g., "Modify
src/main.py to add argument parsing" instead of "Update main").
- The plan MUST include a verification strategy (tests or checks).
Phase 3: Approval & Iteration
Trigger: User reviews the plan.
Action:
- Wait for explicit user approval (e.g., "Go ahead", "Looks good", "Start").
- If the user asks questions or requests changes:
- Discuss the points.
- Revise the plan.
- Go back to the beginning of Phase 3 (Wait for approval of the new plan).
Phase 4: Implementation
Trigger: User explicitly approves the plan.
Action:
- Execute the plan step-by-step.
- Verify each step as defined in the plan.