Planning
Structured task decomposition and tracking.
Turn complex goals into actionable steps.
[!TIP] Plans here are living documents. Unlike plan-then-execute, these evolve as you learn.
What This Is
A flexible planning system for:
- Breaking down large tasks
- Tracking progress
- Adapting as you learn
- Documenting decisions
Unlike plan-then-execute/: Plans here are living documents that evolve.
Structure
# PLAN.yml
plan:
goal: "Implement authentication system"
status: in_progress
tasks:
- id: 1
name: "Design auth flow"
status: done
- id: 2
name: "Implement login endpoint"
status: in_progress
subtasks:
- "Create route handler"
- "Add validation"
- "Write tests"
- id: 3
name: "Add session management"
status: blocked
blocked_by: 2
Key Difference from plan-then-execute
| Planning | Plan-Then-Execute |
|---|---|
| Plans evolve | Plans are frozen |
| Flexible | Auditable |
| For exploration | For security |
| Adapts to findings | Requires approval gate |
Use planning/ when you need to adapt. Use plan-then-execute/ when you need control.
Contents
| File | Purpose |
|---|---|
| SKILL.md | Full protocol documentation |
| PLAN.yml.tmpl | Plan template |
| PROGRESS.md.tmpl | Progress template |
The Intertwingularity
Planning is play-learn-lift applied to task decomposition.
graph LR
PL[🗂️ planning] -->|LEARN stage of| PLL[🎮📚🚀 play-learn-lift]
PL -->|frozen variant| PTE[📋 plan-then-execute]
PL -->|thinking in| SP[📝 scratchpad]
PL -->|logs to| SL[📜 session-log]
Dovetails With
Sister Skills
| Skill | Relationship |
|---|---|
| plan-then-execute/ | Frozen, auditable plans |
| play-learn-lift/ | Planning IS LEARN stage |
| scratchpad/ | For freeform thinking |
| session-log/ | Track planning progress |
| roberts-rules/ | Structured deliberation for planning decisions |
| adversarial-committee/ | Multiple perspectives on plan viability |
Protocol Symbols
| Symbol | Link |
|---|---|
PLAY-LEARN-LIFT | PROTOCOLS.yml |
Navigation
| Direction | Destination |
|---|---|
| ⬆️ Up | skills/ |
| ⬆️⬆️ Root | Project Root |
| 📋 Sister | plan-then-execute/ |
| 🎮 Sister | play-learn-lift/ |