Initial commit
This commit is contained in:
Zhongwei Li
341
commands/status.md
Normal file
341
commands/status.md
Normal file
@@ -0,0 +1,341 @@
|
||||
---
|
||||
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
|
||||
Reference in New Issue
Block a user