runner

Execute plan.md phases with per-task worktree isolation and sequential commits.

1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/SeoJaeWan/try-claude-code --skill runner-seojaewan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: runner
Source: https://github.com/SeoJaeWan/try-claude-code/tree/main/plugin/develop/skills/runner
Command: npx skills add https://github.com/SeoJaeWan/try-claude-code --skill runner-seojaewan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deterministic multi-phase plan execution requires strict isolation, per-phase commits, and careful gating to keep the main branch stable while tasks progress.

Core Features & Use Cases

  • Per-task worktree isolation: one worktree per task ensures lifecycle isolation.
  • Sequential phase commits: each phase is committed before moving to the next.
  • Per-phase user approvals and final merge decision: gating by human review (Stop gate and dev-review).
  • HEAD stays on base branch: base remains stable, worktrees cleaned after completion.
  • Auditability and reproducibility: artifacts stored in plans/ and reviews.

Quick Start

Create a per-task worktree and execute the ordered phases in plans/{task-name}/plan.md, prompting for approval after each phase and at the final merge decision.

Frequently Asked Questions about runner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I execute a multi-phase plan with worktree isolation in git?

Multi-phase plan execution uses task-level git worktree isolation to run ordered phases from plan.md, committing sequentially while keeping HEAD on the base branch. Each phase requires user approval before proceeding to the next step.

What is the best way to keep my base branch stable during multi-phase development?

Keep your base branch stable by executing tasks in isolated git worktrees and keeping HEAD on the base branch. Worktrees provide lifecycle isolation, and per-phase commits ensure progress is tracked without directly modifying the main branch.

How do I add mandatory user approvals between git workflow phases?

Mandatory user approvals are added through dev-review gating and Stop gates after each sequential phase commit. The orchestration pauses execution, prompts for human review, and requires explicit final merge decisions before completing the task.

Can I use per-task worktrees to manage multiple plan phases independently?

Yes, per-task worktree isolation assigns one worktree per task to ensure lifecycle isolation. This allows ordered phases in plan.md to execute independently, with artifacts stored in plans/ and reviews/ for auditability and reproducibility.

Does multi-phase plan orchestration support strict commit contracts for reproducibility?

Multi-phase plan orchestration uses a strict commit contract to ensure auditable and repeatable results. Sequential phase commits, dev-review gating, and stored artifacts in plans/ and reviews/ directories guarantee deterministic execution and traceable outcomes.

When should I not use isolated worktrees for plan execution?

Isolated worktrees for plan execution are not suitable for simple, single-step tasks that do not require phase-level commits or human approval gates. Overhead from worktree management and strict commit contracts outweighs benefits for rapid, non-sequential development workflows.