Marks story as blocked and logs the reason.
Marks story as blocked and logs the reason with detailed tracking and follow-up reminders.
/plugin marketplace add ninthspace/claude-code-marketplace/plugin install sdd@ninthspace-marketplaceMarks story as blocked and logs the reason.
Format: Imperative (comprehensive) Actions: Multi-step status update with tracking Modifications: Updates story file, adds progress log entry
/sdd:story-blocked [STORY-ID] [reason]
STORY-ID (optional): Defaults to current active storyreason (optional): Prompted if not providedSTORY-ID provided, locate story file across all directoriesPrompt user for:
🚫 BLOCKING ISSUE
================
Story: [ID] - [Title]
Blocked since: [timestamp]
Reason for block:
- [ ] Waiting on external dependency
- [ ] Need clarification on requirements
- [ ] Technical issue/bug
- [ ] Waiting for code review
- [ ] Infrastructure/environment issue
- [ ] Missing access/permissions
- [ ] Other: [specify]
Detailed description:
[What exactly is blocking progress]
What's needed to unblock:
[Specific action or information needed]
Who can help:
[Person/team who can resolve]
Estimated resolution:
[When might this be resolved]
Modifications to make:
Update YAML frontmatter:
status: blocked
blocked_since: [ISO timestamp]
blocked_reason: [selected reason]
Add progress log entry:
## [Timestamp] - BLOCKED
**Reason**: [selected reason]
**Details**: [detailed description]
**Needed to unblock**: [requirements]
**Can help**: [person/team]
**Estimated resolution**: [timeframe]
**Completed before block**:
- [List work finished before blocking]
Add [BLOCKED] tag to story title if not present
💡 WHILE BLOCKED, YOU COULD:
Related work:
- [ ] Write tests for completed parts
- [ ] Document what's built so far
- [ ] Refactor existing code
Other stories:
- [Story X]: Ready to start
- [Story Y]: Quick bug fix
Improvements:
- Update documentation
- Fix technical debt
- Review other PRs
Calculate and display:
⏱️ BLOCKED TIME TRACKING
This story:
- Previously blocked: [X hours total]
- Current block: Started [timestamp]
All stories this week:
- Total blocked time: [X hours]
- Main block reasons: [Top 3]
Update story metadata:
blocked_time_total: [X hours]
blocked_instances: [count]
📅 FOLLOW-UP SCHEDULED
Check status in: [X hours/days]
Reminder for: [date/time]
Auto-check will:
- Verify if still blocked
- Suggest escalation if needed
- Track resolution time
Add to story metadata:
follow_up_date: [ISO timestamp]
If same blocking reason appears multiple times:
⚠️ PATTERN DETECTED
This is the [Nth] time blocked by:
[Similar blocking reason]
Consider:
- Process improvement
- Better communication
- Different approach
Add note to project context or retrospective file.
✅ STORY BLOCKED
===============
Story: [STORY-ID] - [Title]
Blocked since: [timestamp]
Reason: [selected reason]
📊 BLOCK REPORT
==============
Current blocks:
1. [Story ID]: [Reason] - [Duration]
2. [Story ID]: [Reason] - [Duration]
This week's blocks:
- External deps: [X hours]
- Clarifications: [X hours]
- Technical: [X hours]
Impact:
- Velocity reduced by [X]%
- [X] stories delayed
For future reference:
When running /sdd:story-continue or /sdd:story-unblock:
✅ UNBLOCKED!
============
Was blocked for: [total time]
Resolution: [what resolved it]
Actions taken:
- Remove [BLOCKED] tag
- Update status to previous state
- Log resolution in progress
- Resume work
If blocked > 4 hours:
⚠️ ESCALATION RECOMMENDED
========================
Blocked for: [X hours]
Actions:
- Notify: [escalation contact]
- Consider: Alternative approach
- Document: For retrospective