Ask Sphere

Ask Sphere is the copilot layered on the SCAN board: natural-language design, suggested prompts, and one-click fixes from warnings.

Ask Sphere needs the AI backend for your deployment to be reachable. If it isn't, the bar still accepts prompts, but Send returns an error instead of a result.

Edits are applied directly to the board — there is no preview/apply step. The agent calls tools (add/update/remove component, connect, etc.) that mutate the board's SCAN YAML in place; use Ctrl/Cmd+Z to undo a result you don't want.

AI command bar

Centered under the top bar. Placeholder: Ask Sphere to design or modify this architecture…

1. Type a request, or focus the field to see Suggested commands and Recent prompts.
2. Send or press Enter. The button reads Thinking… while the request is in flight.
3. Sphere applies the resulting changes to the board immediately.

Bar controls

Control	Role
Attach (paperclip)	Attach a reference file (text, Markdown, PNG, JPEG) to the prompt
Voice (mic)	Dictate into the prompt; disabled where voice input isn't available
Send	Submit the prompt

Example prompts

Goal	Prompt
Add a slice	Add an inventory service using Spring Boot and PostgreSQL
Wire systems	Connect Order API to Payment Platform using its payment authorization API
Events	Create Kafka events for order creation and payment completion
Agents	Add an agent runtime that can generate and review these services
Focus	Show only the external integrations
Quality	Highlight services without API contracts
Layout	Group all commerce services inside a trust boundary

Contextual Ask Sphere

• On-canvas chips — select a component; chips appear above the node.
• Inspector — same chips; if the node has a warning, Ask Sphere to fix appears.
• Warning toast — bottom-center architecture warnings (from YAML status: warn and the architect agent). Ask Sphere to fix selects the component and runs a remediation prompt.

Command palette

⌘K / Ctrl+K (or the search field / Palette button). Jump to components, actions, and views. Esc closes.