init-milestone-skill

What problem does it solve?

It removes the risk and overhead of manually setting up milestone pipelines by validating milestone specs, enforcing unique/consistent dependencies, and atomically writing the correct milestone artifact and backlog entry.

Core Features & Use Cases

• Milestone creation and upsert: Creates a new milestone artifact or updates an existing one (with latest-override semantics) without touching version/release state.
• Dependency and activation guardrails: Validates depends_on_milestones against live history and detects circular dependencies, then computes planned vs active using activation intent/rules while enforcing that only one milestone can be active at a time.
• Signal/acceptance handling for worktrack appends: When appending worktracks to a goal-driven milestone, performs coverage verdicts (fully/partially/not covered) and requires programmer confirmation before proceeding to prevent scope creep.

Quick Start

Use init-milestone-skill when your harness controller needs to create or upsert a new Milestone under RepoScope.Init by providing the milestone title, purpose, worktrack list, priority, dependency list (if any), and activation rules, then confirm the generated milestone brief before any write/activation occurs.