Initial commit

2025-11-30 08:44:27 +08:00
commit d97a70be33
36 changed files with 17033 additions and 0 deletions
--- a/commands/story-next.md
+++ b/commands/story-next.md
@@ -0,0 +1,198 @@
+# /sdd:story-next
+
+Suggests what to work on next based on priorities and status.
+
+## Implementation
+
+**Format**: Imperative (comprehensive)
+**Actions**: Multi-step analysis with dependency validation
+**Modifications**: None (read-only recommendations)
+
+### Analysis Steps
+
+#### 1. Assess Current State
+- List all stories in `/docs/stories/development/`
+- List all stories in `/docs/stories/review/`
+- List all stories in `/docs/stories/qa/`
+- List all completed stories in `/docs/stories/completed/`
+- Read backlog priorities from `/docs/stories/backlog/`
+- Read dependency graph from `/docs/project-context/story-relationships.md`
+
+#### 2. Validate Dependencies
+- Cross-reference dependencies against completed stories
+- Verify no recommended stories exist in `/docs/stories/completed/`
+- Flag mismatches between planned vs actual completion status
+- Identify stories with all dependencies satisfied
+
+#### 3. Apply Decision Logic
+
+Priority order:
+1. Stories in QA with issues (closest to shipping)
+2. Stories in review with feedback
+3. Stories in development > 3 days (complete or timebox)
+4. Critical bugs/security issues
+5. High-priority backlog items with satisfied dependencies
+6. Technical debt or improvements
+
+### Output Format
+
+#### Primary Recommendations
+
+```
+📋 NEXT STORY RECOMMENDATIONS
+============================
+
+🥇 HIGHEST PRIORITY
+------------------
+[STORY-ID]: [Title]
+Status: Available (verified not completed)
+Dependencies: [List with completion status]
+Reason: [Why this is most important]
+Estimated effort: [X days]
+Business value: [High/Medium/Low]
+
+Command: /sdd:story-start [STORY-ID]
+
+🥈 SECOND OPTION
+---------------
+[STORY-ID]: [Title]
+Status: Available (verified not completed)
+Dependencies: [List with completion status]
+Reason: [Why consider this]
+Estimated effort: [X days]
+Trade-off: [What you defer]
+
+🥉 THIRD OPTION
+--------------
+[STORY-ID]: [Title]
+Status: Available (verified not completed)
+Dependencies: [List with completion status]
+Reason: [Alternative path]
+Benefit: [Specific advantage]
+```
+
+#### Decision Factors
+
+```
+⚖️ DECISION FACTORS
+
+Time available:
+- Full day → Start new feature
+- Few hours → Fix bugs/review
+- < 1 hour → Quick improvements
+
+Energy level:
+- High → Complex new work
+- Medium → Continue existing
+- Low → Simple fixes/docs
+
+Dependencies:
+- Waiting on review: [list]
+- Blocked by external: [list]
+- Ready to start: [list]
+```
+
+#### Backlog Overview
+
+```
+📚 BACKLOG OVERVIEW
+
+✅ COMPLETED STORIES:
+[List from /docs/stories/completed/ with dates]
+
+📋 REMAINING BACKLOG:
+
+High Priority:
+1. [Story] - [Est.] - Available
+2. [Story] - [Est.] - Blocked by [X]
+
+Medium Priority:
+3. [Story] - [Est.] - Available
+4. [Story] - [Est.] - Blocked by [X]
+
+Quick Wins (<1 day):
+5. [Bug fix] - 2 hours
+6. [Doc update] - 1 hour
+
+Technical Debt:
+7. [Refactor] - [Est.]
+8. [Performance] - [Est.]
+```
+
+#### Pattern Insights (Optional)
+
+If sufficient historical data:
+```
+📊 PATTERN INSIGHTS
+
+Based on history:
+- Fastest completions: [story type]
+- Most productive: [day/time]
+- Success patterns: [insights]
+
+Recommendation: [Specific suggestion]
+```
+
+#### Risk Assessment
+
+```
+⚠️ RISK CONSIDERATIONS
+
+Risky to start now:
+- [Complex story] - End of week
+- [Large refactor] - Before deadline
+
+Safe to start:
+- [Small feature] - Low risk
+- [Bug fix] - Quick win
+```
+
+#### Project Context
+
+```
+🎯 PROJECT PRIORITIES
+
+This sprint/week focus: [Main goal]
+Upcoming deadline: [Date] - [What's due]
+User feedback priority: [Most requested]
+```
+
+### Empty State
+
+If no clear next story:
+```
+💭 NO CLEAR PRIORITY
+
+Productive alternatives:
+1. Code review backlog
+2. Update documentation
+3. Write tests for untested code
+4. Refactor complex functions
+5. Learn new tool/technique
+
+Create new story: /sdd:story-new
+```
+
+### Action Plan
+
+Always conclude with:
+```
+✅ RECOMMENDED ACTION PLAN
+=========================
+
+Right now:
+1. [Immediate action]
+   Command: /[command-to-run]
+
+Then:
+2. [Follow-up action]
+
+This week:
+3. [Week goal]
+```
+
+### Notes
+- Read-only analysis, no file modifications
+- Validates all dependencies against filesystem
+- Prevents recommending completed stories
+- Waits for user decision before any action