# 10x-plan

10x-plan guides Claude Code through an iterative codebase investigation to create technical implementation plans.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 267 repo stars
- Author: przeprogramowani
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/przeprogramowani/ai-rules-builder/tree/HEAD/.claude/commands/10x-plan.md
- Updated: 2026-02-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/10x-plan

## What it does

The command turns feature planning into a multi-phase technical audit. It reads ticket files in full, inspects current code using background research agents, and questions ambiguities before any code changes begin. If you correct an assumption, the assistant verifies it in the filesystem rather than blindly agreeing.

After analyzing patterns, the workflow outlines design options with trade-offs and draft milestones. The finalized spec goes to `thoughts/shared/plans/` as a dated Markdown document. Execution relies on specialized sub-tasks like `codebase-locator` and `codebase-analyzer` to map dependencies accurately.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/10x-plan.md` — Call it with /10x-plan. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/10x-plan.md` — Call it with /prompts:10x-plan. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/10x-plan.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/10x-plan.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/przeprogramowani/ai-rules-builder/tree/HEAD/.claude/commands/10x-plan.md

## When to use it
- map existing source code before starting complex feature work
- cross-reference ticket requirements against current project reality
- investigate codebase patterns through parallel sub-agent tasks
- write structured technical specifications in Markdown

## Example prompts
- /10x-plan thoughts/allison/tickets/eng_1234.md
- /10x-plan Create an implementation plan for user session handling
- /10x-plan Plan background worker migration based on current queue logic

## Similar
- [tlc-plan](https://affpapa.org/en/nevibecode/skills/tlc-plan.md) — skill · ★ 7191 repo stars
- [plan-agent](https://affpapa.org/en/nevibecode/agents/plan-agent.md) — subagent · ★ 3951 repo stars
- [interview-me](https://affpapa.org/en/nevibecode/skills/interview-me.md) — skill · 73400 installs
- [openspec-propose](https://affpapa.org/en/nevibecode/skills/openspec-propose.md) — skill · 4600 installs
- [brainstorming](https://affpapa.org/en/nevibecode/skills/sickn33-brainstorming.md) — skill · 2400 installs
- [prd](https://affpapa.org/en/nevibecode/skills/snarktank-prd.md) — skill · 1500 installs

From the same set: [przeprogramowani/ai-rules-builder](https://affpapa.org/en/nevibecode/by/przeprogramowani/ai-rules-builder.md) — 24 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
