[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CHWCM9C3QHV9F74ZDC7740":3,"skill-same:01M6CHWCM9C3QHV9F74ZDC7740":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":31,"linkOnly":32,"markdownContent":33,"markdownBody":34,"frontMatter":35,"refName":48,"commitSha":49,"skillDirectory":50,"forksCount":51,"repositoryHtmlUrl":52,"repositoryHomepageUrl":53,"ownerHtmlUrl":54,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":55,"install":56,"resources":69},"01M6CHWCM9C3QHV9F74ZDC7740","milestone",null,"[ADD v0.11.0] Manage milestones — list, switch, split, rescope, create","MountainUnicorn\u002Fadd","MountainUnicorn","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F199411549?v=4","01M6CHRAWFWD275ANP1S2A0HXC","01M6CHRB0QE1678D913B438SAR",11,"MIT","https:\u002F\u002Fgithub.com\u002FMountainUnicorn\u002Fadd\u002Fblob\u002Fmain\u002Fplugins\u002Fadd\u002Fskills\u002Fmilestone\u002FSKILL.md",[],[5,18,19,20,21,22,23,24,25,26,27,28,29,30],"telemetry","create","Bash","Rules","grep","read","write","edit","list","v0","manage","switch","task","2026-11-10 10:12:30",false,"---\ndescription: \"[ADD v0.11.0] Manage milestones — list, switch, split, rescope, create\"\nargument-hint: \"[--list | --switch \u003Cid> | --split \u003Cid> | --rescope \u003Cid> | --create]\"\nallowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion, Task, TodoWrite]\nreferences: [\"rules\u002Ftelemetry.md\"]\n---\n\n# ADD Milestone Command v0.11.0\n\nManage milestones directly — list status, switch active milestone, split large milestones, rescope features, or create new ones. This is the tactical companion to `\u002Fadd:roadmap` (strategic horizon planning).\n\n---\n\n## Pre-Flight\n\nAll subcommands start here:\n\n1. **Read `.add\u002Fconfig.json`** — extract `maturity.level`, `planning.current_milestone`, `planning.current_cycle`\n   - If not found: abort with \"No ADD project found. Run `\u002Fadd:init` first.\"\n2. **Glob `docs\u002Fmilestones\u002FM*.md`** — discover all milestone files\n3. **Parse each milestone file** — extract:\n   - Status (NOT_STARTED \u002F IN_PROGRESS \u002F COMPLETE)\n   - Goal (first line under `## Goal`)\n   - Features (from Feature Detail table: name, position, spec link)\n   - Success criteria (count checked `[x]` vs total `[ ]`)\n4. **Read `docs\u002Fprd.md` Section 6** — cross-reference horizon placement (Now\u002FNext\u002FLater) from the roadmap table\n5. **Read `.add\u002Fhandoff.md`** if it exists — note any in-progress decisions relevant to milestone changes\n6. **Determine subcommand** from arguments. Default: `--list`\n\n---\n\n## Command: \u002Fmilestone --list (default)\n\nDisplay all milestones with live status. No file modifications.\n\n### Output\n\n```\nMilestones Overview\nActive: {planning.current_milestone or \"None\"}\n\n| # | Milestone | Status | Horizon | Features | Complete | Target |\n|---|-----------|--------|---------|----------|----------|--------|\n| → | M1-foundation | IN_PROGRESS | NOW | 5 | 40% (2\u002F5) | alpha |\n|   | M2-scaling | NOT_STARTED | NEXT | 3 | 0% (0\u002F3) | beta |\n|   | M3-enterprise | NOT_STARTED | LATER | 4 | 0% (0\u002F4) | ga |\n```\n\n- `→` marks the active milestone\n- Completion % = features at VERIFIED or DONE \u002F total features\n- Horizon comes from PRD roadmap table; show \"?\" if milestone not in PRD\n\n### Maturity Scaling\n\n- **POC\u002FAlpha:** Table as shown above\n- **Beta\u002FGA:** Add columns for Appetite Remaining, Risk Count, Cycle Count\n\n---\n\n## Command: \u002Fmilestone --switch \u003Cid>\n\nSwitch the active milestone. Accepts milestone ID like `M2-scaling` or just `M2`.\n\n### Step 1: Resolve Target\n\nFind the milestone file matching the argument:\n- Try `docs\u002Fmilestones\u002F{id}.md` directly\n- Try `docs\u002Fmilestones\u002FM{N}-*.md` glob if only a number given\n- If no match: \"Milestone '{id}' not found. Run `\u002Fadd:milestone --list` to see available milestones.\"\n\n### Step 2: Safety Checks\n\n**If target is COMPLETE:**\n```\nM1-foundation is marked COMPLETE.\nSwitching to a completed milestone is unusual — are you sure?\n(This won't reopen it, but new cycles would target it.)\n```\nAsk via AskUserQuestion. Proceed only if confirmed.\n\n**If current milestone has IN_PROGRESS features:**\n```\nCurrent milestone {name} has features in progress:\n  - Auth Overhaul (IN_PROGRESS, cycle-8)\n  - Session Refresh (PLANNED, cycle-8)\n\nThese will remain in their current state. Continue?\n```\nAsk via AskUserQuestion.\n\n**If active cycle exists** (check `.add\u002Fcycles\u002F` for non-COMPLETE cycles):\n```\nActive cycle {cycle-N} is tied to {current_milestone}.\nSwitching milestones won't close this cycle. You may want to\nrun \u002Fadd:cycle --complete first, or the cycle will be orphaned.\n\nContinue anyway?\n```\n\n### Step 3: Apply Switch\n\n1. Update `.add\u002Fconfig.json`:\n   - Set `planning.current_milestone` to target milestone ID\n   - Scan `.add\u002Fcycles\u002F` for cycles referencing the target milestone; set `planning.current_cycle` to the latest non-COMPLETE one, or `null` if none\n2. If target milestone Status is NOT_STARTED:\n   - Update milestone file: set `Status: IN_PROGRESS`, set `Started: {TODAY}`\n3. Present summary:\n\n```\nSwitched active milestone:\n  From: M1-foundation (IN_PROGRESS)\n  To:   M2-scaling (now IN_PROGRESS)\n\nConfig updated:\n  planning.current_milestone → \"M2-scaling\"\n  planning.current_cycle → null (no existing cycles for M2)\n\nNext: Run \u002Fadd:cycle --plan to plan the first cycle for M2.\n```\n\n---\n\n## Command: \u002Fmilestone --split \u003Cid>\n\nSplit a milestone into two. Interactive interview to redistribute features.\n\n### Step 1: Load and Display\n\nRead the target milestone file. Display:\n```\nSplitting: M3 — Marketplace Ready\nGoal: Build and launch the marketplace feature set\nFeatures (6):\n  1. Product Listings (SPECCED)\n  2. Search & Filter (SHAPED)\n  3. Shopping Cart (SHAPED)\n  4. Checkout Flow (SHAPED)\n  5. Seller Dashboard (SHAPED)\n  6. Order Management (SHAPED)\n```\n\n### Step 2: Interview (5 questions, 1-by-1)\n\n**Q1:** \"What's the split point? List the feature numbers that stay in the original milestone.\"\n→ Captures: feature distribution\n\n**Q2:** \"What's the goal for the NEW milestone? (The original milestone keeps its current goal unless you change it.)\"\n→ Captures: new milestone goal\n\n**Q3:** \"Name for the new milestone? (Suggestion: M{next}-{slug})\"\n→ Captures: new milestone ID and name\n\n**Q4:** \"Appetite for each? Redistribute the original budget or set new ones.\"\n→ Captures: appetite for both milestones\n\n**Q5:** \"Where does the new milestone sit in the roadmap? (Now\u002FNext\u002FLater)\"\n→ Captures: horizon placement\n\n### Step 3: Confirm\n\n```\nSplit plan:\n\nORIGINAL: M3 — Marketplace Ready (keeps 3 features)\n  Features: Product Listings, Search & Filter, Shopping Cart\n  Appetite: 2 weeks\n  Horizon: NOW\n\nNEW: M4 — Seller Experience (gets 3 features)\n  Features: Checkout Flow, Seller Dashboard, Order Management\n  Appetite: 3 weeks\n  Horizon: NEXT\n\nFiles to create\u002Fmodify:\n  - docs\u002Fmilestones\u002FM3-marketplace-ready.md (remove 3 features)\n  - docs\u002Fmilestones\u002FM4-seller-experience.md (NEW)\n  - docs\u002Fprd.md (add M4 to roadmap table)\n  - .add\u002Fconfig.json (no change — M3 stays active)\n\nProceed?\n```\n\n### Step 4: Apply\n\n1. Edit original milestone file — remove redistributed features from Hill Chart and Feature Detail table\n2. Create new milestone file from `${CLAUDE_PLUGIN_ROOT}\u002Ftemplates\u002Fmilestone.md.template` — populate with moved features (keep their current positions), goal, appetite\n3. Update `docs\u002Fprd.md` Section 6 — add new milestone row to roadmap table at the specified horizon\n4. If original milestone was the active one and all its remaining features are DONE, flag it\n\n---\n\n## Command: \u002Fmilestone --rescope \u003Cid>\n\nInteractively move features between milestones. Lighter than split — for fine-tuning scope.\n\n### Step 1: Display Current State\n\nShow features in the target milestone and adjacent milestones:\n\n```\nRescoping: M2 — Scaling (3 features)\n\nM2 features:\n  1. Load Balancer Setup (IN_PROGRESS)\n  2. Database Sharding (SPECCED)\n  3. CDN Integration (SHAPED)\n\nAdjacent milestones:\n  M1 — Foundation (5 features): Auth, Users, Profiles, Settings, Onboarding\n  M3 — Enterprise (4 features): SSO, Audit Log, RBAC, Compliance\n```\n\n### Step 2: Interactive Rescoping\n\nAsk 1-by-1:\n\n**Q1:** \"Move any features OUT of M2? (List numbers, or 'none')\"\n→ If yes: \"Where should each go? (target milestone ID)\"\n\n**Q2:** \"Move any features IN from other milestones? (List as 'M1:Auth, M3:SSO', or 'none')\"\n\n**Q3:** \"Add any brand new features? (Name + brief description, or 'none')\"\n→ If yes, note: \"New features will be added at SHAPED position. Create specs with `\u002Fadd:spec`.\"\n\n**Q4:** \"Should M2's goal or appetite change given the new scope?\"\n\n### Step 3: Confirm and Apply\n\nShow change summary. On confirmation:\n1. Edit source milestone — remove outgoing features\n2. Edit target milestones — add incoming features at their current position\n3. Edit rescoped milestone — add new features at SHAPED, update goal\u002Fappetite if changed\n4. Update PRD Section 6 if milestone scope changed significantly\n5. Append to PRD Section 10 (Revision History): `| {DATE} | {VERSION} | milestone | Rescoped {milestone}: {summary of changes} |`\n6. Update `.add\u002Fhandoff.md` if it exists — note the rescoping for session continuity\n\n---\n\n## Command: \u002Fmilestone --create\n\nCreate a new milestone from scratch with a lightweight interview.\n\n### Interview (scaled by maturity)\n\n**All maturities:**\n\n**Q1:** \"What's the milestone goal? (1-2 sentences — what does 'done' look like?)\"\n\n**Q2:** \"Name? (Suggestion: M{next_number}-{slug})\"\n\n**Q3:** \"Roadmap horizon? (Now \u002F Next \u002F Later)\"\n\n**Alpha+:**\n\n**Q4:** \"Effort appetite? (e.g., '2 weeks', '3 cycles', 'exploratory')\"\n\n**Q5:** \"Known features to include? (Comma-separated names, or 'none yet')\"\n\n**Beta+:**\n\n**Q6:** \"Success criteria? (List 3-5 measurable signals of completion)\"\n\n**Q7:** \"Any dependencies on other milestones or external factors?\"\n\n**Q8:** \"Target maturity level for this milestone? (poc\u002Falpha\u002Fbeta\u002Fga)\"\n\n### Generate\n\n1. Determine next milestone number from existing files\n2. Create `docs\u002Fmilestones\u002FM{N}-{slug}.md` from `${CLAUDE_PLUGIN_ROOT}\u002Ftemplates\u002Fmilestone.md.template`\n3. Populate: Goal, Status: NOT_STARTED, Features (all at SHAPED), Appetite, Success Criteria, Dependencies\n4. Update `docs\u002Fprd.md` Section 6 — add row to roadmap table at the specified horizon\n5. If no active milestone exists, offer: \"No active milestone set. Switch to M{N}? (y\u002Fn)\"\n   - If yes, update `planning.current_milestone` in config\n\n### Present\n\n```\nMilestone created: docs\u002Fmilestones\u002FM{N}-{slug}.md\n\nGoal: {goal}\nHorizon: {horizon}\nFeatures: {count} (all SHAPED)\nAppetite: {appetite}\n\nNext steps:\n  1. Create specs for features: \u002Fadd:spec {feature-name}\n  2. Switch to this milestone: \u002Fadd:milestone --switch M{N}\n  3. Plan first cycle: \u002Fadd:cycle --plan\n```\n\n---\n\n## Error Handling\n\n**No milestones exist:**\n- `--list`: \"No milestones found. Create one with `\u002Fadd:milestone --create` or run `\u002Fadd:init`.\"\n- `--switch\u002F--split\u002F--rescope`: \"Milestone not found.\"\n\n**Milestone file unparseable:**\n- Skip in `--list`, show warning\n- For targeted commands, report: \"Could not parse {file}. Check the file format against the milestone template.\"\n\n**PRD Section 6 missing:**\n- Commands still work (milestones are the source of truth for content)\n- Warn: \"PRD roadmap table not found — milestone files updated but PRD not synced. Run `\u002Fadd:roadmap --edit` to rebuild.\"\n\n---\n\n## Integration\n\n| Skill | Relationship |\n|-------|-------------|\n| `\u002Fadd:cycle` | Reads `planning.current_milestone`. Milestone skill sets this value. |\n| `\u002Fadd:roadmap` | Manages horizon placement. Milestone skill manages content and switching. |\n| `\u002Fadd:spec` | Creates feature specs listed in milestones. |\n| `\u002Fadd:promote` | Milestone completion can trigger promotion readiness. |\n","# ADD Milestone Command v0.11.0\n\nManage milestones directly — list status, switch active milestone, split large milestones, rescope features, or create new ones. This is the tactical companion to `\u002Fadd:roadmap` (strategic horizon planning).\n\n---\n\n## Pre-Flight\n\nAll subcommands start here:\n\n1. **Read `.add\u002Fconfig.json`** — extract `maturity.level`, `planning.current_milestone`, `planning.current_cycle`\n   - If not found: abort with \"No ADD project found. Run `\u002Fadd:init` first.\"\n2. **Glob `docs\u002Fmilestones\u002FM*.md`** — discover all milestone files\n3. **Parse each milestone file** — extract:\n   - Status (NOT_STARTED \u002F IN_PROGRESS \u002F COMPLETE)\n   - Goal (first line under `## Goal`)\n   - Features (from Feature Detail table: name, position, spec link)\n   - Success criteria (count checked `[x]` vs total `[ ]`)\n4. **Read `docs\u002Fprd.md` Section 6** — cross-reference horizon placement (Now\u002FNext\u002FLater) from the roadmap table\n5. **Read `.add\u002Fhandoff.md`** if it exists — note any in-progress decisions relevant to milestone changes\n6. **Determine subcommand** from arguments. Default: `--list`\n\n---\n\n## Command: \u002Fmilestone --list (default)\n\nDisplay all milestones with live status. No file modifications.\n\n### Output\n\n```\nMilestones Overview\nActive: {planning.current_milestone or \"None\"}\n\n| # | Milestone | Status | Horizon | Features | Complete | Target |\n|---|-----------|--------|---------|----------|----------|--------|\n| → | M1-foundation | IN_PROGRESS | NOW | 5 | 40% (2\u002F5) | alpha |\n|   | M2-scaling | NOT_STARTED | NEXT | 3 | 0% (0\u002F3) | beta |\n|   | M3-enterprise | NOT_STARTED | LATER | 4 | 0% (0\u002F4) | ga |\n```\n\n- `→` marks the active milestone\n- Completion % = features at VERIFIED or DONE \u002F total features\n- Horizon comes from PRD roadmap table; show \"?\" if milestone not in PRD\n\n### Maturity Scaling\n\n- **POC\u002FAlpha:** Table as shown above\n- **Beta\u002FGA:** Add columns for Appetite Remaining, Risk Count, Cycle Count\n\n---\n\n## Command: \u002Fmilestone --switch \u003Cid>\n\nSwitch the active milestone. Accepts milestone ID like `M2-scaling` or just `M2`.\n\n### Step 1: Resolve Target\n\nFind the milestone file matching the argument:\n- Try `docs\u002Fmilestones\u002F{id}.md` directly\n- Try `docs\u002Fmilestones\u002FM{N}-*.md` glob if only a number given\n- If no match: \"Milestone '{id}' not found. Run `\u002Fadd:milestone --list` to see available milestones.\"\n\n### Step 2: Safety Checks\n\n**If target is COMPLETE:**\n```\nM1-foundation is marked COMPLETE.\nSwitching to a completed milestone is unusual — are you sure?\n(This won't reopen it, but new cycles would target it.)\n```\nAsk via AskUserQuestion. Proceed only if confirmed.\n\n**If current milestone has IN_PROGRESS features:**\n```\nCurrent milestone {name} has features in progress:\n  - Auth Overhaul (IN_PROGRESS, cycle-8)\n  - Session Refresh (PLANNED, cycle-8)\n\nThese will remain in their current state. Continue?\n```\nAsk via AskUserQuestion.\n\n**If active cycle exists** (check `.add\u002Fcycles\u002F` for non-COMPLETE cycles):\n```\nActive cycle {cycle-N} is tied to {current_milestone}.\nSwitching milestones won't close this cycle. You may want to\nrun \u002Fadd:cycle --complete first, or the cycle will be orphaned.\n\nContinue anyway?\n```\n\n### Step 3: Apply Switch\n\n1. Update `.add\u002Fconfig.json`:\n   - Set `planning.current_milestone` to target milestone ID\n   - Scan `.add\u002Fcycles\u002F` for cycles referencing the target milestone; set `planning.current_cycle` to the latest non-COMPLETE one, or `null` if none\n2. If target milestone Status is NOT_STARTED:\n   - Update milestone file: set `Status: IN_PROGRESS`, set `Started: {TODAY}`\n3. Present summary:\n\n```\nSwitched active milestone:\n  From: M1-foundation (IN_PROGRESS)\n  To:   M2-scaling (now IN_PROGRESS)\n\nConfig updated:\n  planning.current_milestone → \"M2-scaling\"\n  planning.current_cycle → null (no existing cycles for M2)\n\nNext: Run \u002Fadd:cycle --plan to plan the first cycle for M2.\n```\n\n---\n\n## Command: \u002Fmilestone --split \u003Cid>\n\nSplit a milestone into two. Interactive interview to redistribute features.\n\n### Step 1: Load and Display\n\nRead the target milestone file. Display:\n```\nSplitting: M3 — Marketplace Ready\nGoal: Build and launch the marketplace feature set\nFeatures (6):\n  1. Product Listings (SPECCED)\n  2. Search & Filter (SHAPED)\n  3. Shopping Cart (SHAPED)\n  4. Checkout Flow (SHAPED)\n  5. Seller Dashboard (SHAPED)\n  6. Order Management (SHAPED)\n```\n\n### Step 2: Interview (5 questions, 1-by-1)\n\n**Q1:** \"What's the split point? List the feature numbers that stay in the original milestone.\"\n→ Captures: feature distribution\n\n**Q2:** \"What's the goal for the NEW milestone? (The original milestone keeps its current goal unless you change it.)\"\n→ Captures: new milestone goal\n\n**Q3:** \"Name for the new milestone? (Suggestion: M{next}-{slug})\"\n→ Captures: new milestone ID and name\n\n**Q4:** \"Appetite for each? Redistribute the original budget or set new ones.\"\n→ Captures: appetite for both milestones\n\n**Q5:** \"Where does the new milestone sit in the roadmap? (Now\u002FNext\u002FLater)\"\n→ Captures: horizon placement\n\n### Step 3: Confirm\n\n```\nSplit plan:\n\nORIGINAL: M3 — Marketplace Ready (keeps 3 features)\n  Features: Product Listings, Search & Filter, Shopping Cart\n  Appetite: 2 weeks\n  Horizon: NOW\n\nNEW: M4 — Seller Experience (gets 3 features)\n  Features: Checkout Flow, Seller Dashboard, Order Management\n  Appetite: 3 weeks\n  Horizon: NEXT\n\nFiles to create\u002Fmodify:\n  - docs\u002Fmilestones\u002FM3-marketplace-ready.md (remove 3 features)\n  - docs\u002Fmilestones\u002FM4-seller-experience.md (NEW)\n  - docs\u002Fprd.md (add M4 to roadmap table)\n  - .add\u002Fconfig.json (no change — M3 stays active)\n\nProceed?\n```\n\n### Step 4: Apply\n\n1. Edit original milestone file — remove redistributed features from Hill Chart and Feature Detail table\n2. Create new milestone file from `${CLAUDE_PLUGIN_ROOT}\u002Ftemplates\u002Fmilestone.md.template` — populate with moved features (keep their current positions), goal, appetite\n3. Update `docs\u002Fprd.md` Section 6 — add new milestone row to roadmap table at the specified horizon\n4. If original milestone was the active one and all its remaining features are DONE, flag it\n\n---\n\n## Command: \u002Fmilestone --rescope \u003Cid>\n\nInteractively move features between milestones. Lighter than split — for fine-tuning scope.\n\n### Step 1: Display Current State\n\nShow features in the target milestone and adjacent milestones:\n\n```\nRescoping: M2 — Scaling (3 features)\n\nM2 features:\n  1. Load Balancer Setup (IN_PROGRESS)\n  2. Database Sharding (SPECCED)\n  3. CDN Integration (SHAPED)\n\nAdjacent milestones:\n  M1 — Foundation (5 features): Auth, Users, Profiles, Settings, Onboarding\n  M3 — Enterprise (4 features): SSO, Audit Log, RBAC, Compliance\n```\n\n### Step 2: Interactive Rescoping\n\nAsk 1-by-1:\n\n**Q1:** \"Move any features OUT of M2? (List numbers, or 'none')\"\n→ If yes: \"Where should each go? (target milestone ID)\"\n\n**Q2:** \"Move any features IN from other milestones? (List as 'M1:Auth, M3:SSO', or 'none')\"\n\n**Q3:** \"Add any brand new features? (Name + brief description, or 'none')\"\n→ If yes, note: \"New features will be added at SHAPED position. Create specs with `\u002Fadd:spec`.\"\n\n**Q4:** \"Should M2's goal or appetite change given the new scope?\"\n\n### Step 3: Confirm and Apply\n\nShow change summary. On confirmation:\n1. Edit source milestone — remove outgoing features\n2. Edit target milestones — add incoming features at their current position\n3. Edit rescoped milestone — add new features at SHAPED, update goal\u002Fappetite if changed\n4. Update PRD Section 6 if milestone scope changed significantly\n5. Append to PRD Section 10 (Revision History): `| {DATE} | {VERSION} | milestone | Rescoped {milestone}: {summary of changes} |`\n6. Update `.add\u002Fhandoff.md` if it exists — note the rescoping for session continuity\n\n---\n\n## Command: \u002Fmilestone --create\n\nCreate a new milestone from scratch with a lightweight interview.\n\n### Interview (scaled by maturity)\n\n**All maturities:**\n\n**Q1:** \"What's the milestone goal? (1-2 sentences — what does 'done' look like?)\"\n\n**Q2:** \"Name? (Suggestion: M{next_number}-{slug})\"\n\n**Q3:** \"Roadmap horizon? (Now \u002F Next \u002F Later)\"\n\n**Alpha+:**\n\n**Q4:** \"Effort appetite? (e.g., '2 weeks', '3 cycles', 'exploratory')\"\n\n**Q5:** \"Known features to include? (Comma-separated names, or 'none yet')\"\n\n**Beta+:**\n\n**Q6:** \"Success criteria? (List 3-5 measurable signals of completion)\"\n\n**Q7:** \"Any dependencies on other milestones or external factors?\"\n\n**Q8:** \"Target maturity level for this milestone? (poc\u002Falpha\u002Fbeta\u002Fga)\"\n\n### Generate\n\n1. Determine next milestone number from existing files\n2. Create `docs\u002Fmilestones\u002FM{N}-{slug}.md` from `${CLAUDE_PLUGIN_ROOT}\u002Ftemplates\u002Fmilestone.md.template`\n3. Populate: Goal, Status: NOT_STARTED, Features (all at SHAPED), Appetite, Success Criteria, Dependencies\n4. Update `docs\u002Fprd.md` Section 6 — add row to roadmap table at the specified horizon\n5. If no active milestone exists, offer: \"No active milestone set. Switch to M{N}? (y\u002Fn)\"\n   - If yes, update `planning.current_milestone` in config\n\n### Present\n\n```\nMilestone created: docs\u002Fmilestones\u002FM{N}-{slug}.md\n\nGoal: {goal}\nHorizon: {horizon}\nFeatures: {count} (all SHAPED)\nAppetite: {appetite}\n\nNext steps:\n  1. Create specs for features: \u002Fadd:spec {feature-name}\n  2. Switch to this milestone: \u002Fadd:milestone --switch M{N}\n  3. Plan first cycle: \u002Fadd:cycle --plan\n```\n\n---\n\n## Error Handling\n\n**No milestones exist:**\n- `--list`: \"No milestones found. Create one with `\u002Fadd:milestone --create` or run `\u002Fadd:init`.\"\n- `--switch\u002F--split\u002F--rescope`: \"Milestone not found.\"\n\n**Milestone file unparseable:**\n- Skip in `--list`, show warning\n- For targeted commands, report: \"Could not parse {file}. Check the file format against the milestone template.\"\n\n**PRD Section 6 missing:**\n- Commands still work (milestones are the source of truth for content)\n- Warn: \"PRD roadmap table not found — milestone files updated but PRD not synced. Run `\u002Fadd:roadmap --edit` to rebuild.\"\n\n---\n\n## Integration\n\n| Skill | Relationship |\n|-------|-------------|\n| `\u002Fadd:cycle` | Reads `planning.current_milestone`. Milestone skill sets this value. |\n| `\u002Fadd:roadmap` | Manages horizon placement. Milestone skill manages content and switching. |\n| `\u002Fadd:spec` | Creates feature specs listed in milestones. |\n| `\u002Fadd:promote` | Milestone completion can trigger promotion readiness. |\n",{"references":36,"description":7,"allowed-tools":38,"argument-hint":47},[37],"rules\u002Ftelemetry.md",[39,40,41,42,43,20,44,45,46],"Read","Write","Edit","Glob","Grep","AskUserQuestion","Task","TodoWrite","[--list | --switch \u003Cid> | --split \u003Cid> | --rescope \u003Cid> | --create]","main","e335248c85d50f73919320bc138766eb413c5ee3","plugins\u002Fadd\u002Fskills\u002Fmilestone",6,"https:\u002F\u002Fgithub.com\u002FMountainUnicorn\u002Fadd","https:\u002F\u002Fgetadd.dev","https:\u002F\u002Fgithub.com\u002FMountainUnicorn","2026-10-31 22:03:50",{"source":8,"skillName":5,"commands":57,"prompt":67,"zipAvailable":68},[58,61,64],{"tool":59,"command":60},"npx","npx skills add MountainUnicorn\u002Fadd --skill milestone",{"tool":62,"command":63},"bunx","bunx skills add MountainUnicorn\u002Fadd --skill milestone",{"tool":65,"command":66},"pnpm","pnpm dlx skills add MountainUnicorn\u002Fadd --skill milestone","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMountainUnicorn\u002Fadd\u002Fblob\u002Fmain\u002Fplugins\u002Fadd\u002Fskills\u002Fmilestone\u002FSKILL.md",true,[],[71,79,84,89,99,131],{"skillNo":72,"name":73,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":31},"01M6CHXN68ZCGNXE9Q0K2T2RKX","add-verify","https:\u002F\u002Fgithub.com\u002FMountainUnicorn\u002Fadd\u002Fblob\u002Fmain\u002Ftests\u002Fhooks\u002Ffixtures\u002Fdoctor\u002Fmanifest-modified\u002Fskills\u002Fadd-verify\u002FSKILL.md",[],[77,78],"add verify","verify",{"skillNo":80,"name":73,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":31},"01M6CHXJY4ZXKTNP0235A9KTNH","https:\u002F\u002Fgithub.com\u002FMountainUnicorn\u002Fadd\u002Fblob\u002Fmain\u002Ftests\u002Fhooks\u002Ffixtures\u002Fdoctor\u002Fmanifest-missing\u002Fskills\u002Fadd-verify\u002FSKILL.md",[],[77,78],{"skillNo":85,"name":73,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":31},"01M6CHXG6NV1DBMWT2N6XE5555","https:\u002F\u002Fgithub.com\u002FMountainUnicorn\u002Fadd\u002Fblob\u002Fmain\u002Ftests\u002Fhooks\u002Ffixtures\u002Fdoctor\u002Fhealthy\u002Fskills\u002Fadd-verify\u002FSKILL.md",[],[77,78],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":31},"01M6CHXDZFPEFBZ79GHP48S1BB","version","[ADD v0.11.0] Show installed version, project version, and upgrade status","https:\u002F\u002Fgithub.com\u002FMountainUnicorn\u002Fadd\u002Fblob\u002Fmain\u002Fplugins\u002Fadd\u002Fskills\u002Fversion\u002FSKILL.md",[],[91,22,96,18,20,21,97,23,27,98],"status","check","show",{"skillNo":100,"name":78,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":117,"publishedAt":31},"01M6CHXB5XG415PP88E0GACHP8","[ADD v0.11.0] Run quality gates — lint, types, tests, coverage, spec compliance","https:\u002F\u002Fgithub.com\u002FMountainUnicorn\u002Fadd\u002Fblob\u002Fmain\u002Fplugins\u002Fadd\u002Fskills\u002Fverify\u002FSKILL.md",[104,109,112],{"categoryNo":105,"categoryName":106,"taxonomyType":107,"taxonomyTypeDesc":108},"01JBSEEDCAT000000000000011","运维与部署","SCENARIO","使用场景",{"categoryNo":110,"categoryName":111,"taxonomyType":107,"taxonomyTypeDesc":108},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":113,"categoryName":114,"taxonomyType":115,"taxonomyTypeDesc":116},"01JBSEEDCAT000000000000037","律师与法务","PROFESSION","适用职业",[78,22,23,118,119,27,120,121,21,18,122,123,124,125,126,127,128,20,129,130],"coverage","fix","smoke","gate","spec","quality gates","run","lint","ci","compliance","secrets","learning","quality",{"skillNo":132,"name":133,"nameZh":6,"description":134,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":135,"categories":136,"keywords":144,"publishedAt":31},"01M6CHX8JF3M3J8BKTBW604D37","ux","[ADD v0.11.0] Iterate on UI\u002FUX design before implementation — wireframes, flow validation, and design sign-off","https:\u002F\u002Fgithub.com\u002FMountainUnicorn\u002Fadd\u002Fblob\u002Fmain\u002Fplugins\u002Fadd\u002Fskills\u002Fux\u002FSKILL.md",[137,140,141],{"categoryNo":138,"categoryName":139,"taxonomyType":107,"taxonomyTypeDesc":108},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":110,"categoryName":111,"taxonomyType":107,"taxonomyTypeDesc":108},{"categoryNo":142,"categoryName":143,"taxonomyType":115,"taxonomyTypeDesc":116},"01JBSEEDCAT000000000000032","设计师",[133,145,146,147,148,18,122,20,149,21,22,23,24,25,27,150,151,152,153],"ui","file","figma","validation","system","design-system","implementation","flow","design"]