zhongwei/gh-ninthspace-claude-code-marketplace-sdd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
gh-ninthspace-claude-code-m…/commands/project-status.md
Zhongwei Li d97a70be33 Initial commit
2025-11-30 08:44:27 +08:00

9.1 KiB
Raw Permalink Blame History

/sdd:project-status

Meta

  • Version: 2.0
  • Category: project-management
  • Complexity: medium
  • Purpose: Display comprehensive project status with story breakdown and progress tracking

Definition

Purpose: Show current project status including story breakdown, progress metrics, and actionable next steps.

Syntax: /sdd:project-status

Parameters

None

Behavior

Step 1: Project Context Loading

  1. CHECK if /docs/project-context/ directory exists
  2. IF missing:
    • SUGGEST running /sdd:project-init first
    • EXIT with guidance message
  3. LOAD project-specific requirements from:
    • /docs/project-context/project-brief.md (project title, timeline, objectives)
    • /docs/project-context/technical-stack.md (technology information)
    • /docs/project-context/development-process.md (stage definitions, workflows)

Step 2: Project Brief Analysis

  1. READ /docs/project-context/project-brief.md
  2. EXTRACT:
    • Project title and current status
    • Project objectives and goals
    • Target completion date (if specified)
    • Total planned stories count
  3. IF no project brief exists:
    • SUGGEST using /sdd:project-brief to create one
    • PROCEED with simplified view (Step 7)

Step 3: Story Collection and Analysis

  1. SCAN all story directories for project stories:

    • /docs/stories/development/ - Active implementation
    • /docs/stories/review/ - Code review stage
    • /docs/stories/qa/ - Quality assurance stage
    • /docs/stories/completed/ - Finished stories
    • /docs/stories/backlog/ - Planned stories (if exists)

  2. FOR EACH story:

    • COUNT stories by status category
    • IDENTIFY blocked or stalled stories
    • EXTRACT priority and effort estimates
    • NOTE dependencies and relationships

  3. CALCULATE metrics:

    • Total stories across all stages
    • Completion percentage
    • Stories by priority (Core/Enhancement/Future)
    • Active vs pending stories

Step 4: Progress Analysis

  1. CALCULATE completion metrics:

    • Percentage complete: (completed / total) × 100
    • Core stories progress
    • Enhancement stories progress
    • Future stories status

  2. IDENTIFY current focus:

    • Stories actively in development
    • Stories ready to start (no blockers)
    • Stories waiting on dependencies

  3. ANALYZE timeline:

    • Days since project start
    • Days remaining to target
    • Estimated completion based on velocity

Step 5: Issue Detection

  1. HIGHLIGHT concerns:
    • Stories behind schedule
    • Blocked stories with dependencies
    • Missing critical dependencies
    • Critical path bottlenecks
    • Long-running stories (potential issues)

Step 6: Formatted Status Display

GENERATE comprehensive status report:

📊 PROJECT STATUS
=================

🏗️  [PROJECT TITLE]
├── Status: Active (Started: [Date], Target: [Date])
├── Progress: ████████░░ 75% (6/8 stories complete)
├── Core Stories: ✅ 4/4 complete
├── Enhancement: 🔄 2/3 in progress
├── Future: ⏳ 0/1 pending
└── Next: STORY-XXX-007 (Feature name) - Ready to start

📊 STORY BREAKDOWN BY STATUS
- ✅ Completed: 3 stories
- 🔄 In Development: 2 stories
- 🔍 In Review: 1 story
- 🧪 In QA: 1 story
- ⏳ Backlog: 1 story
- ⚠️  Blocked: 0 stories

🎯 CURRENT FOCUS
- Active: STORY-XXX-005 (Feature name) - In development
- Ready to start: STORY-XXX-007 (Feature name)
- Waiting: STORY-XXX-008 (depends on STORY-XXX-005)

📅 TIMELINE
- Started: [Start Date]
- Target: [Target Date]
- Estimated completion: [Calculated Date]
- Days remaining: [X days]

💡 NEXT ACTIONS
1. Continue STORY-XXX-005 (Feature name)
2. Start STORY-XXX-007 when ready
3. Review completed stories in /qa

🔗 USEFUL COMMANDS
1. /sdd:story-continue     # Resume current work
2. /sdd:story-next         # Get next recommended story
3. /sdd:story-status       # See all individual story details

Step 7: Simplified View (No Project Brief)

IF no project brief exists, DISPLAY simplified metrics:

📊 PROJECT STATUS (SIMPLIFIED)
===============================

📁 Story Distribution:
- Development: [count] stories
- Review: [count] stories
- QA: [count] stories
- Completed: [count] stories
- Total: [count] stories

💡 RECOMMENDATION
Create a project brief for better organization and tracking:
→ /sdd:project-brief

Available commands:
1. /sdd:story-new      # Create new story
2. /sdd:story-status   # View story details
3. /sdd:project-brief  # Create project structure

