Files
kandev/docs/specs/walkthrough-feedback-controls/spec.md
T
2026-08-04 00:16:33 +01:00

1.5 KiB

status, created, owner
status created owner
shipped 2026-08-03 product

Walkthrough Feedback Controls

Why

The walkthrough note form remains available while a walkthrough is open. A visible Cancel action is misleading when that form has no temporary mode to dismiss and the action cannot change anything.

What

  • A walkthrough note form exposes Add and Run for saving or immediately sending non-empty feedback.
  • A persistent walkthrough note form omits the optional onCancel capability, so it does not expose Cancel.
  • Desktop floating and phone bottom-sheet walkthroughs use the same feedback action set.
  • The walkthrough header's close action and the launcher's discard action remain the ways to minimize or remove a walkthrough.

Scenarios

  • GIVEN an open desktop walkthrough, WHEN its note form renders, THEN Add and Run are available and no Cancel action is shown.
  • GIVEN an open phone walkthrough bottom sheet, WHEN its note form renders, THEN it exposes the same Add and Run actions without a Cancel action.

Out of scope

  • Changing walkthrough note storage, formatting, queueing, or agent delivery.
  • Changing walkthrough navigation, close, discard, layout, or persistence.
  • Changing cancellation outcomes or separately validating runtime cancellation in comment forms outside the walkthrough.
  • Separately validating the legacy inline anchored walkthrough; it shares WalkthroughStepInner and inherits the same action set.