milestone-runner

Coordinate milestone execution state for multi-phase AI development workflows.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/voidreader/band-of-mercenaries --skill milestone-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: milestone-runner
Source: https://github.com/voidreader/band-of-mercenaries/tree/main/.agents/skills/milestone-runner
Command: npx skills add https://github.com/voidreader/band-of-mercenaries --skill milestone-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams manage complex AI-assisted milestone work without losing progress, skipping approvals, or confusing outputs across phases.

Core Features & Use Cases

  • Phase-Oriented Planning: Breaks a milestone into content design, balance design, data generation, and development specification steps.
  • Resume-Friendly State Tracking: Records progress in a markdown state file so interrupted work can continue from the correct checkpoint.
  • Controlled Handoff Workflow: Guides users to run the right follow-up skill for each phase and wait for approval before moving on.
  • Use Case: A developer can use it to run a roadmap milestone from start to finish while keeping planning, generated files, and approvals organized.

Quick Start

Tell the assistant to start milestone-runner for a chosen milestone and wait for each approval checkpoint before continuing.

Frequently Asked Questions about milestone-runner

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

FAQPage Schema
How do I track progress for multi-phase AI development workflows without losing state during interruptions?

Multi-phase AI development workflows can be tracked by recording execution state in a markdown file, allowing interrupted runs to resume from the correct checkpoint. This approach validates existing files before continuing to ensure progress is maintained.

What is the best way to enforce user approval checkpoints during milestone planning and spec writing?

Enforcing user approval checkpoints during milestone planning requires a controlled handoff workflow that guides users to wait for approval before moving to the next phase. This prevents skipping reviews across content design and balance tuning steps.

Can I resume roadmap milestone execution from a specific phase if generated artifacts are already mapped?

Yes, roadmap milestone execution supports resume mode by validating existing generated artifacts against planned outputs. The state tracking mechanism maps files to planned outputs and checks them before continuing from the correct checkpoint.

Does milestone execution support optional phase skips for content design and data generation steps?

Yes, milestone execution supports optional phase skips for content design, balance tuning, data generation, and specification writing. The workflow coordinates these phases while maintaining a markdown state file to track which steps are skipped or completed.

How do I map generated artifacts to planned outputs across multiple milestone phases?

Generated artifacts are mapped to planned outputs by coordinating milestone execution state across all phases. The workflow maintains a markdown state file that tracks file generation, enforces approval checkpoints, and validates outputs before phase transitions.

What are the limitations of using markdown state files for workflow orchestration in roadmap-driven development?

Markdown state files for workflow orchestration rely on manual checkpoint validation and user approval gates, which means they cannot auto-recover from corrupted states or bypass required approval steps without explicit user interaction during milestone execution.