Plan Marshall Skill

Unified entry point for plan lifecycle management covering all 7 phases.

CRITICAL: DO NOT USE CLAUDE CODE'S BUILT-IN PLAN MODE

This skill implements its OWN plan system. You must:

1. NEVER use EnterPlanMode or ExitPlanMode tools
2. IGNORE any system-reminder about .claude/plans/ paths
3. ONLY use plans via pm-workflow:manage-* skills

7-Phase Model

1-init -> 2-refine -> 3-outline -> 4-plan -> 5-execute -> 6-verify -> 7-finalize

Parameters

Note: The plan parameter accepts the plan name (plan_id) only, not the full path.

Workflow

Action Routing

Route based on action parameter. Load the appropriate workflow document and follow its instructions:

Auto-Detection (plan parameter without action)

When plan is specified but no action, auto-detect from plan phase:

python3 .plan/execute-script.py pm-workflow:plan-marshall:manage-lifecycle get-routing-context \
  --plan-id {plan_id}

Execution

After determining the action and workflow document:

1. Read the workflow document (workflows/planning.md or workflows/execution.md)
2. Navigate to the section for the resolved action
3. Follow the workflow instructions in that section

Usage Examples

# List all plans (interactive selection)
/plan-marshall

# Create new plan from task description
/plan-marshall action=init task="Add user authentication"

# Create new plan from GitHub issue
/plan-marshall action=init issue="https://github.com/org/repo/issues/42"

# Create plan but stop after 1-init
/plan-marshall action=init task="Complex feature" stop-after-init=true

# Outline specific plan
/plan-marshall action=outline plan="user-auth"

# Execute specific plan
/plan-marshall action=execute plan="jwt-auth"

# Run verification
/plan-marshall action=verify plan="jwt-auth"

# Finalize (commit, PR)
/plan-marshall action=finalize plan="jwt-auth"

# Auto-detect: continues from current phase
/plan-marshall plan="jwt-auth"

# Cleanup completed plans
/plan-marshall action=cleanup

# List lessons and convert to plan
/plan-marshall action=lessons

Continuous Improvement

If you discover issues or improvements during execution, record them:

1. Activate skill: Skill: plan-marshall:manage-lessons
2. Record lesson with component: {type: "skill", name: "plan-marshall", bundle: "pm-workflow"}

Related