| name | write-implementation-plan |
| description | Forces the agent to research and write a structured implementation plan before writing any code. |
⚠️ MANDATORY DIRECTIVE: PLAN BEFORE EXECUTION
DO NOT WRITE ANY CODE UNTIL implementation_plan.md IS DRAFTED AND APPROVED.
1. THE PLANNING WORKFLOW
flowchart TD
A[Task Received] --> B[Codebase Research]
B --> C[Draft implementation_plan.md]
C --> D{User Approval?}
D -- No --> E[Refine Plan]
E --> C
D -- Yes --> F[Execute Code Changes]
F --> G[Verify Output]
2. PLAN STRUCTURE REQUIREMENTS
Your implementation_plan.md MUST adhere strictly to this template:
I. GOAL
State the exact objective. 1-2 sentences maximum. No fluff.
II. OPEN QUESTIONS
Expose all ambiguities and missing context immediately using GitHub Alerts:
[!WARNING]
[Question or missing context here]
III. PROPOSED CHANGES
Itemize file changes using strict tagging:
[NEW] path/to/new_file.ext
[MODIFY] path/to/existing_file.ext
[DELETE] path/to/dead_file.ext
IV. VERIFICATION PLAN
Actionable, exact steps to prove the implementation works.
3. RULES OF ENGAGEMENT
- CONCISE & DENSE: Zero preamble. Maximum information density.
- AUTHORITATIVE: State facts. Eliminate "I think" or "Maybe".
- RESEARCH FIRST: Blind planning is forbidden. Read files before proposing changes.