planning-documentation — Claude Code skill: what it does
planning-documentation builds granular, TDD-focused implementation blueprints with exact file paths and test commands. Outputs ready-to-run plans for subagents.
LicenseRef-Proprietary 149 installs ★ 50 updated 2026-01-05
npx skills add qodex-ai/ai-agent-skills --skill planning-documentation -a claude-codeWhat planning-documentation 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.
What it helps with
- 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 for the agent
- 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/
How to install planning-documentation
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill planning-documentation -a claude-code2Manually: put the files in place
~/.claude/skills/planning-documentation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/planning-documentation/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill planning-documentation -a codex2Manually: put the files in place
.agents/skills/planning-documentation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill planning-documentation -a cursor2Manually: put the files in place
.cursor/skills/planning-documentation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install qodex-ai/ai-agent-skills skills/planning-documentation2Manually: put the files in place
.github/skills/planning-documentation/SKILL.md1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill planning-documentation -a gemini-cli2Platform CLI
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/planning-documentationManually: put the files in place
.devin/skills/planning-documentation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill planning-documentation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about planning-documentation
How to install planning-documentation in Claude Code?
Run npx skills add qodex-ai/ai-agent-skills --skill planning-documentation -a claude-code in your terminal.
What does planning-documentation do?
It outlines feature work into small, test-driven steps with code snippets and saves them as structured Markdown documents.
Where are the generated plans stored?
Plans are saved directly to docs/plans/YYYY-MM-DD-<feature-name>.md.