# planning

Keeps markdown files for goals, findings and session progress so an agent doesn't drift off the task mid-run.

- skill · `type=skill` · Claude Code · 712 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/ai-maestro/planning
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/planning

## What it does

The skill splits a job across three files in `docs_dev/` or whatever `$AIMAESTRO_PLANNING_DIR` points to: `task_plan.md` holds goals, phases, decisions and errors, `findings.md` collects research, and `progress.md` is the session log with test results. You write to them as you go, not at the end.

Six rules and two protocols shape the behaviour. The two-action rule says save findings to `findings.md` after every two search or browse operations. The three-strike protocol walks a failing action up a ladder: diagnose the root cause and patch it, then try a different approach, then question your assumptions — and after the third strike hand the whole trail to the user. When the agent loses the thread, five questions pull it back: current phase, remaining phases, the goal, what was learned, what was done.

Nothing else is needed to run it. The wider AI Maestro platform adds memory search, docs search, graph queries and messaging between agents, and it installs separately. For a task that fits in a couple of tool calls the files just clutter the repo.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill ai-maestro/planning
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill planning -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/planning/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/planning/

### Codex

**Manually: put the files in place**
- File: `.agents/skills/planning/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/planning/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates planning
```

2. **Manually: put the files in place**
- File: `.github/skills/planning/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/ai-maestro/planning
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/planning/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/ai-maestro/planning

## When to use it
- hold the goal across a ten-step task
- carry findings from one agent session to the next
- record an error and its fix so it isn't repeated
- see which phase the work stopped at
- break a research project into tracked stages

## Example prompts
- create a plan for refactoring the auth module
- set up `task_plan.md` and mark phase one done
- log the findings in `findings.md` and continue from phase two

## Similar
- [planning-with-files](https://affpapa.org/en/nevibecode/skills/othmanadi-planning-with-files.md) — skill · 47000 installs
- [planning-and-task-breakdown](https://affpapa.org/en/nevibecode/skills/planning-and-task-breakdown.md) — skill · 64300 installs
- [new-work](https://affpapa.org/en/nevibecode/skills/new-work.md) — skill · 327 installs
- [planning-agent](https://affpapa.org/en/nevibecode/skills/planning-agent.md) — skill · 518 installs
- [planning-cadence](https://affpapa.org/en/nevibecode/skills/planning-cadence.md) — skill · 411 installs
- [roadmap-planning](https://affpapa.org/en/nevibecode/skills/roadmap-planning.md) — skill · 3800 installs

## Other versions with the same name
- [planning · mblode](https://affpapa.org/en/nevibecode/skills/mblode-planning.md) — 446 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 205 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md