Imported from xenitv1/claude-code-maestro (
skills/planning-mastery/SKILL.md). Install upstream withnpx skills add xenitv1/claude-code-maestro --skill planning-mastery. Copyright stays with the author.
<domain_overview>
📋 RFC-Lite Planning Protocol
The 300-Line Limit: If your plan exceeds 300 lines, YOU HAVE FAILED. Rule: Code belongs in files, not plans. Do not write pseudo-code. Do not paste entire file contents. Focus: Define What (Files), How (Logic Strategy), and Success (Verification).
DEPENDENCY FORECASTING MANDATE (CRITICAL): Never propose a change without mapping its "Blast Radius". AI-generated plans frequently fail by ignoring downstream effects on coupled modules. Before defining file changes, you MUST explicitly identify which existing features or tests might break. If a change requires "Shotgun Surgery" (modifying more than 5 files for one feature), you MUST pause and propose an architectural abstraction instead. </domain_overview>
🎯 CORE PHILOSOPHY
Understanding comes before implementation. A well-designed solution is half-implemented. Never code without a clear design. <template_enforcement>
📝 MANDATORY TEMPLATE (Copy & Fill)
# [Task/Feature Name] - Implementation Plan
## 1. 🎯 Objective
[1-2 sentences strictly defining the goal.]
## 2. 🏗️ Tech Strategy
- **Pattern:** [e.g. Composition vs Inheritance]
- **State:** [e.g. Global Store vs Local Hook]
- **Constraints:** [e.g. "Must use LCH colors", "No external libs"]
## 3. 📂 File Changes
| Action | File Path | Brief Purpose |
|:-------|:----------|:--------------|
| [NEW] | `src/components/MyComp.tsx` | Visual shell |
| [MOD] | `src/App.tsx` | Routing integration |
## 4. 👣 Execution Sequence
1. **Scaffold:** Create component files with types (No logic yet).
2. **Logic:** Implement `useLogic.ts` hook with TDD.
3. **Visuals:** Apply LCH gradients & Glassmorphism.
4. **Connect:** Wire up to parent component.
## 5. ✅ Verification Standards
- [ ] **Visual:** Check against `frontend_reference.md` (no flat colors).
- [ ] **Interaction:** Verify `scale(0.97)` tap effect.
- [ ] **Console:** Zero errors during flow.</template_enforcement> <strict_rules>
⛔ ZERO TOLERANCE RULES
- NO CODE BLOCKS: Do not write function bodies in the plan.
- NO EXPLANATIONS: Do not teach the user why React is good.
- NO CONVERSATION: Do not talk to the user in the plan.
- STAY HIGH LEVEL: "Implement Auth" is better than "Write function login() { ... }". </strict_rules> <audit_and_reference>
📂 COGNITIVE AUDIT CYCLE
- Does the plan exceed 300 lines?
- Are all breaking changes identified?
- Is it RFC-Lite compliant?
- Are verification steps actionable commands? </audit_and_reference>
