Run Plan

VerifiedCaution

Executes a continuous plan by following a skill sequence step-by-step. Reads task_plan.md and deterministically executes each skill with error handling and progress tracking.

Sby Skills Guide Bot
DevelopmentIntermediate
306/2/2026
Claude Code
#run-plan#deterministic#skill-sequence#continuous-plan#task-execution

Recommended for

Our review

Executes a continuous plan by following a predefined skill sequence in task_plan.md in a deterministic manner.

Strengths

  • Step-by-step deterministic execution without manual intervention.
  • Error handling with logging and recovery protocols.
  • Integration with progress tracking and beads.
  • Automatic status updates for each step in the plan.

Limitations

  • Requires a plan previously created by continuous-planner.
  • Does not handle complex dependencies between non-sequential steps.
  • Rigid plan format (mandatory Skill Sequence table).
When to use it

Use this skill after generating a continuous plan to automatically execute all steps in order.

When not to use it

Avoid using it for ad-hoc tasks or when the plan is not yet finalized.

Security analysis

Caution
Quality score80/100

The skill is designed to execute a sequence of skills from a task_plan.md file. While it does not itself contain dangerous commands, it enables execution of arbitrary skills including Bash, which could be risky if the plan source is untrusted. It lacks safety guards, but is intended for user-defined plans.

Findings
  • This skill orchestrates execution of other skills, including Bash, without built-in validation of the skill sequence or its content. A malicious or accidentally destructive skill in the plan could cause harm.

Examples

Run default plan
Execute the continuous plan from task_plan.md.
Run plan from custom path
Run the plan located at .claude/continuous/task_plan.md.
Re-run failed plan
Execute the skill sequence again, handling any previously failed steps.

name: run-plan description: "Execute a continuous plan deterministically by following the skill sequence. Use after continuous-planner creates a plan with skill sequences. Reads task_plan.md and executes each skill step by step." disable-model-invocation: true allowed-tools: Read, Write, Edit, Bash, Skill

Run Plan - Deterministic Skill Execution

Execute continuous plans by following the skill sequence step-by-step.

When To Use

After creating a continuous plan with continuous-planner, run this to execute the skill sequence deterministically.

How It Works

  1. Read task_plan.md to get the skill sequence
  2. For each skill in sequence:
    • Check if status is "⏸️ Pending"
    • If pending, execute the skill
    • Update status in task_plan.md
    • Update progress.md with results
  3. Handle failures with recovery protocols
  4. Mark plan complete when all skills executed

Skill Sequence Format

The task_plan.md should have a Skill Sequence table:

| Step | Skill | Purpose | Input | Output | Status |
|------|-------|---------|-------|--------|--------|
| 1 | front-door | Interview/triage | User request | requirements | ⏸️ Pending |
| 2 | api-designer | Design API | requirements | api_spec | ⏸️ Pending |
| 3 | implement-plan | Execute | api_spec | Complete | ⏸️ Pending |

Execution Flow

┌─────────────────────────────────────────┐
│  1. Read task_plan.md                   │
│  2. Parse Skill Sequence table          │
│  3. For each pending skill:             │
│     a. Invoke skill with input          │
│     b. Capture output                   │
│     c. Update findings.md               │
│     d. Update progress.md               │
│     e. Update skill status in plan      │
│  4. Update beads                       │
│  5. Report completion                   │
└─────────────────────────────────────────┘

Error Handling

If a skill fails:

  1. Log error to findings.md
  2. Check failure-recovery skill for protocols
  3. Update skill status to "❌ Failed"
  4. Ask user for guidance

Beads Integration

Each skill execution is tracked as a bead task:

  • Plan epic: continuous-[project-name]
  • Skill tasks: Created as subtasks
  • Completion: Mark beads as complete

Example Usage

# From project directory with continuous plan
/run-plan

# Or specify plan location
/run-plan .claude/continuous/task_plan.md

Output

After execution:

  • task_plan.md: All skills marked complete or failed
  • findings.md: Research, errors, discoveries
  • progress.md: Execution log with checkpoints
  • beads: Tasks marked complete

Keywords

run plan, execute plan, deterministic, skill sequence, continuous plan, task_plan.md

Related skills