~aod-plan

Plan Stage Orchestrator Skill

Purpose

Orchestrates the full Plan stage by running spec → project-plan → tasks in sequence. After each sub-step completes and its governance review passes (APPROVED), the orchestrator automatically advances to the next sub-step. If any review returns CHANGES_REQUESTED or BLOCKED, the orchestrator stops and reports the rejection so the user can fix and re-run /aod.plan to resume.

With 1M context, all three artifacts and their reviews fit comfortably in a single session.

How It Works

Step 1: Determine Feature Context

1. Get branch: git branch --show-current → extract NNN prefix
2. If on main and a PRD exists (e.g., docs/product/02_PRD/{NNN}-*.md), automatically create the feature branch (git checkout -b {NNN}-{kebab-name}) per git workflow rules. Do NOT ask the user — feature branches are mandatory, not optional.
3. Open Draft PR: After creating the branch, push it and open a draft PR so work is visible early:

   git commit --allow-empty -m "chore({NNN}): open feature branch"
   git push -u origin {NNN}-{kebab-name}
   gh pr create --draft \
     --title "{NNN}: {Feature Name}" \
     --body "Draft PR for feature {NNN}. Opened automatically at plan stage."
   

   If gh is unavailable, skip silently (graceful degradation). Store the PR number for later use.
4. Derive specs directory: specs/{NNN}-*/
5. If no specs directory found, check .aod/spec.md as fallback
6. If no feature context found: warn and suggest /aod.define first

Step 2: Read Artifact States

For each artifact (spec.md, plan.md, tasks.md), determine its approval status:

1. Check file existence — if file cannot be read (missing, permissions, encoding), treat as "does not exist"
2. Parse YAML frontmatter — extract the triad: block between --- delimiters
3. Extract sign-off status — read triad.{role}_signoff.status for the required reviewers

Step 3: Evaluate Frontmatter (with error handling)