Skip to content

Human UX Guide

Jump to bottom
Nick Rygiel edited this page Jul 4, 2026 · 1 revision

Human UX Guide

pwcli-core treats conversational UI as a control plane. The user should see what the system inferred, what panel or route will hydrate, what costs or risks matter, and what will happen after approval.

Disclosure Modes

  • Basic: read-only or reversible work can move quickly, but should leave a clear receipt.
  • Intermediate: show intent, confidence, side-effect level, candidate primitive, costs, risks, and approval before consequential work.
  • Advanced: expose full payloads, source records, interpretation, provenance, fallback route, execution target, and rollback policy.

Primitive UX Fields

The primitive schema now supports optional UX metadata:

  • primaryAction
  • previewFields
  • riskLabels
  • costFields
  • emptyState
  • loadingState
  • errorState
  • undoPolicy

These fields do not execute behavior. They make preview and approval UI predictable.

Clone this wiki locally