kata-complete-milestone

Archives ROADMAP and REQUIREMENTS, updates PROJECT and STATE, and tags a release.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/gannonh/kata-orchestrator --skill kata-complete-milestone
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kata-complete-milestone
Source: https://github.com/gannonh/kata-orchestrator/tree/main/skills/kata-complete-milestone
Command: npx skills add https://github.com/gannonh/kata-orchestrator --skill kata-complete-milestone

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures a consistent, auditable archive of completed milestones, updates key planning artifacts, and readies the project for the next cycle.

Core Features & Use Cases

  • Archive completed milestones to .planning/milestones/vX.Y-ROADMAP.md and .planning/milestones/vX.Y-REQUIREMENTS.md.
  • Evolve ROADMAP.md and PROJECT.md to reflect shipped state and prepare for the next milestone.
  • Integrate optional release workflows, changelog updates, and GitHub milestone management to streamline delivery.

Quick Start

Complete a milestone using your standard process, then review the resulting archive files and repository state. Verify ROADMAP.md has been collapsed to a one-line summary and that the latest milestone is reflected in MILESTONES.md.

Frequently Asked Questions about kata-complete-milestone

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

FAQPage Schema
How do I automate milestone archiving for a shipped release?

Automate milestone archiving by moving ROADMAP and REQUIREMENTS files to a .planning/milestones directory, updating PROJECT and STATE files, and tagging a release. This ensures a consistent, auditable archive of completed milestones while readying the project for the next cycle.

How does milestone completion integrate with changelog and GitHub releases?

Milestone completion integrates with changelog and GitHub releases by applying an end-to-end workflow that updates changelog entries and manages GitHub milestone states. Optional release workflows streamline delivery alongside the archival of planning artifacts.

Can I enforce a human review gate before committing milestone changes?

You can enforce a human review gate before committing milestone changes. The workflow supports optional release checks, audits, and human review gates to ensure quality and accuracy before finalizing archival and repository updates.

What is the best way to update ROADMAP.md after a milestone is shipped?

The best way to update ROADMAP.md after shipping is to collapse it into a one-line summary reflecting the shipped state. The latest milestone is then recorded in MILESTONES.md to prepare the project for the next development cycle.

Do I need external dependencies to manage project state and milestone archival?

No external dependencies are required to manage project state and milestone archival. The workflow operates autonomously using internal references to archive files, update project states, and tag releases without relying on external packages.