diff --git a/docs/CREATE-PLAN.md b/docs/CREATE-PLAN.md index 393785a..0404b19 100644 --- a/docs/CREATE-PLAN.md +++ b/docs/CREATE-PLAN.md @@ -10,6 +10,8 @@ Create structured implementation plans with milestone and story tracking. - Required dependencies: - `brainstorming` - `writing-plans` +- For Codex, Superpowers runner must exist at: + - `~/.codex/superpowers/.codex/superpowers-codex` If dependencies are missing, stop and return: @@ -51,6 +53,21 @@ 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-/`. diff --git a/skills/create-plan/codex/SKILL.md b/skills/create-plan/codex/SKILL.md index e92d545..61eeb27 100644 --- a/skills/create-plan/codex/SKILL.md +++ b/skills/create-plan/codex/SKILL.md @@ -9,21 +9,34 @@ Create and maintain a local plan folder under `ai_plan/` at project root. ## Prerequisite Check (MANDATORY) -This skill depends on Superpowers planning skills. Before proceeding, verify required dependencies exist. +This Codex variant depends on Superpowers and must use explicit Superpowers CLI commands. Required: - Superpowers repo: `https://github.com/obra/superpowers` +- Codex Superpowers runner: `~/.codex/superpowers/.codex/superpowers-codex` - `brainstorming` skill - `writing-plans` skill +Verify command availability before proceeding: + +```bash +test -x ~/.codex/superpowers/.codex/superpowers-codex +~/.codex/superpowers/.codex/superpowers-codex --help +``` + If any dependency is missing, stop immediately and return: -"Missing dependency: Superpowers planning skills are required (`brainstorming`, `writing-plans`). Install from https://github.com/obra/superpowers, then retry." +"Missing dependency: Superpowers Codex skills are required (`brainstorming`, `writing-plans`). Install from https://github.com/obra/superpowers, then retry." ## Process -### Phase 1: Bootstrap -- Invoke Codex superpowers bootstrap and planning skills when available. +### Phase 1: Bootstrap Superpowers (REQUIRED) + +Run this exact command: + +```bash +~/.codex/superpowers/.codex/superpowers-codex bootstrap +``` ### Phase 2: Analyze - Explore the codebase and existing patterns. @@ -32,13 +45,25 @@ If any dependency is missing, stop immediately and return: - Ask questions one at a time until user says ready. - Confirm scope, constraints, success criteria, dependencies. -### Phase 4: Design -- Use brainstorming workflow. -- Propose 2-3 approaches and recommend one. +### Phase 4: Design (REQUIRED SUB-SKILL) -### Phase 5: Plan -- Use writing-plans workflow. -- Break into milestones and bite-sized stories. +Run this exact command: + +```bash +~/.codex/superpowers/.codex/superpowers-codex use-skill brainstorming +``` + +Then propose 2-3 approaches and recommend one. + +### Phase 5: Plan (REQUIRED SUB-SKILL) + +Run this exact command: + +```bash +~/.codex/superpowers/.codex/superpowers-codex use-skill writing-plans +``` + +Then break work into milestones and bite-sized stories. ### Phase 6: Initialize Local Plan Workspace (MANDATORY)