# planning-documentation

planning-documentation builds granular, TDD-focused implementation blueprints with exact file paths and test commands. Outputs ready-to-run plans for subagents.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 149 installs · ★ 50 repo stars
- Author: qodex-ai
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/planning-documentation/SKILL.md
- Updated: 2026-01-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/planning-documentation

## What it does

The skill organizes software changes assuming the developer has zero familiarity with the repository. Tasks are broken into two-to-five-minute units: drafting a failing check, verifying the error, coding the bare minimum solution, confirming the pass, and committing changes.

All generated guides follow a fixed template and land in `docs/plans/YYYY-MM-DD-<feature-name>.md`. They list specific file locations, code snippets, and shell commands. Once written, the skill prompts the user to execute via dedicated subagents in place or dispatch work to a separate session.

Without an isolated git worktree and partner skills like `executing-plans` or `subagent-driven-development`, the automated task handoff cannot proceed.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill planning-documentation -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill planning-documentation -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill planning-documentation -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qodex-ai/ai-agent-skills skills/planning-documentation
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill planning-documentation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/planning-documentation
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill planning-documentation -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/qodex-ai/ai-agent-skills/tree/HEAD/skills/planning-documentation/SKILL.md

## When to use it
- build an incremental implementation roadmap following test-driven development
- break down complex feature work into five-minute commit steps
- specify exact file locations and pytest commands ahead of implementation
- prepare structured task documents for subagent execution

## Example prompts
- Create an implementation plan for the Stripe webhook handling flow
- Draft a TDD step-by-step plan for the user profile export feature
- Generate a plan to refactor the session middleware into docs/plans/

## Similar
- [043-planning-github-issues](https://affpapa.org/en/nevibecode/skills/043-planning-github-issues.md) — skill · 312 installs
- [plan-crafting](https://affpapa.org/en/nevibecode/skills/plan-crafting.md) — skill · 4100 installs
- [planning-with-files](https://affpapa.org/en/nevibecode/skills/othmanadi-planning-with-files.md) — skill · 49300 installs
- [planning](https://affpapa.org/en/nevibecode/skills/planning.md) — skill · 712 installs
- [planning-agent](https://affpapa.org/en/nevibecode/skills/planning-agent.md) — skill · 522 installs
- [planning-cadence](https://affpapa.org/en/nevibecode/skills/planning-cadence.md) — skill · 491 installs

From the same set: [qodex-ai/ai-agent-skills](https://affpapa.org/en/nevibecode/by/qodex-ai/ai-agent-skills.md) — 42 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
