plan-milestone

Plans milestones by drafting code-anchored issues and creating them in the issue tracker.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough project theme into a milestone of well-scoped, dependency-ordered issues is error-prone: criteria end up vague, dependencies point at wrong issue numbers, and items without an existing code precedent get forced into the plan. This Skill interviews the user about scope, classifies each backlog item by whether a precedent exists in the codebase, and only then creates labels, the milestone, and issues in the tracker. ## Core Features & Use Cases - Precedent-based backlog classification: Each backlog item is tested against the repository for an existing code pattern to extend; items without precedent stay in the backlog for a future wave instead of becoming vague issues. - Interactive scope interview and draft confirmation: The user confirms scope boundaries, the draft issue table, and any new labels before anything is written to the tracker. - Sequential tracker creation: Creates missing labels, the milestone (or a new wave in an existing one), then issues one by one so dependency references point at real issue numbers, via GitHub scripts or Gitea MCP tools. - Use Case: You want to build a UI kit and need it broken into tracker issues. The Skill interviews you on scope, checks which items have code precedents, drafts anchored issues with topological ordering, and creates the milestone after your approval. ## Quick Start Ask the assistant to plan a milestone for your topic, for example: plan a milestone for the UI kit and break it into issues.

Frequently Asked Questions about plan-milestone

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

FAQPage Schema
How do I break a large feature into milestone issues?

Invoke the skill with the milestone topic; it interviews you about scope, tests each backlog item for an existing code precedent, and drafts issues with criteria anchored in specific files. After you confirm the draft, it creates labels, the milestone, and issues sequentially in the tracker.

What happens to backlog items without a code precedent?

Items without a precedent in the codebase are not turned into issues in the current wave. They remain in the backlog and are reported with a reason, so the milestone only contains issues whose criteria are anchored in verifiable code.

Does plan-milestone work with GitHub and Gitea?

Yes. The skill reads the Forge section of the project's CONTRIBUTING.md to select the tracker. On GitHub it calls helper shell scripts with an explicit -R owner/repo argument; on Gitea it loads deferred MCP tools via ToolSearch.

Can I add a new wave of issues to an existing milestone?

Yes. Pass the existing milestone name and the skill lists its current issues, computes only the new increment, and adds issues to that milestone instead of recreating it. If the name does not match, it asks which milestone was meant.

Why does the skill refuse to plan without project configuration?

It requires the Workflow section in CONTRIBUTING.md for the forge type, allowed labels, and issue language. Without it, guessed label taxonomies would break downstream routing in run-milestone, so it stops and suggests running init-workflow first.

When should I use file-issue instead of plan-milestone?

Use file-issue for a single ad hoc issue outside any milestone. plan-milestone is for decomposing a larger theme into multiple dependency-ordered issues and deliberately does not create standalone notes for unprecedented items.