Skip to content

feat(instructions): ADO sprint planning workflow and prompt #779

@chaosdinosaur

Description

@chaosdinosaur

Summary

Add sprint/iteration planning workflow for ADO with coverage analysis, capacity
tracking, gap detection, and backlog grooming recommendations. Includes the
/ado-sprint-plan prompt as a launcher.

Part of #774. Depends on shared infrastructure (#776).

Changes

New Files

  • .github/instructions/ado/ado-backlog-sprint.instructions.md
    • 3-phase workflow (Discover/Retrieve → Analyze → Plan)
    • Coverage matrix by Area Path and by work item type hierarchy (Epic → Feature → Story → Task)
    • Capacity analysis with StoryPoints, OriginalEstimate, RemainingWork, and CompletedWork burndown metrics
    • Gap analysis cross-referencing requirements documents against iteration backlog
    • Dependency detection using Predecessor/Successor link types with external blocker and internal chain tracking
    • sprint-plan.md output template with hierarchy coverage, burndown ratio, and Area Path coverage sections
  • .github/prompts/ado/ado-sprint-plan.prompt.md
    • Inputs: project, iteration, documents, sprintGoal, capacity, contentFormat
    • Routes through agent: ADO Backlog Manager
  • collections/ado.collection.yml (sprint entries)

ADO-Specific Capabilities

These capabilities leverage ADO's data model advantages over flat issue trackers:

Capability ADO Field / Feature Description
Quantitative capacity planning Microsoft.VSTS.Scheduling.StoryPoints Sum planned effort vs team velocity (not heuristic)
Burndown tracking CompletedWork / OriginalEstimate Progress ratio against sprint plan
Effort tracking RemainingWork / CompletedWork Real-time remaining work analysis
Explicit dependency graphs Predecessor/Successor link types Stronger than GitHub cross-references
4-level hierarchy coverage Epic → Feature → Story → Task Decomposition completeness at each level
Priority ordering Microsoft.VSTS.Common.Priority (1-4) Quantitative priority scale

Acceptance Criteria

  • ado-backlog-sprint.instructions.md created with 3-phase workflow
  • ado-sprint-plan.prompt.md created and routed to ADO Backlog Manager
  • contentFormat input added to sprint planning prompt
  • Hierarchy coverage matrix included (Epic/Feature/Story/Task decomposition analysis)
  • Burndown metrics included (CompletedWork / OriginalEstimate ratio)
  • Collection manifest updated
  • Markdown linting passes

Metadata

Metadata

Assignees

Labels

featureNew feature triggering minor version bumpinstructionsCopilot instruction files (.instructions.md)promptsCopilot prompt files (.prompt.md)

Type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions