Skip to content

UX: Add blocker lifecycle explanation and recovery guidance #473

Description

@frankbria

Problem

The Blockers page shows blockers without context on how they were created or what 'answering' a blocker means for task execution. Users see an answer input but don't understand the impact.

Impact

Users unsure if answering a blocker will resume execution, require a new execution start, or do nothing. This uncertainty leads to abandonment or incorrect recovery attempts.

Recommendation

  1. Add info banner at top of blockers page: "Blockers pause AI execution. Answer below to provide the information needed to continue."
  2. Show blocker context in detail view: which task created it, what triggered it (stall timeout, missing file, agent request)
  3. After answering: show confirmation "Answer recorded. The agent will resume when you restart execution."
  4. Add 'Resume Execution' shortcut button where appropriate

Acceptance Criteria

  • Intro banner explains blocker purpose and lifecycle
  • Blocker detail shows originating task and trigger reason
  • Answer confirmation shows the exact next action required
  • User understands recovery flow without external docs
  • Works for both system-created and agent-created blockers

Affected Components

web-ui/src/app/blockers/page.tsx

Metadata

Metadata

Assignees

No one assigned

    Labels

    phase-6.3Phase 6.3: UX/UI design improvements for user journey through Think→Build→Prove→Shippriority:mediumux

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions