8.3 KiB
8.3 KiB
name, description, allowed-tools
| name | description | allowed-tools | ||
|---|---|---|---|---|
| re:status | Show comprehensive overview of requirements project status, progress, and health |
|
Requirements Project Status
Display a comprehensive overview of the requirements project including counts, progress, priorities, validation status, and recent activity.
Instructions
Step 1: Gather Project Data
-
Get Project Info:
- Use
gh project list --owner [owner] --format json - Identify the requirements project
- Get project URL and metadata
- Use
-
Retrieve All Items:
- Use
gh project item-list [project-number] --format json - Get full details including custom fields (Type, Priority, Status)
- Use
-
Categorize by Type:
- Vision: Count and status
- Epics: Count, priorities, status
- Stories: Count, priorities, status, parent epic
- Tasks: Count, priorities, status, parent story
-
Get Recent Activity:
- Use
gh issue list --repo [repo] --label type:epic,type:story,type:task --limit 10 --json number,title,updatedAt,state - Show last updated items
- Use
Step 2: Calculate Metrics
Counts by Type:
- Total Vision issues (should be 1)
- Total Epics
- Total Stories
- Total Tasks
Progress by Status:
- Not Started: [Count] ([%]%)
- In Progress: [Count] ([%]%)
- Completed: [Count] ([%]%)
Priority Distribution:
- Must Have: [Count] ([%]%)
- Should Have: [Count] ([%]%)
- Could Have: [Count] ([%]%)
- Won't Have: [Count] ([%]%)
Completion Metrics:
- Epics: [X] of [Total] completed ([%]%)
- Stories: [X] of [Total] completed ([%]%)
- Tasks: [X] of [Total] completed ([%]%)
Velocity (if applicable):
- Tasks completed in last 7 days
- Stories completed in last 30 days
Step 3: Generate Status Dashboard
Display comprehensive status:
# 📊 Requirements Project Status
**Project:** [Project Name]
**URL:** [Project URL]
**Last Updated:** [Current Date/Time]
---
## 📈 Overview
| Level | Total | Not Started | In Progress | Completed | % Complete |
|-------|-------|-------------|-------------|-----------|------------|
| Vision | [N] | [N] | [N] | [N] | [%]% |
| Epics | [N] | [N] | [N] | [N] | [%]% |
| Stories | [N] | [N] | [N] | [N] | [%]% |
| Tasks | [N] | [N] | [N] | [N] | [%]% |
**Overall Progress:** [Progress bar visualization]
████████░░░░░░░░░░░░ [%]%
---
## 🎯 Priority Breakdown
**Must Have:**
- Epics: [N] | Stories: [N] | Tasks: [N]
- Status: [N] complete, [N] in progress, [N] not started
**Should Have:**
- Epics: [N] | Stories: [N] | Tasks: [N]
- Status: [N] complete, [N] in progress, [N] not started
**Could Have:**
- Epics: [N] | Stories: [N] | Tasks: [N]
- Status: [N] complete, [N] in progress, [N] not started
**Won't Have:**
- Epics: [N] | Stories: [N] | Tasks: [N]
---
## 🎯 Current Focus
**Active Work (In Progress):**
- #[num] - [Epic/Story/Task title] (type: [type])
- #[num] - [Epic/Story/Task title] (type: [type])
[List all items with Status = "In Progress"]
**Next Up (Highest Priority Not Started):**
1. #[num] - [Epic/Story/Task title] (priority: Must Have)
2. #[num] - [Epic/Story/Task title] (priority: Must Have)
3. #[num] - [Epic/Story/Task title] (priority: Must Have)
---
## 🏗️ Epic Status Detail
[For each epic, show progress]
### Epic: [Epic Title] (#[num])
- **Priority:** [Must/Should/Could Have]
- **Status:** [Not Started/In Progress/Completed]
- **Stories:** [X] of [Total] complete ([%]%)
- **Tasks:** [X] of [Total] complete ([%]%)
- **Progress:** ████░░░░░░ [%]%
[Repeat for all epics]
---
## ✅ Validation Status
**Last Validation:** [Date or "Never"]
**Quick Health Check:**
- [ ] Vision exists: [✓/✗]
- [ ] All epics linked to vision: [✓/✗]
- [ ] All stories linked to epics: [✓/✗]
- [ ] All tasks linked to stories: [✓/✗]
- [ ] Priority distribution balanced: [✓/⚠️/✗]
- [ ] No orphaned issues: [✓/✗]
**Issues Found:** [N critical, N warnings]
[If issues:] Run `/re:review` for detailed validation report.
---
## 🚀 Velocity & Trends
**Recent Activity (Last 7 days):**
- Tasks completed: [N]
- Stories completed: [N]
- Epics completed: [N]
- New items created: [N]
**Last 10 Updated Items:**
1. #[num] - [Title] ([type]) - Updated [timeago]
2. #[num] - [Title] ([type]) - Updated [timeago]
[...]
---
## 📊 Coverage Analysis
**Vision → Epics:**
- Vision coverage: [All vision elements covered by epics? ✓/✗]
**Epics → Stories:**
[For each epic]
- Epic #[num]: [Has stories? ✓/✗] ([N] stories)
**Stories → Tasks:**
[Sample or summary]
- [N] stories have tasks
- [N] stories need task breakdown
---
## 💡 Recommendations
[Based on status, provide actionable suggestions]
**Immediate Actions:**
[If no vision:] Run `/re:discover-vision` to create vision
[If no epics:] Run `/re:identify-epics` to identify major capabilities
[If epics not prioritized:] Run `/re:prioritize` to rank epics
[If highest priority epic has no stories:] Run `/re:create-stories` to break down top epic
[If highest priority story has no tasks:] Run `/re:create-tasks` to create implementation tasks
**Health Issues:**
[If validation issues:] Run `/re:review` to identify and fix issues
[If too many In Progress:] Focus on completing work before starting new items
[If progress stalled:] Review blockers and dependencies
**Next Steps:**
[Contextual suggestions based on current state]
---
## 🔗 Quick Links
- **GitHub Project:** [URL]
- **Vision Issue:** #[num]
- **All Epics:** [Filter URL]
- **All Stories:** [Filter URL]
- **All Tasks:** [Filter URL]
- **Must Haves:** [Filter URL]
- **In Progress:** [Filter URL]
---
## 📅 Suggested Actions
Based on current status:
1. [Most logical next action based on project state]
2. [Second priority action]
3. [Third priority action]
**Commands:**
- `/re:discover-vision` - [If no vision]
- `/re:identify-epics` - [If vision but no epics]
- `/re:create-stories` - [If epics but incomplete stories]
- `/re:create-tasks` - [If stories but incomplete tasks]
- `/re:prioritize` - [If items not prioritized]
- `/re:review` - [Regular validation]
Step 4: Provide Context-Aware Guidance
Based on the status, provide specific next steps:
If just starting (no vision):
🚀 Getting Started
Your requirements project is newly initialized!
Next Steps:
1. Run `/re:discover-vision` to define your product vision
2. Then `/re:identify-epics` to identify major capabilities
3. Use `/re:prioritize` to rank epics
4. Start implementing highest-priority epics
Estimated time to complete vision + epics: 1-2 hours
If vision exists but few epics:
📝 Vision Defined - Define Epics Next
You have a solid vision. Time to break it down!
Next Steps:
1. Run `/re:identify-epics` to identify 5-12 major capabilities
2. Prioritize epics with `/re:prioritize`
3. Create stories for top epic with `/re:create-stories`
If epics exist but few stories:
🎯 Epics Identified - Create Stories
You have [N] epics. Let's create user stories!
Focus: [Highest priority epic name]
Next Steps:
1. Run `/re:create-stories` for epic #[num]
2. Prioritize stories with `/re:prioritize`
3. Create tasks for top story with `/re:create-tasks`
If well underway:
💪 In Full Swing - Keep the Momentum!
Progress: [X]% complete
Current Focus: [In progress items]
Next Steps:
1. Complete in-progress items
2. Run `/re:status` regularly to track progress
3. Run `/re:review` weekly for quality checks
If near complete:
🎉 Almost There!
You're [X]% complete - great progress!
Remaining Work:
- [N] epics to complete
- [N] stories to finish
- [N] tasks remaining
Keep going! Run `/re:status` to track final progress.
Step 5: Export Option
Offer to export status report:
Would you like to export this status report?
I can save it as:
- Markdown file (status-report-[date].md)
- Add as comment to vision issue
- Both
[Use AskUserQuestion for choice]
If user wants export, create the file or add comment as requested.
Error Handling
- If no project exists: Guide to
/re:init - If project empty: Guide to
/re:discover-vision - If GitHub API fails: Show cached/partial data with warning
Notes
- Can be run anytime - no prerequisites
- Provides complete project snapshot
- Context-aware recommendations
- Shows trends and velocity
- Validates project health
- Suggests next logical actions
- Export-friendly format
- Run regularly (daily/weekly) to track progress