--- allowed-tools: Task, Bash, Read, Write, WebFetch, Glob, Grep command: azure:us-status description: "Show comprehensive status of User Stories with task progress and metrics." --- # Azure DevOps User Story Status Show comprehensive status of User Stories with task progress and metrics. **Usage**: `/azure:us-status [user-story-id] [--sprint=] [--format=]` **Examples**: - `/azure:us-status` - Status of all active User Stories - `/azure:us-status 34` - Detailed status of specific User Story - `/azure:us-status --sprint="Sprint 1"` - Sprint-specific status - `/azure:us-status --format=burndown` - Show burndown chart ## Required Environment Variables Ensure `.opencode/.env` contains: ```bash AZURE_DEVOPS_PAT= AZURE_DEVOPS_ORG= AZURE_DEVOPS_PROJECT= ``` ## Required Documentation Access **MANDATORY:** Before Azure DevOps integration and agile workflows, query Context7 for best practices: **Documentation Queries:** - `mcp://context7/azure-devops/boards` - boards best practices - `mcp://context7/agile/user-stories` - user stories best practices - `mcp://context7/project-management/work-items` - work items best practices - `mcp://context7/agile/sprint-planning` - sprint planning best practices **Why This is Required:** - Ensures adherence to current industry standards and best practices - Prevents outdated or incorrect implementation patterns - Provides access to latest framework/tool documentation - Reduces errors from stale knowledge or assumptions ## Instructions ### 1. Query Mode Determine display based on arguments: - **No args**: Show all active stories dashboard - **Story ID**: Deep dive into specific story - **Sprint filter**: Sprint-focused view - **Format option**: Specialized visualizations ### 2. Status Displays #### Single User Story Status ``` ๐Ÿ“Š User Story #34: Implement user password reset Status: ๐Ÿ”„ Active | Sprint: Sprint 1 | Points: 8 ๐Ÿ“ˆ Progress Overview โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” Tasks: โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 60% (3/5 completed) Hours: โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 55% (15h/27h completed) Quality: โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘ 95% (tests passing) โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” ๐Ÿ“‹ Task Breakdown: โ”Œโ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ ID โ”‚ Task โ”‚ Status โ”‚ Assignee โ”‚ Hours โ”‚ Branch โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚ 101 โ”‚ Technical Design โ”‚ โœ… โ”‚ John โ”‚ 4h/4h โ”‚ merged โ”‚ โ”‚ 102 โ”‚ Implementation โ”‚ โœ… โ”‚ John โ”‚ 10h/12hโ”‚ merged โ”‚ โ”‚ 103 โ”‚ Unit tests โ”‚ โœ… โ”‚ Sarah โ”‚ 4h/4h โ”‚ merged โ”‚ โ”‚ 104 โ”‚ Integration tests โ”‚ ๐Ÿ”„ โ”‚ Sarah โ”‚ 2h/6h โ”‚ task-104โ”‚ โ”‚ 105 โ”‚ Documentation โ”‚ ๐Ÿ†• โ”‚ - โ”‚ 0h/3h โ”‚ - โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โฐ Timeline: - Started: 3 days ago - Est. Completion: 2 days - Velocity: 5h/day - Risk: Low โœ… ๐Ÿ”— Dependencies: - Blocking: None - Blocked by: API Gateway setup (#32) ๐Ÿ’ฌ Recent Activity: - 2h ago: Sarah started integration tests - 5h ago: John completed implementation - Yesterday: Code review approved โšก Recommended Actions: 1. Complete integration tests (Task #104) 2. Start documentation while tests run 3. Schedule demo for stakeholders ``` #### Sprint Dashboard View ``` ๐Ÿƒ Sprint 1 Status Dashboard Days: 5/10 | Capacity: 45% used User Stories Progress: โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” #34 Password Reset โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘ 70% [8pts] #35 User Profile โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 35% [5pts] #36 OAuth Login โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘ 90% [13pts] #37 Search Feature โ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 10% [8pts] โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” ๐Ÿ“Š Sprint Metrics: โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Metric โ”‚ Plan โ”‚ Actual โ”‚ Status โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚ Story Points โ”‚ 34 โ”‚ 15 โ”‚ โš ๏ธ Behindโ”‚ โ”‚ Tasks Complete โ”‚ 20 โ”‚ 12 โ”‚ โš ๏ธ At Riskโ”‚ โ”‚ Hours Burned โ”‚ 100h โ”‚ 45h โ”‚ โœ… On Trackโ”‚ โ”‚ Defects Found โ”‚ <5 โ”‚ 2 โ”‚ โœ… Good โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ ๐Ÿ‘ฅ Team Performance: - John: 3 tasks complete, 2 in progress - Sarah: 2 tasks complete, 1 in progress - Mike: 1 task complete, 3 in progress - Unassigned: 8 tasks โš ๏ธ Risks & Blockers: 1. OAuth integration delayed (external dependency) 2. Search feature needs design review 3. Mike overloaded - consider redistribution ``` #### Burndown Chart ``` ๐Ÿ“‰ Sprint Burndown Chart Hours 120 |โ–  110 |โ– โ–  100 |โ– โ– โ–  (Ideal) 90 |โ– โ– โ– โ– โ– . 80 |โ– โ– โ– โ– โ– โ– โ– โ– .. 70 |โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– ... 60 |โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– .. (Actual) 50 |โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ–  40 |โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ–  30 |โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ–  20 |โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ–  10 |โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ– โ–  0 +โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ†’ M T W T F M T W T F โ†‘ Today Status: Slightly behind ideal pace Projection: May need 1 extra day or scope reduction ``` ### 3. Detailed Metrics #### Velocity Analysis ``` ๐Ÿ“ˆ Velocity Trends Story Points/Sprint 20 | โ–  18 | โ–  โ–  16 | โ–  โ–  โ–  14 | โ–  โ–  โ–  โ–  12 |โ–  โ–  โ–  โ–  โ–  (avg: 15) 10 |โ–  โ–  โ–  โ–  โ–  8 |โ–  โ–  โ–  โ–  โ–  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ†’ S1 S2 S3 S4 S5 Current Sprint: Tracking at 13 points Recommendation: Realistic capacity is 15 points ``` #### Quality Metrics ``` โœ… Quality Dashboard Test Coverage: โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘ 82% Code Reviews: โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ 100% Bug Density: โ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 2/story (Good) Tech Debt: โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 30% (Manage) Recent Issues: - ๐Ÿ› Bug #451: Login timeout (Fixed) - ๐Ÿ› Bug #452: Validation error (In Progress) - ๐Ÿ’ก Improvement: Refactor auth service ``` ### 4. Forecast & Predictions ``` ๐Ÿ”ฎ Completion Forecast Based on current velocity: - Story #34: Complete by Thursday โœ… - Story #35: At risk - needs 2 more devs - Story #36: On track for Friday - Story #37: Won't complete this sprint โŒ Recommendations: 1. Move Story #37 to next sprint 2. Add Sarah to Story #35 3. Schedule sprint review for Friday PM ``` ### 5. Export Formats Support multiple export formats: ```bash # Export as CSV /azure:us-status --format=csv > sprint-status.csv # Export as JSON for dashboards /azure:us-status --format=json > status.json # Generate HTML report /azure:us-status --format=html > report.html # Markdown for documentation /azure:us-status --format=markdown > STATUS.md ``` ### 6. Integration Status Show CI/CD and PR status: ``` ๐Ÿ”„ Integration Status Story #34: Password Reset โ”œโ”€โ”€ PR #456: โœ… Merged โ”œโ”€โ”€ PR #457: ๐Ÿ‘€ In Review (2 approvals needed) โ”œโ”€โ”€ PR #458: ๐Ÿšง Draft โ”‚ โ”œโ”€โ”€ CI/CD Pipeline: โ”‚ โ”œโ”€โ”€ Build: โœ… Passing โ”‚ โ”œโ”€โ”€ Tests: โœ… 157/157 passing โ”‚ โ”œโ”€โ”€ Security: โš ๏ธ 1 medium issue โ”‚ โ””โ”€โ”€ Deploy: โธ๏ธ Waiting โ”‚ โ””โ”€โ”€ Environments: โ”œโ”€โ”€ Dev: โœ… Deployed (v1.2.3-rc1) โ”œโ”€โ”€ Staging: โณ Scheduled for tonight โ””โ”€โ”€ Prod: ๐Ÿ“… Planned for Monday ``` ### 7. Alerts & Notifications Highlight important status changes: ``` ๐Ÿ”” Alerts โš ๏ธ HIGH: Story #35 blocked by external API โฐ MEDIUM: Story #36 review needed today ๐Ÿ“Œ LOW: Update estimates for Story #37 Would you like to: 1. View blocker details 2. Send review reminder 3. Re-estimate story 4. Dismiss alerts Select (1-4): _ ``` ## Smart Features ### Predictive Analytics - Estimate completion dates - Identify at-risk stories - Suggest resource reallocation ### Automated Recommendations - Next best action for each story - Optimal task assignments - Risk mitigation strategies ### Historical Comparison - Compare with previous sprints - Track improvement trends - Identify recurring issues ## Error Handling - **No stories found**: Check filters and sprint - **API timeout**: Use cached data if available - **Invalid sprint**: List available sprints ## Configuration Support custom status views: ```yaml # .opencode/azure/status-config.yml views: default: show_burndown: true show_velocity: true alert_threshold: 80 executive: summary_only: true show_risks: true export_format: pdf ```