Interface

Specs

• A11y theme modes (color-blind, low-vision) themes/a11y-modes.kmd

  Two additional theme modes alongside Verge light/dark — `color-blind`

• AI CLI/TUI Status and Recap Hooks ai-ui/agent-cli-status-and-recap.kmd

  Standardizes terminal-based status lines (ANSI LEDs), turn-closing indicators,

• AI agent state hooks (useKoderAgent / useKoderChat) patterns/ai-agent-state-hooks.kmd

  Framework-neutral state-machine contract for any AI chat / agent

• AI agent step trace ai-ui/agent-step-trace.kmd

  Vertical step list + per-step expand (tool call, args, result, duration)

• AI artifact panel ai-ui/artifact-panel.kmd

  Side panel split-screen (desktop/web) or bottom sheet (mobile) for

• AI chat message bubble ai-ui/chat-message-bubble.kmd

  Baseline message bubble for any AI chat surface in Koder Stack:

• AI chat surface primitives patterns/ai-chat-surface.kmd

  Six composable primitives for assembling an AI chat surface in any

• AI citations / source attribution ai-ui/citations.kmd

  Footnote-style inline citations + hover/long-press preview cards +

• AI code block ai-ui/code-block.kmd

  AI-generated code rendering with language detection, syntax highlight,

• AI conversation history ai-ui/conversation-history.kmd

  Sidebar of past AI conversations: date-grouped (Today / Yesterday /

• AI cost display ai-ui/cost-display.kmd

  Per-message badge + session header total + breakdown drawer for AI

• AI feature visual language patterns/ai-feature-visual-language.kmd

  Canonical visual lexicon for distinguishing AI-driven surfaces from

• AI generated content disclaimer ai-ui/ai-disclaimer.kmd

  Risk-tiered disclaimer mechanism for AI-generated content in Koder

• AI inline suggest / ghost text ai-ui/inline-suggest.kmd

  Copilot-style ghost text autocomplete in any Koder editor surface

• AI memory drawer ai-ui/memory-drawer.kmd

  Drawer to edit AI persistent memory: list/search/edit/delete items;

• AI model selector ai-ui/model-selector.kmd

  Dropdown/menu for choosing AI model mid-conversation. Capability chips

• AI multimodal input composer ai-ui/multimodal-input.kmd

  Unified composer for text + image + file + voice input. Drag-and-drop

• AI prompt template gallery ai-ui/prompt-gallery.kmd

  Grid filterable de prompt templates: categoria + tag + author + provider

• AI streaming text ai-ui/streaming-text.kmd

  Token-by-token reveal of AI-generated text with cursor, Stop button,

• AI system prompt editor ai-ui/system-prompt-editor.kmd

  Advanced power-user editor for system prompts (Claude Projects style /

• AI thinking state ai-ui/thinking-state.kmd

  Collapsible "Thinking..." block for reasoning models (Claude extended

• AI voice mode UI ai-ui/voice-mode.kmd

  Fullscreen voice conversation mode UI: waveform (input/output color-coded),

• AI welcome / first-run screen patterns/ai-welcome-screen.kmd

  First-message hero an AI chat surface renders when the user hasn't

• AI/MCP UX/UI specs ai-ui/README.kmd

  Catalog of UX/UI specs for AI and MCP (Model Context Protocol)

• Accessibility conformance (BR) accessibility/conformance-br.kmd

  How a Koder surface declares accessibility conformance against the three

• Accessibility nutrition labels accessibility/nutrition-labels.kmd

  Public per-product manifest declaring which accessibility features

• Action sheet component components/action-sheet.kmd

  A context-anchored set of choices for the current task — slides up from

• Adaptive layouts (list-detail, supporting-pane, feed) app-layout/adaptive-layouts.kmd

  Three canonical responsive layouts — list-detail, supporting-pane,

• Admin data table pattern patterns/admin-data-table.kmd

  Canonical composition pattern for Koder admin tools that list typed

• Android Compose bindings catalog develop/android-compose.kmd

  Native Android Jetpack Compose surface for Koder Design — the

• Approval gate pattern patterns/approval-gate.kmd

  A paused step that waits for an authorized human to approve or reject a

• Audit Frontmatter audit/frontmatter.kmd

  Convenção do bloco `audit:` em frontmatter YAML de specs e policies

• Audit log surface patterns/audit-log.kmd

  The immutable, filterable trail of "who did what, when" for a tenant —

• Avatar component components/avatar.kmd

  The visual representation of a person or entity — photo with initials

• Binary, CLI and Desktop App Naming binaries-and-cli/naming.kmd

  Nomenclatura canônica para executáveis: binário k<slug>, dir

• Brand Score (naming) naming/brand-score.kmd

  Fórmula do Brand score (Type/Pron/Son/Mem), bandas de rating, checklist

• Browser and platform support matrix develop/browser-support.kmd

  Published support contract for kds.koder.dev and every koder_web_kit

• CNPJ (alphanumeric) data/cnpj.kmd

  Validation + format rules for the Brazilian CNPJ company identifier,

• CRUD page template patterns/crud-page.kmd

  The list → detail → edit scaffold for managing records of one entity:

• Callout card pattern patterns/callout-card.kmd

  Dismissible in-product nudge — illustration + heading + body +

• Charts (line / bar / area / pie / scatter / graph) components/charts.kmd

  Canonical chart primitives — line / bar / stacked-bar / area /

• Chat Channel Capability Matrix chat-channels/capability-matrix.kmd

  Canonical feature surface that every Koder bot chat channel

• Code review surface patterns/code-review.kmd

  The pull-request review surface: a diff (diff-viewer) overlaid with

• Combobox (typeahead select) components/combobox.kmd

  Typeahead input + dropdown of filtered options with optional async

• Command Structure commands/structure.kmd

  Estrutura canônica de um comando `/k-*` em `meta/context/commands/`:

• Component Naming Forms naming/forms.kmd

  Forms of reference for every Koder Stack component: type, display name,

• Confirmation page pattern patterns/confirmation-page.kmd

  The receipt surface shown AFTER a user successfully completes a

• Content overflow pattern patterns/content-overflow.kmd

  What to do when content exceeds its container: truncate with an

• Content-Security-Policy — canonical posture for Koder Flow + sibling apps security/csp.kmd

  Normative CSP posture for Koder Flow and every sibling Koder web

• DS Studio design-system/ds-studio.kmd

  O contrato do DS Studio — a surface que evolui o Themer (`/themer/`) pra

• Dashboard page template patterns/dashboard-page.kmd

  The analytics/overview page scaffold: a scoped filter bar, a row of

• Data field validation data/validation.kmd

  Regras canônicas de validação de campo na Koder Stack — required,

• Data table (admin-grade) components/data-table.kmd

  Admin-grade tabular component — sortable columns, multi-select with

• Date picker (single, range, time) components/date-picker.kmd

  Accessible date picker — typed ISO entry + calendar grid for single

• Develop — Wear OS develop/wear-os.kmd

  Wear OS 6 surface contract: EdgeButton (arc-shaped), Primary Layout

• Diff viewer component components/diff-viewer.kmd

  The component that renders a source-code diff in a code-hosting surface:

• ESIGN digital signature — Koder Signer US profile (stub) signing/esign.kmd

  US profile (`?jurisdiction=us`) of the Koder Signer service per

• Empty state pattern patterns/empty-state.kmd

  Purpose-built UI for "no data yet" surfaces — illustration + heading

• Error Model (canonical error envelope) errors/model.kmd

  O envelope canônico, máquina-legível, de um erro na Koder Stack: os campos

• Error Reporting (all modules) errors/reporting.kmd

  Relatório de erros para todos os módulos Koder: toggle "Relatório

• Error Taxonomy (classes, severity, retryability) errors/taxonomy.kmd

  Vocabulário canônico de erros da Koder Stack: o enum fechado de CLASSES

• Error page template patterns/error-page.kmd

  The full-page error template (404 / 500 / permission / expired session):

• Errors facet — index errors/README.kmd

  Índice navegável (não-autoritativo) das specs de erro da Koder Stack

• Exhaustive interaction-driven visual parity (drive every event over every element, capture the dynamic result, compare against a reference) develop/interaction-visual-parity.kmd

  DRAFT — parent design the owner named (2026-07-05). The Koder UI-parity tooling

• External-provider OAuth client — connector-side contract auth/oauth-client-external-providers.kmd

  Normative contract for every Koder component that acts as an OAuth 2.0

• Feature deprecation / end-of-life communication patterns/deprecation.kmd

  Canonical pattern for communicating a feature's deprecation — in-app

• Feature paywall + access restriction patterns/feature-paywall.kmd

  Two sibling sub-patterns: (a) **paywall** — what surfaces when a

• Form page pattern patterns/form-page.kmd

  A single editing surface with section-grouped fields and a sticky

• Form validation pattern patterns/form-validation.kmd

  How a form tells the user what is wrong and how to fix it: inline

• Gesture TDDs for mobile UI (single/multi-finger tap · drag · parallel multi-finger drag · pinch/rotate · swipe/fling · system-edge gestures) develop/gesture-tdds.kmd

  The Koder Stack test generators MUST emit touch-gesture tests for every

• Guide cue (one-shot onboarding tooltip) components/guide-cue.kmd

  One-shot tooltip-style component with arrow + title + body +

• Haptic feedback interaction/haptics.kmd

  A semantic vocabulary for haptic feedback — impact, notification, and

• ICP-Brasil digital signature — Koder Signer contract signing/icp-brasil.kmd

  Normative contract for the Koder Signer service

• IDE integration (VSCode + Zed + JetBrains) develop/ide-integration.kmd

  Contract for in-IDE Koder Design support — spec preview on hover,

• Index filters with saved views components/index-filters.kmd

  Composite search + filter chips + saved views companion of

• Info sprinkle (inline help dot) components/info-sprinkle.kmd

  Lightweight inline help — small "i" icon next to a label that, on

• Inline definition (contextual term explainer) components/inline-definition.kmd

  Underlined term that, on hover / focus / tap, surfaces its definition

• Inline edit pattern patterns/inline-edit.kmd

  Edit a single value in place — a click-to-edit field that swaps its

• Internationalization (i18n) Cross-Surface Contract i18n/contract.kmd

  Contrato cross-surface de internacionalização da Koder Stack: idioma

• KDS docs mobile responsiveness develop/docs-mobile-responsiveness.kmd

  Audit + ongoing contract that every page on `kds.koder.dev` is

• KRDP — Koder Remote Desktop Protocol remote/krdp/protocol.kmd

  The wire contract for Koder Pilot remote access: transport (QUIC / WebTransport

• KVS activity model — PRs, issues, reviews, comments & the activity feed kvs/activity-model.kmd
• Keyboard mnemonics interaction/keyboard-mnemonics.kmd

  Alt+letter access keys ("mnemonics") for menus, menu bars, dialog

• Koder ID OAuth Flow — TDD Test Template auth/oauth-flow-test-template.kmd

  Test template normativo pra implementações da `specs/auth/oauth-flow.kmd`

• Koder ID OAuth Flow — consumer-side contract auth/oauth-flow.kmd

  Normative contract for every Koder component that authenticates

• Koder ID Passkeys / WebAuthn — RP contract + passkey-first login auth/passkeys.kmd

  Normative contract for WebAuthn/passkeys in Koder ID: the Relying-Party

• Koder ID Token Exchange — RFC 8693 delegation grant auth/token-exchange.kmd

  Normative contract for the OAuth 2.0 Token Exchange grant

• Koder Pair — peer-to-peer device pairing handshake pair/handshake.kmd

  Protocolo de handshake para pareamento peer-to-peer entre dispositivos do

• Koder Triage — chat cockpit surface (Telegram/WhatsApp) operator-cockpit/chat-cockpit-surface.kmd

  Estende o cockpit do Koder Triage (cockpit.kmd) a uma SEGUNDA superfície: o

• Koder Triage — unified inventory & triage surface operator-cockpit/cockpit.kmd

  Koder Triage é o módulo oficial unificado de inventário/triagem de objetos da

• KoderIPC Protocol ipc/protocol.kmd

  Protocolo de comunicação entre apps Koder (cross-process, cross-app

• Log viewer component components/log-viewer.kmd

  The streaming build/run log surface for Koder Pipe (CI), Hub, and any

• Login Identifier Resolution identity/login-resolution.kmd

  How Koder ID (and any SDK or library that performs client-side

• Login Identifier Resolution — TDD Test Templates identity/login-resolution-test-template.kmd

  TDD test templates for the contract in

• MCP elicitation UI ai-ui/mcp-elicitation.kmd

  UI for MCP server-initiated user input requests mid-tool-execution

• MCP integration (KDS for AI agents) develop/mcp-integration.kmd

  How AI coding agents (Claude Code, Cursor, Codex, Windsurf) connect to

• MCP permission prompt ai-ui/mcp-permission-prompt.kmd

  Consent gate UI before invoking MCP tools with side effects. Implements

• MCP sampling approval ai-ui/mcp-sampling-approval.kmd

  UI for MCP server-initiated LLM completion requests delegated to

• MCP server state ai-ui/mcp-server-state.kmd

  Connection state visibility for every MCP server attached to a Koder

• MCP tool invocation card ai-ui/mcp-tool-invocation.kmd

  Visual indicator + arguments preview + result rendering for every

• Model viewer components/model-viewer.kmd

  Interactive 3D model viewer — embed a glTF/GLB mesh that the user can

• Money input component components/money-input.kmd

  A currency-aware amount field — optional currency selector, per-currency

• Multi-step wizard patterns/wizard-multistep.kmd

  Linear or branching multi-step flow with per-step validation, step

• Navigation counters components/nav-counters.kmd

  Async-loaded count badges on navigation/tab items (e.g. "Issues 42",

• Number input component components/number-input.kmd

  A numeric field with increment/decrement steppers, min/max/step bounds,

• OUIA test hooks (data-ouia-* contract) testing/ouia-test-hooks.kmd

  Every KDS-spec'd component MUST emit Open UI Automation (OUIA)

• Onboarding / product-tour pattern patterns/onboarding.kmd

  First-run guidance: a progressive product tour of chained coach-marks

• One thing per page pattern patterns/one-thing-per-page.kmd

  A form-design constraint: each page in a flow asks the user for ONE

• Password policy identity/password-policy.kmd

  The NCSC/NIST-aligned password rules for Koder ID — the ONLY surface in

• Per-platform code samples toggle develop/code-samples-toggle.kmd

  Every component page on `kds.koder.dev` ships code samples for

• Phone input (country selector + i18n format) components/phone-input.kmd

  Country-aware phone input — country selector + locale-aware mask +

• Pointer-interaction TDDs for desktop UI (hit-test routing · pointer capture · wheel scroll-step · gesture cancellation · title-bar press) develop/pointer-interaction-tdds.kmd

  The Koder Stack test generators MUST emit pointer-interaction tests for every

• RFC frontmatter — `phases:` array rfc-frontmatter/phases.kmd

  Convention for declaring multi-phase migration plans in RFC frontmatter

• Report page template patterns/report-page.kmd

  The parameterized-report scaffold: a filter/parameter panel, a Run

• SVID Workload Identity Scheme naming/svid-identity.kmd

  The SPIFFE-style URI scheme for internal service identities (SVIDs) issued by

• Scoped Consent Tokens identity/consent.kmd

  Koder ID issues, validates, and revokes signed, scoped consent

• Service Registry Contract discovery/service-registry-contract.kmd

  The runtime service-discovery contract of the Koder Cloud: how a service

• Settings Patterns settings/patterns.kmd

  Convenção mestre de tela Settings em apps Koder: hierarquia canônica de

• Skeleton (loading placeholder) components/skeleton.kmd

  Skeleton placeholder primitives — block / line / circle / image —

• Snapshot manifest format (.kvg) snapshots/manifest.kmd

  Normative format for the Koder Snapshot manifest (`.kvg` — Koder Value

• Standard CLI Flags for Koder Apps binaries-and-cli/standard-flags.kmd

  Toda app Koder com binário CLI/desktop/TUI (Flutter desktop,

• State label component components/state-label.kmd

  The status pill for a code-hosting entity (issue or pull request) whose

• Task list pattern patterns/task-list.kmd

  Section-level overview for LONG, multi-part journeys split into named

• Tree view component components/tree-view.kmd

  Hierarchical, expandable/collapsible list for nested data — file

• UI Quality Score (UQS) design/ui-quality-score.kmd

  Índice composto 0–100 da qualidade de UI de uma surface (tela/form/ícone/

• UI interaction performance — request→painted latency tiers testing/ui-interaction-perf.kmd

  Normative contract for measuring, comparing and gating the latency of

• VCS activity timeline patterns/vcs-activity-timeline.kmd

  The chronological event stream on a code-hosting issue or pull request:

• Variantes — Taxonomy variants/taxonomy.kmd

  Define o termo **variante** como instância executável de um componente

• Voice — Wake-word + Talk Mode (settings + privacy) voice/wake-word.kmd

  Toggles obrigatórios em Settings (`voice.enabled`, `voice.talkMode`,

• Wire/API compatibility — Koder Flow vs upstream Forgejo wire-compat/flow-vs-forgejo.kmd

  Normative contract for the wire/API surfaces Koder Flow promises to

• Workflow Executor Protocol workflow/executor-protocol.kmd

  Contrato de como o engine do Koder Workflow (services/ai/workflow) invoca

• XR developer preview develop/xr-preview.kmd

  Forward-looking spec for Koder Design on XR surfaces (Vision Pro,

• XR — canonical composables develop/xr-composables.kmd

  Material 3 XR canonical composables: Orbiter, SpatialPanel,

• consent-record privacy/consent-record.kmd
• contract cache-purge/contract.kmd
• eIDAS digital signature — Koder Signer EU profile (stub) signing/eidas.kmd

  EU profile (`?jurisdiction=eu`) of the Koder Signer service per

• i18n TDD Test Template (Cross-Surface) i18n/test-template.kmd

  Template normativo de testes TDD pra validar conformidade com

• i18n leak detection i18n/leak-detection.kmd

  Detection contract for "i18n leaks" — user-facing string literals

• iOS SwiftUI bindings catalog develop/ios-swiftui.kmd

  Native iOS SwiftUI surface for Koder Design — the set of SwiftUI

• kds-public-api api/kds-public-api.kmd