majiayu000 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:
- NEVER use
EnterPlanModeorExitPlanModetools - IGNORE any system-reminder about
.claude/plans/paths - 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
| Parameter | Type | Description |
|---|---|---|
action |
optional | Explicit action: list, init, outline, execute, verify, finalize, cleanup, lessons (default: list) |
task |
optional | Task description for creating new plan |
issue |
optional | GitHub issue URL for creating new plan |
lesson |
optional | Lesson ID to convert to plan |
plan |
optional | Plan name for specific operations (e.g., jwt-auth, not path) |
stop-after-init |
optional | If true, stop after 1-init phase without continuing to 2-refine (default: false) |
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:
| Action | Workflow Document | Description |
|---|---|---|
list (default) |
Read workflows/planning.md |
List all plans |
init |
Read workflows/planning.md |
Create new plan, auto-continue to refine |
outline |
Read workflows/planning.md |
Run outline and plan phases |
cleanup |
Read workflows/planning.md |
Remove completed plans |
lessons |
Read workflows/planning.md |
List and convert lessons |
execute |
Read workflows/execution.md |
Execute implementation tasks |
verify |
Read workflows/execution.md |
Run quality verification |
finalize |
Read workflows/execution.md |
Commit, push, PR |
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}
| Current Phase | Workflow Document | Action |
|---|---|---|
| 1-init | Read workflows/planning.md |
init |
| 2-refine | Read workflows/planning.md |
init (continues refine) |
| 3-outline | Read workflows/planning.md |
outline |
| 4-plan | Read workflows/planning.md |
outline (continues plan) |
| 5-execute | Read workflows/execution.md |
execute |
| 6-verify | Read workflows/execution.md |
verify |
| 7-finalize | Read workflows/execution.md |
finalize |
Execution
After determining the action and workflow document:
- Read the workflow document (
workflows/planning.mdorworkflows/execution.md) - Navigate to the section for the resolved action
- 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:
- Activate skill:
Skill: plan-marshall:manage-lessons - Record lesson with component:
{type: "skill", name: "plan-marshall", bundle: "pm-workflow"}
Related
| Skill | Purpose |
|---|---|
pm-workflow:phase-1-init |
Init phase implementation |
pm-workflow:phase-3-outline |
Outline phase implementation |
pm-workflow:phase-6-verify |
Verify phase implementation |
pm-workflow:phase-7-finalize |
Finalize phase implementation |
pm-workflow:workflow-extension-api |
Extension points for domain customization |
| Agent | Purpose |
|---|---|
pm-workflow:phase-init-agent |
Init phase: creates plan, detects domains |
pm-workflow:task-plan-agent |
Plan phase: creates tasks from deliverables |
pm-dev-java:java-implement-agent |
Java task implementation |
pm-dev-frontend:js-implement-agent |
JavaScript task implementation |