milestone-coverage

Milestone Coverage

Propose a milestone scaffold for a feature by dispatching a PM-lens general-purpose Agent and shield:agile-coach in parallel and merging their outputs into a single user-editable proposal. The PM-lens prompt lives inline in templates.md (post pm-restructure-v0; previously this dispatched the omnibus shield:product-manager agent which has been decomposed).

When to Use

• /prd invokes this after Section 8 (User stories) is filled in the standard scaffold, or after Section 7 (Success metrics) in the lean scaffold, to scaffold the Milestones table.
• /plan invokes this as a fallback when the linked PRD has no milestones (or no PRD exists), to populate the sidecar milestones[].

Input contract

The caller provides:

• personas: list of {id, name, goals[]} (always required)
• goals: list of {id, description} (always required)
• stories: list of story objects from PRD §8 (required for standard; absent for lean — skill falls back to coarser proposals from goals+personas)
• feature_domain: best-effort domain hint (same set as shield:story-coverage)
• success_metrics: optional; used by PM agent to anchor outcomes to metrics

Output contract

Return a single merged milestone proposal:

{
  "milestones": [
    {
      "id": "M1",
      "name": "Login core",
      "outcome": "Users can log in with email + password",
      "exit_criteria": [
        "Login endpoint returns 200 + session token on valid credentials",
        "Rate limiting active on login endpoint"
      ],
      "depends_on": [],
      "source_agents": ["product-manager", "agile-coach"],
      "conflicts": []
    }
  ],
  "open_conflicts": [
    {
      "field": "depends_on",
      "milestone_id": "M2",
      "pm_proposal": [],
      "agile_coach_proposal": ["M1"],
      "explanation_pm": "PM sees recovery as independent of login UI changes",
      "explanation_agile_coach": "Recovery needs the session middleware shipped in M1"
    }
  ]
}

open_conflicts is what the caller surfaces to the user for resolution. conflicts per-milestone is set to [] when both agents agreed.