# planner

Splits bug fixes and feature development into structured sprints and atomic tasks. It helps you design software changes before writing any code.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 installs · ★ 1039
- Author: am-will
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/am-will/codex-skills/tree/HEAD/skills/planner/SKILL.md
- Updated: 2026-07-14
- HTML: https://affpapa.org/en/nevibecode/skills/planner

## What it does

The skill inspects codebase architecture and related components, then asks between five and ten clarifying questions regarding scope, edge cases, and tech constraints. When external libraries or APIs are involved, it pulls documentation using the Context7 skill. After clarifying requirements, it drafts an overview with incremental sprints where each milestone yields testable work.

Tasks within each sprint stay atomic and committable. The plan lists file paths, dependencies, and verification criteria. The skill saves the output as a Markdown file ending in `-plan.md`. Right after saving, it analyzes potential pitfalls and can prompt for up to three details about missing steps or edge cases.

Planner strictly avoids implementing code. If you expect an agent to start editing source files right away, this skill will slow you down because its only job is drafting the roadmap.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill planner -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill planner -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill planner -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install am-will/codex-skills planner
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill planner -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/am-will/codex-skills --path skills/planner
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill planner -a opencode
```

### 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/am-will/codex-skills/tree/HEAD/skills/planner/SKILL.md

## When to use it
- decompose a bug fix into atomic, committable tasks
- clarify technical scope with targeted questions before coding
- draft sprint structures with testable increments and rollback steps
- catch missing dependencies and edge cases ahead of time

## Example prompts
- /planner map out token authentication in src/auth.ts
- break this down into tasks: migrate cache layer to redis
- /plan outline steps to resolve session memory leaks

## Similar
- [plan](https://affpapa.org/en/nevibecode/skills/owainlewis-plan.md) — skill · 747 installs
- [kontour-travel-planner](https://affpapa.org/en/nevibecode/skills/kontour-travel-planner.md) — skill · 478 installs
- [adhd-daily-planner](https://affpapa.org/en/nevibecode/skills/adhd-daily-planner.md) — skill · 378 installs
- [career-path-planner](https://affpapa.org/en/nevibecode/skills/career-path-planner.md) — skill · 334 installs
- [notion-spec-to-implementation](https://affpapa.org/en/nevibecode/skills/notion-spec-to-implementation.md) — skill · 14 installs
- [edge-ai-tasks](https://affpapa.org/en/nevibecode/plugins/edge-ai-tasks.md) — plugin · ★ 40418

From the same set: [am-will/codex-skills](https://affpapa.org/en/nevibecode/by/am-will/codex-skills.md) — 13 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