Skip to main content

UI and interaction guidelines

Keep objects, data, and operation status consistent with the tool service. Make the active object and progress clear.
PartResponsibility
InterfacePresent results and accept selections, input, and actions
Tools and servicesQuery data, perform operations, and return results
Configuration and resourcesProvide client entry points and dependencies
Conversation and instructionsExplain how to open the interface, interpret results, and continue

Layout and accessibility

Keep frequent actions and main results easy to find. Adapt to the available workspace. Use readable controls, text descriptions for status, and a usable keyboard and focus order.

State and communication

Define the source of truth for the active resource, selection, and operation progress. A response from an old request must not overwrite a newer selection. Display completion only after the tool confirms success. On service failure, keep the last valid state and explain the cause and available next action.

Loading and errors

Distinguish loading, empty data, failure, cancellation, and completion. Explain the next available action after failure. Distinguish stopping the interface wait from stopping the background task, and report the result of each.

Permissions and confirmation

Explain service authorization. Before an operation that requires confirmation, describe its target and effects and wait for confirmation. Explain how to resolve insufficient permissions. Quickstart · Interaction checklist · Plugin specification