342 lines
8.3 KiB
Markdown
342 lines
8.3 KiB
Markdown
---
|
|
name: re:status
|
|
description: Show comprehensive overview of requirements project status, progress, and health
|
|
allowed-tools: [Bash, Read]
|
|
---
|
|
|
|
# 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
|
|
|
|
1. **Get Project Info:**
|
|
- Use `gh project list --owner [owner] --format json`
|
|
- Identify the requirements project
|
|
- Get project URL and metadata
|
|
|
|
2. **Retrieve All Items:**
|
|
- Use `gh project item-list [project-number] --format json`
|
|
- Get full details including custom fields (Type, Priority, Status)
|
|
|
|
3. **Categorize by Type:**
|
|
- Vision: Count and status
|
|
- Epics: Count, priorities, status
|
|
- Stories: Count, priorities, status, parent epic
|
|
- Tasks: Count, priorities, status, parent story
|
|
|
|
4. **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
|
|
|
|
### 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
|