moonshot-phase-runner

Automate phase-by-phase Moonshot execution from a master plan.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/munlucky/claude-settings --skill moonshot-phase-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moonshot-phase-runner
Source: https://github.com/munlucky/claude-settings/tree/main/.claude/skills/moonshot-phase-runner
Command: npx skills add https://github.com/munlucky/claude-settings --skill moonshot-phase-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the coordination of phase-by-phase implementation based on a master plan, reducing manual overhead and errors during project execution.

Core Features & Use Cases

  • Plan validation: verifies master plan presence and phase documents.
  • Status tracking: generates and maintains phase-status.yaml to reflect progress.
  • Uncertainty resolution: supports optional Q&A or autonomous mode to confirm plans before execution.
  • Execution preparation: outputs ready-to-run commands to start agent loops in a separate terminal.

Quick Start

Run the moonshot-phase-runner with your plan directory to generate phase state and prepare the run command.

Frequently Asked Questions about moonshot-phase-runner

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

FAQPage Schema
How do I automate phase-by-phase execution of a master project plan?

You can automate phase-by-phase execution by validating a master plan and per-phase documents to coordinate status tracking and execution preparation. This generates a phase-status.yaml file and outputs a ready-to-run command for agent loops.

What is phase-driven workflow orchestration for Moonshot plans?

Phase-driven workflow orchestration coordinates validation, status tracking, and uncertainty handling across project phases. It maintains a master plan with per-phase documents to reduce manual overhead and errors during execution.

How do I generate a phase-status.yaml file for project status tracking?

To generate a phase-status.yaml file, run the phase runner with your plan directory. It automatically verifies requirements presence and creates the status file to reflect ongoing progress across phases.

Can I resolve plan uncertainties autonomously before starting execution?

Yes, you can resolve uncertainties either through an optional Q&A flow or by using autonomous mode. This confirms the plan details before execution and prepares the final run command for the agent loop.

Do I need a master plan and separate phase documents to use automated execution?

Yes, automated execution applies to projects that maintain a master plan alongside per-phase documents. These documents are required to verify requirements and generate the phase-status.yaml file for tracking.

How do I prepare a ready-to-run command for agent-loop.sh?

Preparing a ready-to-run command for agent-loop.sh involves validating your master plan and resolving uncertainties through Q&A or autonomous mode. The runner then outputs the command to start execution in a separate terminal.