gsd-complete-milestone

Archive milestone artifacts and tag releases in version control.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/ev3rlit/magam-canonical-archive --skill gsd-complete-milestone-ev3rlit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-complete-milestone
Source: https://github.com/ev3rlit/magam-canonical-archive/tree/main/.codex/skills/gsd-complete-milestone
Command: npx skills add https://github.com/ev3rlit/magam-canonical-archive --skill gsd-complete-milestone-ev3rlit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the complete milestone archival workflow to ensure consistent records, reduce manual toil, and prep for the next milestone.

Core Features & Use Cases

  • Audit readiness and verification across milestones to ensure all required artifacts exist.
  • Generate and archive milestone artifacts (ROADMAP.md, REQUIREMENTS.md, and related summaries) under .planning/milestones.
  • Update PROJECT.md to reflect the current state and the planned next milestone, and tag the release in version control.

Quick Start

Invoke the skill with $gsd-complete-milestone and specify the target version when prompted.

Frequently Asked Questions about gsd-complete-milestone

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

FAQPage Schema
How do I automate milestone archival for a software release?

Milestone archival is automated by auditing readiness, generating ROADMAP and REQUIREMENTS summaries under .planning/milestones, updating PROJECT.md, and creating a git tag. This workflow ensures consistent release records and preps the next milestone with minimal manual toil.

What does updating PROJECT.md for a new milestone involve?

Updating PROJECT.md involves reflecting the current milestone state and documenting the planned next milestone. The archival workflow modifies PROJECT.md alongside ROADMAP.md and REQUIREMENTS.md to maintain accurate project tracking after a release.

How do I create a git tag when archiving a milestone release?

Creating a git tag during milestone archival happens automatically by tagging the release as v{{version}}. The workflow commits updated ROADMAP.md, REQUIREMENTS.md, and PROJECT.md changes before applying the version tag.

When do I need to archive ROADMAP and REQUIREMENTS files?

Archiving ROADMAP and REQUIREMENTS files is needed when completing a software milestone release that requires structured records. The process audits milestone readiness, drafts archived versions under .planning/milestones, and prepares artifacts for the next development cycle.

Can I use this milestone archival workflow without dependencies?

Yes, this milestone archival workflow operates without external dependencies. It independently audits milestone readiness, generates archival artifacts, updates project documentation, and tags releases within your existing version control environment.

What is the best way to prepare for the next milestone after a release?

Preparing for the next milestone after a release involves archiving current ROADMAP and REQUIREMENTS documents, updating PROJECT.md with the new planned milestone, and tagging the completed release in version control to establish a clean baseline.