review-milestone

Reviews a planned milestone's issues against templates, code precedents, and dependency graphs.

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/sagittaras/agentic-workflow --skill review-milestone-sagittaras
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-milestone
Source: https://github.com/sagittaras/agentic-workflow/tree/main/skills/review-milestone
Command: npx skills add https://github.com/sagittaras/agentic-workflow --skill review-milestone-sagittaras

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Planned milestones often contain issues with unverifiable acceptance criteria, broken code references, dependency cycles, or scope contradictions that only surface mid-execution. This Skill independently audits a milestone in a clean context before it runs, catching plan defects while they are still cheap to fix. ## Core Features & Use Cases - Six-dimension audit: Checks issue structure against the shared template, anchors acceptance criteria to real code paths or patterns, validates the dependency graph for cycles and out-of-milestone references, detects overlaps and contradictions between issues, assesses scope fit, and verifies area labels. - Precedent verification: Opens every file or pattern cited in an issue's Reference section and confirms it exists in the repository, flagging criteria anchored only in prose documents as blocking findings. - Severity-graded verdict: Classifies findings as blocking, should-fix, or minor and issues a Sound, Needs attention, or Not ready verdict, then posts the report as a comment on the milestone's lowest-numbered issue. - Use Case: After planning a milestone with plan-milestone, run this Skill to confirm every issue is dispatchable before run-milestone starts assigning work to engineering agents. ## Quick Start Ask the assistant to review milestone 3 and confirm it is ready to run.

Frequently Asked Questions about review-milestone

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

FAQPage Schema
How do I review a milestone before running it?

Invoke the Skill with the milestone name or number, for example by asking to review milestone 3. It reads all issues in the milestone, checks them against six audit dimensions, and posts a verdict report as a comment on the lowest-numbered issue.

What does the milestone review check in each issue?

It checks body structure against the shared issue template, verifies acceptance criteria are anchored to existing code paths or patterns, validates the dependency graph for cycles and external references, detects contradictions between issues, assesses scope fit, and confirms exactly one valid area label.

Does the milestone review work with GitHub and Gitea?

Yes, it supports both forges. On GitHub it calls bundled gh wrapper scripts with an explicit owner/repo argument, and on Gitea it loads deferred MCP tools for reading milestones and issues and writing the report comment.

Can the review skill fix the problems it finds?

No, it is strictly read-only apart from posting the report comment. Findings include concrete recommendations such as running triage-issue on affected issues, but the reviewer never edits issue bodies, labels, or the milestone itself.

Why does the review fail with exit code 7 or 127?

Exit code 7 means the gh CLI is missing or not authenticated, and 127 means a required plugin script is absent from disk. In both cases the review stops without posting a comment, since it cannot complete without tracker access.

When should I not use milestone review?

Do not use it to build or repair a plan, which is plan-milestone's job, to verify finished implementations, which verify-issue handles, or to review code changes, PRs, or ADRs. It only audits the plan stored in the tracker.