# CREATE-PLAN

## Purpose

Create structured implementation plans with milestone and story tracking.

## Requirements

- Superpowers skills installed from: https://github.com/obra/superpowers
- Required dependencies:
  - `brainstorming`
  - `writing-plans`

If dependencies are missing, stop and return:

"Missing dependency: Superpowers planning skills are required (`brainstorming`, `writing-plans`). Install from https://github.com/obra/superpowers, then retry."

## Install

### Codex

```bash
mkdir -p ~/.codex/skills/create-plan
cp -R skills/create-plan/codex/* ~/.codex/skills/create-plan/
```

### Claude Code

```bash
mkdir -p ~/.claude/skills/create-plan
cp -R skills/create-plan/claude-code/* ~/.claude/skills/create-plan/
```

### OpenCode

```bash
mkdir -p ~/.opencode/skills/create-plan
cp -R skills/create-plan/opencode/* ~/.opencode/skills/create-plan/
```

## Verify Installation

```bash
test -f ~/.codex/skills/create-plan/SKILL.md || true
test -f ~/.claude/skills/create-plan/SKILL.md || true
test -f ~/.opencode/skills/create-plan/SKILL.md || true
```

Verify Superpowers dependencies exist in your agent skills root:

- `.../skills/brainstorming/SKILL.md`
- `.../skills/writing-plans/SKILL.md`

## Key Behavior

- Creates plans under `ai_plan/YYYY-MM-DD-<short-title>/`.
- Ensures `/ai_plan/` is in `.gitignore`.
- Commits `.gitignore` update locally when added.
- Produces:
  - `original-plan.md`
  - `final-transcript.md`
  - `milestone-plan.md`
  - `story-tracker.md`
  - `continuation-runbook.md`

## Execution Workflow Rules

- Read runbook first.
- Complete one milestone at a time.
- Lint/typecheck/test (changed files first).
- Commit (do not push), ask for feedback, apply feedback, commit again.
- Move to next milestone only after approval.
- Ask permission before final push.