Step 8: Command Suggestions

SUGGEST relevant commands based on current state:

IF stories ready to start:

  • /sdd:story-implement [id] for ready stories

IF work in progress:

  • /sdd:story-continue for resuming work

IF no project structure:

  • /sdd:project-brief to create organization

Output Format

Success Output

Comprehensive status display with:

  • Visual progress indicators (████░░)
  • Story breakdown by status (✅ 🔄 🔍 🧪 ⏳ ⚠️)
  • Timeline information
  • Actionable next steps
  • Relevant command suggestions

Simplified Output

Basic metrics when project brief is missing:

  • Story counts by directory
  • Total story count
  • Suggestions for creating structure

Examples

Example 1: Active Project with Full Brief

INPUT:
/sdd:project-status

OUTPUT:
📊 PROJECT STATUS
=================

🏗️  E-commerce Checkout Flow
├── Status: Active (Started: 2025-09-01, Target: 2025-10-15)
├── Progress: ████████░░ 75% (6/8 stories complete)
├── Core Stories: ✅ 4/4 complete
├── Enhancement: 🔄 2/3 in progress
├── Future: ⏳ 0/1 pending
└── Next: STORY-CHK-007 (Tax calculation) - Ready to start

📊 STORY BREAKDOWN BY STATUS
- ✅ Completed: 4 stories
- 🔄 In Development: 2 stories
- 🔍 In Review: 0 stories
- 🧪 In QA: 1 story
- ⏳ Backlog: 1 story
- ⚠️  Blocked: 0 stories

🎯 CURRENT FOCUS
- Active: STORY-CHK-005 (Payment integration) - In development
- Ready to start: STORY-CHK-007 (Tax calculation)
- Waiting: STORY-CHK-008 (depends on STORY-CHK-007)

📅 TIMELINE
- Started: 2025-09-01
- Target: 2025-10-15
- Estimated completion: 2025-10-12
- Days remaining: 14 days

💡 NEXT ACTIONS
1. Continue STORY-CHK-005 (Payment integration)
2. Start STORY-CHK-007 when ready
3. Review completed STORY-CHK-004 in /qa

🔗 USEFUL COMMANDS
1. /sdd:story-continue     # Resume current work
2. /sdd:story-next         # Get next recommended story
3. /sdd:story-status       # See all individual story details

Example 2: Project Without Brief

INPUT:
/sdd:project-status

OUTPUT:
📊 PROJECT STATUS (SIMPLIFIED)
===============================

📁 Story Distribution:
- Development: 2 stories
- Review: 1 story
- QA: 1 story
- Completed: 3 stories
- Total: 7 stories

💡 RECOMMENDATION
Create a project brief for better organization and tracking:
→ /sdd:project-brief

Available commands:
1. /sdd:story-new      # Create new story
2. /sdd:story-status   # View story details
3. /sdd:project-brief  # Create project structure

Example 3: No Project Context

INPUT:
/sdd:project-status

OUTPUT:
⚠️  PROJECT CONTEXT NOT FOUND

The /docs/project-context/ directory does not exist.

To set up the story-driven development system, run:
→ /sdd:project-init

This will create:
- Project context files
- Story directory structure
- Development workflow templates

Edge Cases

No Stories Found

IF no stories exist in any directory:

  • DISPLAY message about empty project
  • SUGGEST creating first story with /sdd:story-new
  • PROVIDE link to /sdd:project-brief for planning

Blocked Stories Only

IF all pending stories are blocked:

  • HIGHLIGHT critical blocker in status
  • IDENTIFY which story is blocking others
  • SUGGEST focusing on unblocking work

All Stories Complete

IF all stories are completed:

  • CONGRATULATE on project completion
  • SUGGEST running /sdd:project-phase for next phase
  • PROVIDE option to archive or start new phase

Error Handling

  • Missing /docs/project-context/: Suggest /sdd:project-init with clear instructions
  • Unreadable project brief: Continue with simplified view, warn user
  • Corrupted story files: Skip corrupted files, log warning, continue
  • Permission errors: Report specific file/directory with permission issue

Performance Considerations

  • Story scanning optimizes by reading only metadata, not full content
  • Large story collections (100+) process incrementally
  • File I/O batched for efficiency
  • Timeline calculations cached during single invocation

Related Commands

  • /sdd:project-brief - Create or update project documentation
  • /sdd:project-stories - Detailed story list with dependencies
  • /sdd:project-phase - Plan new development phase
  • /sdd:story-status - Individual story details
  • /sdd:story-continue - Resume active work
  • /sdd:story-next - Get next recommended story

Constraints

  • ✅ MUST handle missing project context gracefully
  • ✅ MUST provide actionable next steps
  • ✅ MUST display progress visually
  • 📊 SHOULD calculate accurate completion percentages
  • 🎯 SHOULD identify ready-to-start stories
  • ⚠️ MUST highlight blockers and issues clearly
Reference in New Issue View Git Blame Copy Permalink