Install
From within Claude Code, add the marketplace and install the plugin:
/plugin marketplace add cmartinezs/claude-planning-with-ai
/plugin install claude-planning-with-ai@cmartinezs
Or from your terminal:
claude plugin marketplace add cmartinezs/claude-planning-with-ai
claude plugin install claude-planning-with-ai@cmartinezs
To update to the latest version later:
claude plugin update claude-planning-with-ai@cmartinezs
First run
# Scan your project, propose area codes, scaffold .planning/
/plan-init
/plan-init detects your top-level directories, infers the stack (Next.js, Spring Boot, Terraform…), and proposes a short code per area (WB, AP, IN…). Confirm or adjust — then everything is wired up automatically.
Work through the lifecycle
/plan-new 001-user-auth -- Implement JWT authentication
/plan-expand 001-user-auth # INITIAL → EXPANSION (identify scopes)
/plan-atomize 001-user-auth scope-01 # optional: atomic tasks (design + impl + unit tests)
/plan-task 001-user-auth scope-01 task-01 # execute one atomic task
/plan-scope 001-user-auth scope-01 # DEEPENING (execute scope tasks)
/plan-done 001-user-auth scope-01 # mark scope complete
/plan-archive 001-user-auth # audit + move to finished/
Or generate a planning directly from existing stories:
/plan-from-epic 001 path/to/epic/ # 1 story = 1 scope
Why this plugin
- Lifecycle enforcement — INITIAL → EXPANSION → DEEPENING → COMPLETED. No skipping.
- Area-aware traceability — every scope records which directories it touches (
AP, WB, IN…).
- Auto-configured for your project —
/plan-init discovers your structure; you confirm.
- Backlog bridge — convert existing epics/stories into executable plannings in one command.
- Atomic task decomposition —
/plan-atomize turns a scope into session-sized tasks, each with technical design, implementation steps, and unit tests.
- Mid-execution adjustments — enrich, split, or deepen scopes without losing history.
- Self-checking —
/plan-validate audits structure, dependencies, and workflow references at any time.
- Pure markdown — no lock-in, readable in any editor, version-controlled with your code.
Commands at a glance
| Group | Commands |
|---|
| Init | /plan-init · --blank · --force |
| Lifecycle | /plan-new · /plan-expand · /plan-scope · /plan-done · /plan-archive |
| Atomic tasks | /plan-atomize · /plan-task · /plan-task-validate |
| Status / ideas | /plan-status · /plan-validate · /plan-template |
| Backlog | /us-new · /us-enrich · /epic-enrich · /plan-from-epic |
| Adjust | /plan-enrich-epic · /plan-enrich-story · /plan-split-story |
Full flag reference → docs/reference.md
Docs
Contributing
See CONTRIBUTING.md. The plugin is entirely markdown — no build step, no test runner. The fastest way to understand the architecture is docs/developer-guide.md.
License
MIT — free to use, fork, and modify. Attribution required.
Made by Carlos Martínez.
