What problem does it solve? Planning a milestone across many open issues is error-prone: hidden dependencies, unverified prerequisites, and unbalanced scope lead to milestones that cannot actually be delivered. This Skill discovers repository guidance, roadmap context, milestone history, and issue relationships, then produces a goal-shaped, dependency-ordered milestone proposal. ## Core Features & Use Cases - Dependency graph construction: Collects declared Dependencies, Blocked by, and tracker-native relationships, resolves transitive prerequisites, detects cycles, and classifies each prerequisite into states like closed/satisfied, closed/unverified, or open-outside. - Balanced work selection: Classifies candidates across four axes — business value, usability, known issues, and new needs — and checks capacity against evidence rather than invented estimates. - Approval-gated tracker writes: Planning is read-only by default; creating milestones, assigning issues, or changing relationships requires explicit user approval, with a state refresh before any write. - Use Case: Ask the agent to plan the next sprint for a repository; it inspects open issues and their dependency links, defers blocked work, and returns a milestone proposal with execution order, exit criteria, and explicit exclusions. ## Quick Start Use the plan-milestone skill to analyze the open issues in this repository and propose the next executable milestone in dependency order.
