run-phase

Orchestrate a development phase with persistent state and parallel agent dispatch.

1|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/n0rvyn/indie-toolkit --skill run-phase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-phase
Source: https://github.com/n0rvyn/indie-toolkit/tree/main/dev-workflow/skills/run-phase
Command: npx skills add https://github.com/n0rvyn/indie-toolkit --skill run-phase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates the plan-execute-review cycle for one phase of a development guide, enabling structured, stateful workflow across multiple agents and sessions.

Core Features & Use Cases

  • Orchestrates one development phase from scope confirmation to phase completion, including planning, verification, execution, testing, and review.
  • Maintains a persistent state file (.claude/dev-workflow-state.yml) to resume work after interruptions and crashes.
  • Dispatches specialized agents in parallel (Opus, Sonnet, and UI/design reviewers) to perform judgment, execution, and validation tasks.
  • Generates phase-specific plan artifacts (docs/06-plans/...) and tracks progress across steps.
  • Supports scope checks, UX alignment (via design docs), and integration with design crystals when available.

Quick Start

Start by loading the dev-guide, confirm the first phase, and initiate the plan-execute-review cycle for that phase.

Frequently Asked Questions about run-phase

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

FAQPage Schema
How do I coordinate a multi-phase development workflow across multiple agents?

Multi-phase development workflows are coordinated by orchestrating plan, execution, and review steps with persistent state. This approach dispatches specialized agents in parallel, enforcing safety checks and state persistence in a YAML file before phase completion.

How does persistent state management work for development workflows interrupted by session crashes?

Persistent state management for interrupted development workflows works by tracking progress in a .claude/dev-workflow-state.yml file. This mechanism maintains the current phase, step, and execution context, enabling work to resume after crashes or session interruptions.

What is the best way to structure a plan-execute-review cycle for a single development phase?

The best way to structure a plan-execute-review cycle is by orchestrating it from scope confirmation to phase completion. This includes generating phase-specific plan artifacts, executing tasks via parallel agents, and performing mandatory verification, testing, and reviews.

Can I use parallel agent dispatch to handle execution and validation tasks simultaneously?

Yes, you can use parallel agent dispatch to handle execution and validation tasks simultaneously. The workflow dispatches specialized agents, such as Opus for judgment, Sonnet for execution, and UI reviewers for design validation, concurrently within the same phase.

Do I need a development guide loaded to start a phase-based workflow?

Yes, you need a development guide loaded to start a phase-based workflow. You begin by loading the dev-guide, confirming the first phase scope, and then initiating the plan-execute-review cycle for that specific phase.

When should I not use a stateful orchestration approach for development phases?

You should not use stateful orchestration for development phases when your project lacks defined design docs or requires no multi-agent coordination. The approach enforces scope checks, UX alignment, and safety checks that may be excessive for simple, single-agent tasks.