plan-execution-skill

What I do

I provide automatic PLAN.md execution with integrated progress tracking:

1. Detect Current PLAN: Extract branch name and find matching PLAN file
2. Parse Plan Structure: Read phases, tasks, and acceptance criteria
3. Execute Phases: Work through plan tasks in order
4. Auto-Update Progress: Invoke plan-updater after each phase completes
5. Track Completion: Mark tasks complete and commit progress automatically

When to use me

Use this skill when:

• You say "implement the plan" or "execute the plan"
• Working on a branch with a PLAN.md file
• Want automatic progress tracking during development
• Need systematic phase-by-phase execution

Trigger phrases:

• "implement the plan"
• "execute the plan"
• "work on the plan"
• "continue with the plan"
• "resume plan execution"

Subagents That Should Use This Skill

Subagent	When to Invoke
Any subagent	When user says "implement the plan"

Core Workflow

Step 0: Verbatim playbook discipline (anti-drift)

Before executing, transcribe the matched PLAN's steps into the session todolist VERBATIM, ahead of any task-specific todos:

• Copy plan steps word-for-word — no paraphrasing, reordering, or merging during transcription.
• A step you decide to skip STAYS in the todolist, annotated skip: <reason>. Silently deleting it is drift.
• Task-specific todos are appended AFTER the transcribed plan steps, never interleaved.
• At each phase boundary, diff the todolist against the PLAN file: every deviation must be a visible skip: entry or a completed step.

Step 1: Detect Current PLAN

Identify the PLAN file for the current branch:

BRANCH_NAME=$(git branch --show-current)

# GitHub pattern: GIT-123
if [[ "$BRANCH_NAME" =~ ^GIT-([0-9]+)$ ]]; then
  ISSUE_NUM="${BASH_REMATCH[1]}"
  PLAN_FILE="PLANS/PLAN-GIT-${ISSUE_NUM}.md"
  PLAN_TYPE="github"
fi

# JIRA pattern: PROJECT-123
if [[ "$BRANCH_NAME" =~ ^([A-Z]+-[0-9]+)$ ]]; then
  PLAN_ID="${BASH_REMATCH[1]}"
  PLAN_FILE="PLANS/PLAN-${PLAN_ID}.md"
  PLAN_TYPE="jira"
fi

if [ ! -f "$PLAN_FILE" ]; then
  echo "No PLAN file found for branch: $BRANCH_NAME"
  echo "Expected: $PLAN_FILE"
  exit 1
fi

echo "Found PLAN: $PLAN_FILE"