PRD Planning Workflow

The PRD Planning workflow converts product requirements documents into Azure DevOps work item hierarchies, decomposing requirements into the four-level structure (Epic > Feature > Story > Task) that Azure DevOps supports natively.

When to Use

• 📄 A product requirements document needs conversion to work items
• 🏗️ Building an initial backlog from a specification or design document
• 🔗 Requirements need traceability from document to backlog items
• 📊 Converting a large requirements set into a structured work item hierarchy

What It Does

1. Accepts a PRD, specification, or requirements document as input
2. Delegates to the @AzDO PRD to WIT agent for parsing and decomposition
3. Maps requirements to Azure DevOps work item types (Epic, Feature, User Story, Task)
4. Builds parent-child relationships following the four-level hierarchy
5. Produces a handoff file with the complete work item hierarchy ready for execution

NOTE

PRD Planning delegates to a specialized agent (@AzDO PRD to WIT) that handles the document parsing and hierarchy construction. The ADO Backlog Manager orchestrates the handoff and provides the execution path.

Hierarchy Model

Azure DevOps supports a four-level work item hierarchy. PRD Planning maps requirements to the appropriate level based on scope and granularity:

Level	Work Item Type	Typical Scope
Level 1	Epic	Business initiative or major objective
Level 2	Feature	Functional capability or component
Level 3	User Story	User-facing requirement or scenario
Level 4	Task	Implementation step or technical work

Requirements that span multiple features become Epics. Requirements with clear user value become User Stories. Implementation details become Tasks under their parent Stories.

Output Artifacts

.copilot-tracking/workitems/prds/<prd-name>/
├── artifact-analysis.md  # Extracted requirements and field mappings
├── work-items.md         # Proposed work item hierarchy
├── planning-log.md       # Decomposition decisions and progress
└── handoff.md            # Execution-ready operations

How to Use

Option 1: Handoff Button

Click the "PRD" handoff button in the ADO Backlog Manager agent. This delegates to the @AzDO PRD to WIT agent with your document context.

Option 2: Direct Reference

Reference your requirements document in a conversation with the ADO Backlog Manager:

Convert this PRD to Azure DevOps work items: [path/to/requirements.md]

Option 3: Inline Content

Paste requirements directly into the chat:

Create a work item hierarchy from these requirements:
1. Users can search by keyword
2. Search results display in a paginated list
3. Results can be filtered by date range

Example Prompts

Full PRD conversion to work item hierarchy:

Parse the product requirements document at docs/prd-v2.md and create
an Azure DevOps work item hierarchy. Structure as:
- Epics for major feature areas
- Stories for user-facing capabilities within each Epic
- Tasks for implementation steps within each Story

Include acceptance criteria from the PRD as Story descriptions.

Incremental update from a revised PRD section:

Read Section 4 (Search and Filtering) from docs/prd-v3.md and add
new work items to the existing hierarchy under Epic "Search Platform."
Do not recreate items that already exist in the backlog. Flag any
requirement changes that conflict with existing Stories.

Schema-guided decomposition with depth control:

Convert the requirements in docs/api-spec.md into a two-level hierarchy
only: Epics and Stories. Do not create Tasks. Group Stories by API
endpoint and include the HTTP method and path in each Story title.

Output artifacts: PRD planning creates a hierarchy handoff file mapping requirements to proposed work items with parent-child relationships. Review the hierarchy structure and verify parent links before executing.

Tips

• ✅ Provide a structured document with clear requirement boundaries for best results
• ✅ Review the proposed hierarchy before executing to verify parent-child relationships
• ✅ Use the execution workflow to apply the hierarchy after review
• ✅ Combine with sprint planning to assign the created hierarchy to iterations
• ❌ Do not mix PRD planning with manual work item creation in the same session
• ❌ Do not skip hierarchy review before execution (parent-child errors are harder to fix)
• ❌ Do not expect PRD planning to handle ongoing triage (use the triage workflow instead)

Common Pitfalls

Pitfall	Solution
Requirements too vague for decomposition	Add specificity to the source document before conversion
Hierarchy too deep or too shallow	Adjust the decomposition level in your prompt
Duplicate work items from repeated runs	Check existing backlog items before re-running PRD conversion
Missing parent-child links	Verify the handoff file before execution

Next Steps

1. Review the proposed hierarchy in the handoff file
2. Use the "Execute" handoff to apply the work item hierarchy to Azure DevOps
3. Continue with Sprint Planning to assign iterations to the new items

---

🤖 Crafted with precision by ✨Copilot following brilliant human instruction, then carefully refined by our team of discerning human reviewers.