Skip to content

fix(quick-flow): standardize menu shortcuts for intuitive UX#1401

Merged
bmadcode merged 2 commits intobmad-code-org:mainfrom
alexeyv:fix/quick-spec-menu-shortcuts
Jan 25, 2026
Merged

fix(quick-flow): standardize menu shortcuts for intuitive UX#1401
bmadcode merged 2 commits intobmad-code-org:mainfrom
alexeyv:fix/quick-spec-menu-shortcuts

Conversation

@alexeyv
Copy link
Copy Markdown
Collaborator

@alexeyv alexeyv commented Jan 25, 2026

Summary

Fixes confusing menu shortcuts across quick-spec and quick-dev workflows.

quick-spec (step-04-review)

  • Users were typing a expecting to Approve (since "Approve" starts with A) but triggering Advanced Elicitation instead
  • Changed shortcuts:
    • [C] Continue (was [Y] Approve)
    • [E] Edit (was [C] Changes)
  • Keeps [A] for Advanced Elicitation consistent with other workflows

quick-dev (step-01, step-06)

  • Changed [T] to [P] for "Plan first" — P matches the label
  • Changed numbered options to letters for findings resolution:
    • [W] Walk through (was [1])
    • [F] Fix automatically (was [2])
    • [S] Skip (was [3])

Test plan

quick-spec:

  • Run quick-spec workflow to step 4 review menu
  • Verify C continues/finalizes the spec
  • Verify E allows editing changes
  • Verify A still triggers Advanced Elicitation

quick-dev:

  • Verify P triggers plan-first (tech-spec) flow
  • Run to step 6 and verify W/F/S work for findings resolution

🤖 Generated with Claude Code

…usion

Users were typing 'a' expecting to Approve (since it starts with A) but
triggering Advanced Elicitation instead. Changed shortcuts to:
- [C] Continue (was [Y] Approve)
- [E] Edit (was [C] Changes)

This keeps [A] for Advanced Elicitation consistent with other workflows.

Fixes user-reported UX issue with confusing menu shortcuts.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Jan 25, 2026

📝 Walkthrough

Walkthrough

Menu options in the step-04-review workflow updated from "[Y] Approve [C] Changes" to "[C] Continue [E] Edit ...". Execution flow adjusted to require 'C' (Continue) instead of 'Y' to proceed to finalization. New 'E' (Edit) path and catch-all feedback handler added.

Changes

Cohort / File(s) Summary
Workflow Review Step Update
src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md
Menu display changed from "[Y] Approve [C] Changes" to "[C] Continue [E] Edit ...". Finalization trigger updated from 'Y' to 'C'. New 'E' (Edit) option routes to Section 2 (Handle Review Feedback). Added catch-all path for additional comments or queries.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

Suggested reviewers

  • bmadcode
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check ✅ Passed The title 'fix(quick-flow): standardize menu shortcuts for intuitive UX' accurately describes the main change of standardizing menu shortcuts to improve user experience and reduce confusion.
Description check ✅ Passed The description provides clear, detailed context about the menu shortcut changes across workflows, explaining the rationale (user confusion between Approve and Advanced Elicitation) and documenting all modifications with a test plan.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

- Change [T] to [P] for "Plan first" (P matches the label)
- Change [1][2][3] to [W][F][S] for findings resolution:
  - [W] Walk through
  - [F] Fix automatically
  - [S] Skip

Consistent with letter-based menu pattern used elsewhere.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@alexeyv alexeyv changed the title fix(quick-spec): change menu shortcuts to avoid Approve/Advanced confusion fix(quick-flow): standardize menu shortcuts for intuitive UX Jan 25, 2026
@bmadcode bmadcode merged commit 79959e7 into bmad-code-org:main Jan 25, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants