AI/MCP UX/UI specs
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.
AIMCP UXUI 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 *ora do Material spec*— MCP UI requirements (modelcontextprotocol.io SHOULD-level), patterns emergentes de ClaudeChatGPTGemini desktop apps, e specs canônicas de elicitation/sampling do MCP.
Estrutura
A. MCP-specific (5 specs)
| Spec | Status | Prioridade |
|---|---|---|
mcp-tool-invocation.kmd |
RATIFIED | high |
mcp-permission-prompt.kmd |
RATIFIED | high |
mcp-elicitation.kmd |
RATIFIED | medium |
mcp-sampling-approval.kmd |
RATIFIED | medium |
mcp-server-state.kmd |
RATIFIED | high |
B. AI UX core (18 specs)
| Spec | Status | Prioridade |
|---|---|---|
chat-message-bubble.kmd |
RATIFIED | high |
streaming-text.kmd |
RATIFIED | high |
thinking-state.kmd |
RATIFIED | medium |
agent-step-trace.kmd |
RATIFIED | medium |
code-block.kmd |
RATIFIED | med-high |
artifact-panel.kmd |
RATIFIED | medium |
citations.kmd |
RATIFIED | high |
cost-display.kmd |
RATIFIED | medium |
model-selector.kmd |
RATIFIED | high |
prompt-gallery.kmd |
RATIFIED | medium |
conversation-history.kmd |
RATIFIED | medium |
multimodal-input.kmd |
RATIFIED | high |
memory-drawer.kmd |
RATIFIED | med-high |
inline-suggest.kmd |
RATIFIED | medium |
ai-disclaimer.kmd |
RATIFIED | high (compliance) |
rfcs/ai-RFC-001-generative-ui-via-kvg.kmd |
RFC RATIFIED (draft, gate 1 pending) | low (R&D) |
voice-mode.kmd |
RATIFIED | medium |
system-prompt-editor.kmd |
RATIFIED | low-medium |
Convenções comuns
Toda spec deste subdir SHOULD seguir o pattern:
- *-suite normativa*(R1, R2, …) com tabelas + decision trees.
- *er-surface bindings* Flutter (
koder_kit), Web (koder_web_kit),Compose Android (
koder-design-composequando shipar), SwiftUI iOS (koder-design-swiftquando shipar). - *-suite testes baseline*(T1, T2, …) — qualquer surface
implementadora roda T-suite verde antes de release.
- *18n via
KoderL10n*(perspecs/i18n/contract.kmd):en
US + ptBR baseline; editorial copy não editável por IA autonomamente. - *ulti
tenant*(`policies/multitenantbydefault.kmd`):persistência scoped por
(koder_user_id, workspace_id). - *ompliance* AI disclaimer (#119) aplicável a todo widget
AI consumer-facing em produto distribuído.
Cross-link
- 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)