91 lines
2.3 KiB
Markdown
91 lines
2.3 KiB
Markdown
# 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`
|
|
- For Codex, Superpowers runner must exist at:
|
|
- `~/.codex/superpowers/.codex/superpowers-codex`
|
|
|
|
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`
|
|
|
|
For Codex, verify runner:
|
|
|
|
```bash
|
|
test -x ~/.codex/superpowers/.codex/superpowers-codex
|
|
~/.codex/superpowers/.codex/superpowers-codex --help
|
|
```
|
|
|
|
Codex must invoke these explicit commands during planning:
|
|
|
|
```bash
|
|
~/.codex/superpowers/.codex/superpowers-codex bootstrap
|
|
~/.codex/superpowers/.codex/superpowers-codex use-skill brainstorming
|
|
~/.codex/superpowers/.codex/superpowers-codex use-skill writing-plans
|
|
```
|
|
|
|
## 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.
|