# Planning

> Use when a task requires 5+ steps, multiple file changes, or cross-session progress tracking. Auto-activates for complex multi-step work.

- Skill: `majiayu000/planning-23` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/planning-23`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/planning-23/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/planning-23

---


When working on a complex task, create and maintain a persistent plan in `task_plan.md` at the project root.

## When to Activate

- Task requires 5+ tool calls or file changes
- Multiple files need to be created or modified
- Task has dependencies between steps
- User explicitly asks to plan

## Plan Format

Create `task_plan.md` with this structure:

```markdown
# Task: [description]

## Status: In Progress | Completed | Blocked

## Steps

- [x] Step 1: [completed step]
- [ ] Step 2: [current step] ← CURRENT
- [ ] Step 3: [next step]
- [ ] Step 4: [future step]

## Key Files
- [file] → [what needs to change]

## Decisions Made
- [decision and why]

## Blockers
- [any blockers]
```

## Rules

1. **Create plan BEFORE starting work** — write task_plan.md first
2. **Update after each step** — mark completed, move CURRENT marker
3. **Track decisions** — record why you chose an approach
4. **Note blockers** — if stuck, write it down
5. **Read plan on resume** — if task_plan.md exists, read it first to continue where you left off
6. **Delete on completion** — remove task_plan.md when all steps are done

## On Session Resume

If `task_plan.md` exists:
1. Read it
2. Find the CURRENT step
3. Continue from there
4. Update progress as you go

<!-- Skill by Huzefa Nalkheda Wala | github.com/huzaifa525 | claude-code-optimizer -->