AI/MCP UX/UI specs

ai-ui specs/ai-ui/README.kmd

Catalog of UX/UI specs for AI and MCP (Model Context Protocol) components in Koder Stack. Companion implementation lives in `engines/sdk/koder_kit/lib/src/ai/` (ticket koder_kit#034). Umbrella tracker: ticket #099.

Quando esta spec se aplica

Todos os triggers

AI/MCP UX/UI specs index

Esta seção cobre as 23 specs de UX/UI para componentes AI e MCP no Koder Stack, conforme umbrella ticket #099.

Diferente de specs/themes/ (Material parity baseline + Expressive), estas specs cobrem patterns que vivem fora do Material spec — MCP UI requirements (modelcontextprotocol.io SHOULD-level), patterns emergentes de Claude/ChatGPT/Gemini desktop apps, e specs canônicas de elicitation/sampling do MCP.

Estrutura

A. MCP-specific (5 specs)

SpecStatusPrioridade
mcp-tool-invocation.kmdRATIFIEDhigh
mcp-permission-prompt.kmdRATIFIEDhigh
mcp-elicitation.kmdRATIFIEDmedium
mcp-sampling-approval.kmdRATIFIEDmedium
mcp-server-state.kmdRATIFIEDhigh

B. AI UX core (18 specs)

SpecStatusPrioridade
chat-message-bubble.kmdRATIFIEDhigh
streaming-text.kmdRATIFIEDhigh
thinking-state.kmdRATIFIEDmedium
agent-step-trace.kmdRATIFIEDmedium
code-block.kmdRATIFIEDmed-high
artifact-panel.kmdRATIFIEDmedium
citations.kmdRATIFIEDhigh
cost-display.kmdRATIFIEDmedium
model-selector.kmdRATIFIEDhigh
prompt-gallery.kmdRATIFIEDmedium
conversation-history.kmdRATIFIEDmedium
multimodal-input.kmdRATIFIEDhigh
memory-drawer.kmdRATIFIEDmed-high
inline-suggest.kmdRATIFIEDmedium
ai-disclaimer.kmdRATIFIEDhigh (compliance)
rfcs/ai-RFC-001-generative-ui-via-kvg.kmdRFC RATIFIED (draft, gate 1 pending)low (R&D)
voice-mode.kmdRATIFIEDmedium
system-prompt-editor.kmdRATIFIEDlow-medium

Convenções comuns

Toda spec deste subdir SHOULD seguir o pattern:

  1. R-suite normativa (R1, R2, …) com tabelas + decision trees.
  2. Per-surface bindings: Flutter (koder_kit), Web (koder_web_kit), Compose Android (koder-design-compose quando shipar), SwiftUI iOS (koder-design-swift quando shipar).
  3. T-suite testes baseline (T1, T2, …) — qualquer surface implementadora roda T-suite verde antes de release.
  4. i18n via KoderL10n (per specs/i18n/contract.kmd): en-US + pt-BR baseline; editorial copy não editável por IA autonomamente.
  5. Multi-tenant (policies/multi-tenant-by-default.kmd): persistência scoped por (koder_user_id, workspace_id).
  6. Compliance: AI disclaimer (#119) aplicável a todo widget AI consumer-facing em produto distribuído.
  • Umbrella tracker: meta/docs/stack/backlog/pending/099-ai-ui-mcp-parity-umbrella.md
  • Coverage registry: meta/docs/stack/registries/ai-ui-coverage.md
  • Bundle SDK home: engines/sdk/koder_kit/lib/src/ai/
  • MCP spec normativa (external): https://modelcontextprotocol.io/
  • Análogos: specs/auth/, specs/identity/ (estrutura), specs/voice/ (escopo)

Referências