Reference

accessibility/conformance-br.kmd

How a Koder surface declares accessibility conformance against the three Brazilian-relevant standards at once: WCAG 2.2 AA (technical baseline), eMAG 3.1 (Modelo de Acessibilidade em Governo Eletrônico), and LBI — Lei Brasileira de Inclusão (Lei 13.146/2015, arts.

accessibility/nutrition-labels.kmd

Public per-product manifest declaring which accessibility features the product supports — screen-reader, keyboard-only, captions, dynamic-type, reduced-motion, color-blind-mode, high-contrast, voice-control.

accessibility/personas.kmd

Inventory of 8 archetypal personas covering the four ability axes (vision / motor / cognition / hearing) in the three permanence states (permanent / temporary / situational).

ai/agent-stream.kmd

ai/kviq.kmd

ai/skill-format.kmd

ai-ui/README.kmd

Catalog of UX/UI specs for AI and MCP (Model Context Protocol) components in Koder Stack.

ai-ui/agent-cli-status-and-recap.kmd

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

ai-ui/agent-step-trace.kmd

Vertical step list + per-step expand (tool call, args, result, duration) + plan-and-execute (plan pre-render before run) + time-travel replay + branching for multi-step AI agents.

ai-ui/ai-disclaimer.kmd

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

ai-ui/artifact-panel.kmd

Side panel split-screen (desktop/web) or bottom sheet (mobile) for AI-generated artifacts: code, KVG, markdown, HTML, mermaid diagrams. Live edit with diff context to AI on next message.

ai-ui/chat-message-bubble.kmd

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

ai-ui/citations.kmd

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

ai-ui/code-block.kmd

AI-generated code rendering with language detection, syntax highlight, copy button, optional run button, diff view, and defer-until-fence contract during streaming.

ai-ui/conversation-history.kmd

Sidebar of past AI conversations: date-grouped (Today / Yesterday / Last 7 days / Older), search (literal + semantic), pin/archive/delete, auto-titulation, cross-device sync.

ai-ui/cost-display.kmd

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

ai-ui/inline-suggest.kmd

Copilot-style ghost text autocomplete in any Koder editor surface. Dimmed inline suggestion + Tab/→ to accept + Esc to discard + partial-accept (word/line).

ai-ui/mcp-elicitation.kmd

UI for MCP server-initiated user input requests mid-tool-execution. Form mode (schema-driven) for inline fields; URL mode for external credentials.

ai-ui/mcp-permission-prompt.kmd

Consent gate UI before invoking MCP tools with side effects.

ai-ui/mcp-sampling-approval.kmd

UI for MCP server-initiated LLM completion requests delegated to the client (which has model + credentials + cost tracking).

ai-ui/mcp-server-state.kmd

Connection state visibility for every MCP server attached to a Koder client.

ai-ui/mcp-tool-invocation.kmd

Visual indicator + arguments preview + result rendering for every MCP tool call executed by a Koder client.

ai-ui/memory-drawer.kmd

Drawer to edit AI persistent memory: list/search/edit/delete items; audit log per item ("added by AI/user on X"); 4 categories matching Claude memory model (user/project/feedback/reference); export/import as markdown bundle.

ai-ui/model-selector.kmd

Dropdown/menu for choosing AI model mid-conversation.

ai-ui/multimodal-input.kmd

Unified composer for text + image + file + voice input.

ai-ui/prompt-gallery.kmd

Grid filterable de prompt templates: categoria + tag + author + provider. Preview, variable fill dialog (JSON Schema-driven; compat MCP prompts/list), favorite/star, share via Hub.

ai-ui/streaming-text.kmd

Token-by-token reveal of AI-generated text with cursor, Stop button, Retry, autoscroll, and incremental markdown rendering.

ai-ui/system-prompt-editor.kmd

Advanced power-user editor for system prompts (Claude Projects style / ChatGPT Custom GPTs).

ai-ui/thinking-state.kmd

Collapsible "Thinking..." block for reasoning models (Claude extended thinking, DeepSeek R1, OpenAI o-family).

ai-ui/voice-mode.kmd

Fullscreen voice conversation mode UI: waveform (input/output color-coded), push-to-talk + always-on toggle, barge-in visual, mute, end session. Extends voice/wake-word.kmd with conversational mode semantics.

api/kds-public-api.kmd

app-layout/adaptive-layouts.kmd

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

app-layout/canonical-layouts.kmd

4 canonical layout templates that cover ~90% of Koder UI screens. Each defines element placement, behavior across window-size classes, and accessibility contract.

app-layout/pane-scaffolds.kmd

Material 3 Adaptive pane scaffolds — concrete APIs that materialize the canonical layouts (Feed/List-detail/Supporting/Custom) from canonical-layouts.kmd.

app-layout/safe-area.kmd

Consumo obrigatório de window-insets (status bar, nav bar, display cutout, IME) em todos os apps Koder.

app-layout/topbar-placement.kmd

Posição canônica do avatar (KoderUserBadge) e demais elementos primários da topbar em todos os apps Koder, per surface (web, desktop tradicional, desktop browser/IDE, mobile, TV, CLI/TUI).

app-layout/window-size-classes.kmd

4 canonical window-size classes (Compact / Medium / Expanded / Large) that Koder UIs adapt to.

audit/frontmatter.kmd

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

auth/oauth-client-external-providers.kmd

Normative contract for every Koder component that acts as an OAuth 2.0 *client* (relying party) against a THIRD-PARTY provider — Google, Microsoft, GitHub — to ingest the user's external data (Gmail, Drive, Cloud, Outlook, repos).

auth/oauth-flow-test-template.kmd

Test template normativo pra implementações da `specs/auth/oauth-flow.kmd`. T1-T8 baseline behavioral (R3-R9 do contrato) + I1-I3 integração com Koder ID staging + N1-N4 negativos.

auth/oauth-flow.kmd

Normative contract for every Koder component that authenticates end-users.

auth/passkeys.kmd

Normative contract for WebAuthn/passkeys in Koder ID: the Relying-Party configuration (RPID/origins per environment), the credential lifecycle (registration/enrollment, authentication, sign-count, revocation), and the two authentication modes — passkey as MFA (second factor after password, already shipped) and **passkey-first / passwordless-primary** (login with a passkey and no password, tracked in services/foundation/id/engine#212).

auth/token-exchange.kmd

Normative contract for the OAuth 2.0 Token Exchange grant (RFC 8693) on Koder ID.

autonomy/grant-contract.kmd

backlog/numbering.kmd

Numeração de tickets no monorepo é sequencial por backlog no disco

binaries-and-cli/naming.kmd

Nomenclatura canônica para executáveis: binário k<slug>, dir /opt/koder/<slug>/, D-Bus ID dev.koder.<slug>, symlink em /usr/local/bin/, .desktop file, aliases de compatibilidade.

binaries-and-cli/standard-flags.kmd

Toda app Koder com binário CLI/desktop/TUI (Flutter desktop, Bubble Tea TUI, cobra CLI) deve aceitar um conjunto comum de flags com contrato preciso: `--version` e `--help` que terminam **antes** de qualquer init de GUI/runtime; `--user-data-dir` que isola profile/cache da sessão real do usuário; `--no-startup-window` que desacopla boot do runtime de criação de janela top-level.

cache-purge/contract.kmd

chat-channels/capability-matrix.kmd

Canonical feature surface that every Koder bot chat channel (Telegram, WhatsApp, WebChat, Signal, Google Chat, Koder Chat, and future) must declare via `Channel.Capabilities()`.

code/anti-patterns.kmd

Catálogo cross-language de anti-patterns proibidos: eval/dynamic exec sem audit, magic numbers, god classes, deep nesting, mutable global state, singleton sem DI, catching genérico, null propagation, premature optimization, boolean trap.

code/comments.kmd

Filosofia e regras de comentários cross-language: WHY-not-WHAT por default; comentário só quando o motivo é não-óbvio; doc comments per-lang com formato canônico; TODO/FIXME/HACK com handle + ticket; commented-out code proibido; license header quando aplicável; module docstring quando obrigatório.

code/error-handling.kmd

Padrões cross-language pra tratamento de erro internal: errors-as-values vs exceptions per-lang, error wrapping/chaining, panic/abort policy, recovery boundaries (top-level, request, goroutine), regra "log XOR throw" (não fazer ambos), sentinel/typed errors, resource cleanup on error.

code/functions.kmd

Design de funções/métodos cross-language: length limits (soft 30 /

code/imports.kmd

Padrão cross-language pra organização de imports/use/require:

code/indentation.kmd

Indentação canônica da Koder Stack: **2 espaços** em todas as linguagens (exceto Makefiles onde a sintaxe exige tab).

code/languages/koda-style.kmd

Style guide específico de Koder Koda (`engines/lang/koda`): token grammar (base pra syntax highlighting), order de imports/declarações, doc comment style (#: triple-line), anti-patterns recorrentes (array aliasing writeback #750, implicit globals).

code/naming.kmd

Convenções de naming cross-linguagem da Koder Stack: variables/funcs per idiom da linguagem, classes/types sempre PascalCase, constantes SCREAMING_SNAKE_CASE, files snake_case (códigos) ou kebab-case (.kmd), acronyms tratados como palavra (HttpClient não HTTPClient), booleans com prefixo is_/has_/can_/should_.

code/project-layout.kmd

Layout intra-módulo per linguagem: source root, tests location, fixtures/testdata, resources/assets, build artifacts (gitignored), generated code, config files, docs, examples.

commands/structure.kmd

Estrutura canônica de um comando `/k-*` em `meta/context/commands/`: frontmatter obrigatório (name, type, category, inputs, outputs, requires), seções obrigatórias (descrição, sintaxe, fases numeradas, regras, exemplos), declaração de cada fase como `deterministic` ou `analytical` (Code First), audit block opcional.

components/action-sheet.kmd

A context-anchored set of choices for the current task — slides up from the bottom on phones, presented as a popover on larger screens — used especially to confirm a destructive action with an explicit Cancel. Distinct from a dialog (which interrupts for an unrelated decision) and from a sheet (which holds content, not a choice list).

components/app-bars.kmd

Horizontal bar anchored at the top or bottom of an application surface — holds page title, primary navigation actions, and contextual actions.

components/avatar.kmd

The visual representation of a person or entity — photo with initials and generic-icon fallbacks, a size scale, optional presence indicator — plus the overlapping avatar group (face pile) with a "+N" overflow. Modeled after Atlassian Avatar / AvatarGroup.

components/badges.kmd

Small visual marker attached to another element, signalling presence of notifications, unread count, or status.

components/banners.kmd

Persistent informational bar at the top of a content region — carries a message and 1-2 actions.

components/button-groups-expressive.kmd

Material 3 Expressive extension to base button groups (specs/components/buttons.kmd §Button groups).

components/buttons.kmd

Button system — 7 variants (filled, tonal, outlined, text, elevated, icon, FAB), button groups, segmented buttons.

components/cards.kmd

Card — a container of related content + actions, typically clickable as a whole.

components/carousels-expressive.kmd

Material 3 Expressive extension to base Hero carousel (specs/components/ carousels.kmd).

components/carousels.kmd

Horizontally scrolling stack of items, optimized for browsing a collection at a glance.

components/charts.kmd

Canonical chart primitives — line / bar / stacked-bar / area / scatter / pie / donut / sparkline / graph (node-edge).

components/checkbox.kmd

Binary toggle in a multi-select context — user marks 0..N options. Material parity (`/components/checkbox/overview`).

components/chips.kmd

Compact element representing an entity, attribute, or action — smaller than a button and used in groups.

components/code-block.kmd

Code-block widget — the multi-framework code-tabs surface that hosts per-format code samples behind a shared tab strip (HTML / Flutter / Compose / SwiftUI / Web Components), with a per-tab copy button and a transient "Copied" toast.

components/combobox.kmd

Typeahead input + dropdown of filtered options with optional async loading, custom-value support, and multi-select variant.

components/data-table.kmd

Admin-grade tabular component — sortable columns, multi-select with bulk actions, sticky header, pagination or virtualization, saved column views, expandable rows, inline edit.

components/date-picker.kmd

Accessible date picker — typed ISO entry + calendar grid for single date / date range / date+time.

components/dialogs.kmd

Modal interruption surface — basic dialog (centered modal), full-screen dialog (mobile/onboarding), and alert dialog (destructive confirm). Material parity (`/components/dialogs`).

components/diff-viewer.kmd

The component that renders a source-code diff in a code-hosting surface: split (side-by-side) and unified (inline) modes, per-file sticky header with collapse + stats, expandable context hunks, line-level add/remove/ context styling, and anchors for inline review comments.

components/dividers.kmd

Thin line separating content groups within a single surface. Material parity (`/components/dividers`).

components/fab-menu.kmd

Material 3 Expressive FAB menu — successor of legacy "speed-dial". ToggleFloatingActionButton + N FloatingActionButtonMenuItems with staggered spring expansion + shape morph (FAB → "X").

components/guide-cue.kmd

One-shot tooltip-style component with arrow + title + body + optional CTA, surfaces a single feature discovery, persists per-user so it never re-shows after dismissal.

components/index-filters.kmd

Composite search + filter chips + saved views companion of

components/info-sprinkle.kmd

Lightweight inline help — small "i" icon next to a label that, on hover / focus / tap, surfaces a short tooltip.

components/inline-definition.kmd

Underlined term that, on hover / focus / tap, surfaces its definition in a popover without navigating away.

components/lists.kmd

Vertical stack of related items, each row showing a label and optional leading / trailing elements.

components/loading-indicator.kmd

Material 3 Expressive Loading indicator — distinct from Progress indicators.

components/log-viewer.kmd

The streaming build/run log surface for Koder Pipe (CI), Hub, and any product that shows machine output: monospace append-only stream with ANSI color, collapsible step groups, search, follow-tail autoscroll, virtualization for huge logs, plus a companion job/workflow DAG graph for multi-step builds.

components/menus.kmd

Floating list of choices anchored to a trigger — opens on demand, closes after a choice or dismiss.

components/model-viewer.kmd

Interactive 3D model viewer — embed a glTF/GLB mesh that the user can orbit, zoom and (on capable devices) place in AR.

components/money-input.kmd

A currency-aware amount field — optional currency selector, per-currency decimal precision, locale-grouped formatting on blur, robust parsing of what the user types, and a minor-unit storage contract.

components/nav-counters.kmd

Async-loaded count badges on navigation/tab items (e.g.

components/navigation.kmd

Primary navigation surfaces for switching between top-level

components/number-input.kmd

A numeric field with increment/decrement steppers, min/max/step bounds, precision, and locale-aware formatting — the base for quantities, counts, durations, and dimensions.

components/phone-input.kmd

Country-aware phone input — country selector + locale-aware mask + ISO E.164 normalization on storage.

components/pickers.kmd

Compound controls for selecting a date, time, date range, or date-time.

components/progress-indicators.kmd

Visual feedback that an operation is in progress — linear (bar) or circular (spinner), determinate (known %) or indeterminate (unknown duration).

components/radio-buttons.kmd

Single-select from N mutually exclusive options.

components/search-view.kmd

Full-screen / overlay search experience triggered from a search field — shows suggestions, recent queries, and live results as the user types.

components/sheets.kmd

Surface anchored to an edge of the screen, slidable to reveal secondary content — bottom sheets (mobile primary) and side sheets (tablet/desktop).

components/skeleton.kmd

Skeleton placeholder primitives — block / line / circle / image — that mirror the final content shape during load.

components/sliders.kmd

Single-handle or range-handle control for selecting a numeric value along a continuous or discrete scale.

components/snackbars.kmd

Transient feedback message at the bottom of the screen — confirms an action, optionally offers a single action (undo, retry).

components/split-button.kmd

Material 3 Expressive composite button: primary action + separate menu trigger side-by-side, divided.

components/state-label.kmd

The status pill for a code-hosting entity (issue or pull request) whose value is drawn from a per-entity state machine, not a free tag.

components/switch.kmd

ON/OFF toggle with immediate effect.

components/tabs.kmd

Horizontal navigation within a single context — primary tabs (top of content) and secondary tabs (filter within tab).

components/text-fields.kmd

Text input control — 2 variants (filled, outlined), single-line and multi-line, with label, helper text, error state, leading/trailing icons, character counter.

components/toolbars.kmd

Material 3 Expressive Toolbars — substituem o legado Bottom App Bar. Two variants: docked (anchored bottom, 56dp) and floating (horizontal bottom-center OR vertical side, hide-on-scroll).

components/tooltips.kmd

Brief contextual label revealing the name or description of a UI element on hover, focus, or long-press.

components/tree-view.kmd

Hierarchical, expandable/collapsible list for nested data — file explorers, settings navigation, nested categories, org structures — with optional tri-state cascading checkboxes, lazy child loading, and full keyboard + ARIA tree semantics.

content/grammar-and-mechanics.kmd

Ratified mechanical rules: capitalization, punctuation, numbers, brand-name handling, abbreviations, Oxford comma.

content/plain-language-ptbr.kmd

The Brazilian-Portuguese localization of the plain-language rule: a "burocratês → linguagem simples" term registry plus a lint that flags bureaucratic/legalese phrasing in pt-BR UI copy and suggests the plain equivalent.

content/plain-language.kmd

Reading-level target (Flesch-Kincaid ≤ grade 8 for body; ≤ 6 for primary actions and onboarding) + 5 mechanical rules that drop cognitive load for non-native speakers and cognitively diverse users.

content/voice-and-tone.kmd

Persistent voice across all Koder surfaces (4 traits) + tone matrix varying by context (success / error / first-run / marketing / AI-generated).

data/cnpj.kmd

Validation + format rules for the Brazilian CNPJ company identifier, including the RFB Instrução Normativa 2.229/2024 ALPHANUMERIC CNPJ that begins issuance July 2026.

data/field-types.kmd

Catálogo canônico dos tipos de dado de campo na Koder Stack — o conjunto fechado de tipos primitivos e semânticos (string, text, int, decimal, bool, date, datetime, uuid, enum, email, phone, money, cpf, cnpj, cep, url, json, binary-ref) com sua representação canônica de armazenamento, faixa/limite default e regras de preenchimento.

data/masks.kmd

Máscaras de apresentação para os tipos semânticos da Koder Stack — CPF, CNPJ, CEP, telefone, data, dinheiro, percentual.

data/validation.kmd

Regras canônicas de validação de campo na Koder Stack — required, format/pattern, length/range, check-digit (CPF/CNPJ), cross-field, e o contrato de onde a validação roda (client + server, server é autoridade). Define como uma falha de validação vira erro de classe `VL` e popula o array `fields` do envelope (`specs/errors/model.kmd`).

design/ui-quality-score.kmd

Índice composto 0–100 da qualidade de UI de uma surface (tela/form/ícone/ layout/landing): 5 pilares (Efetividade/Eficiência/Satisfação/Visual/A11y) com pesos por profile, sinais AUTO determinísticos, gate duro de contraste e bandas Sauro–Lewis.

design-system/ds-studio.kmd

O contrato do DS Studio — a surface que evolui o Themer (`/themer/`) pra autoria de um Koder Design System inteiro, sem código, determinística e sem LLM.

design-system/manifest.kmd

O contrato do que É um Koder Design System (DS).

desktop-apps/title-bar-double-click.kmd

Como apps desktop Koder devem tratar arraste e duplo-clique na barra de título.

desktop-apps/title-bar.kmd

Como exibir o nome do produto na barra de título de apps desktop Koder (Linux/macOS/Windows).

desktop-environment/parity-model.kmd

Modelo normativo de paridade de desktop-environment (Kolide ↔ referência, p.ex.

develop/android-compose.kmd

Native Android Jetpack Compose surface for Koder Design — the set of `@Composable` widgets, theming primitives, and packaging artifacts that mirror Koder's canonical components 1:1 for apps that want a native Android build (not via Flutter).

develop/animation-parity-tdds.kmd

Companion to specs/develop/visual-regression-tdds.kmd.

develop/audio-parity-tdds.kmd

The audio sibling of specs/develop/animation-parity-tdds.kmd (visual motion) and visual-regression-tdds.kmd (static).

develop/browser-support.kmd

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

develop/code-samples-toggle.kmd

Every component page on `kds.koder.dev` ships code samples for multiple platforms — Flutter, Compose, SwiftUI, Web (HTML+CSS) — with a single toggle that switches all samples on the page in unison.

develop/docs-mobile-responsiveness.kmd

Audit + ongoing contract that every page on `kds.koder.dev` is usable on mobile screens (Compact width < 600 dp).

develop/gesture-tdds.kmd

The Koder Stack test generators MUST emit touch-gesture tests for every MOBILE UI variant (Android/iOS, and any touch surface) of every component: single-finger tap/long-press/double-tap, single-finger touch-and-drag, MULTI-finger simultaneous tap, and MULTI-finger PARALLEL touch-and-drag (two-finger scroll, pinch/zoom, rotate), plus directional swipe/fling and system-edge gestures.

develop/get-started.kmd

Cross-platform onboarding index para `kds.koder.dev/get-started/`.

develop/handoff-process.kmd

Explicit workflow for moving a design from "ratified" (spec PR

develop/ide-integration.kmd

Contract for in-IDE Koder Design support — spec preview on hover, token autocomplete, drift detection lint, and live theme preview inside the editor.

develop/interaction-visual-parity.kmd

DRAFT — parent design the owner named (2026-07-05).

develop/ios-swiftui.kmd

Native iOS SwiftUI surface for Koder Design — the set of SwiftUI Views, modifiers, and environment objects that mirror Koder's canonical components 1:1 for apps that want a native iOS build (not via Flutter).

develop/mcp-integration.kmd

How AI coding agents (Claude Code, Cursor, Codex, Windsurf) connect to the Koder Design System over Model Context Protocol.

develop/overrides-api.kmd

Defines the named-subpart Overrides API every KDS component MUST expose so consumers can swap subparts (Root, Title, Body, Icon, …) without forking the component.

develop/pointer-interaction-tdds.kmd

The Koder Stack test generators MUST emit pointer-interaction tests for every POINTER-DRIVEN DESKTOP UI surface of every component — the class of surface that gesture-tdds.kmd explicitly puts out of scope ("pointer-only desktop surfaces"). These are mouse/trackpad invariants that don't depend on the toolkit: a fresh press hit-tests to the region UNDER the pointer (never a region holding capture); a discrete wheel notch scrolls a fixed number of lines, invariant to font/cell size; a new gesture cancels an in-flight one and releases capture; a title-bar press double-clicks to maximize/restore and single-drags to rearrange.

develop/synthetic-input-and-virtual-devices.kmd

The Koder Stack test generators MUST be able to drive EVERY input a real user can produce on their computer, and to simulate the connection / disconnection of every device class — so parity tests (visual, animation, audio) and flow tests actually EXERCISE the flows end-to-end instead of stopping at a debug hook.

develop/visual-regression-tdds.kmd

Every Koder UI surface — web, Flutter (mobile/desktop), Android native, iOS native, TV — MUST ship visual-regression TDDs covering four categories: (1) viewport overflow, (2) chrome overlap (browser URL bar / OS nav bar / IME / notch), (3) decorative-element proportion, and (4) sibling decorative collision (intra-container shapes piling onto each other at narrow viewports).

develop/wear-os.kmd

Wear OS 6 surface contract: EdgeButton (arc-shaped), Primary Layout slot-based, round-display optimization, watch-face color derivation. Spec preview — no Koder product consumes Wear OS today.

develop/xr-composables.kmd

Material 3 XR canonical composables: Orbiter, SpatialPanel, SpaceToggleButton, UserSubspace, SpatialRow/Column/Box, AlertDialog spatialized.

develop/xr-preview.kmd

Forward-looking spec for Koder Design on XR surfaces (Vision Pro, Quest, Android XR).

discovery/service-registry-contract.kmd

The runtime service-discovery contract of the Koder Cloud: how a service instance registers/renews/deregisters its endpoint, how the registry expires dead instances, how a consumer opts a service into edge routing, and the health semantics — the single source of truth that the PRODUCER (Koder DNS registry, dns#015) stores and the CONSUMER (Koder Jet, jet#027) reads.

docs/generation.kmd

Tipos de documento gerados por categoria de objeto (Stack, Area, Sector, Module, Flow, RFC), requisitos de capa, regras de identidade visual e templates CSS para PDFs.

fonts/typography.kmd

Closed vocabulary of typeface roles, canonical CSS variables, hosting

foundations/adaptive-design.kmd

Koder UI is adaptive by default — single codebase serves phones, tablets, foldables, desktops, TVs, and web.

foundations/customization.kmd

How users + developers personalize Koder UI without leaving the design system.

foundations/elements.kmd

Element-level guidance for every Koder UI.

foundations/usability.kmd

Foundation guidance on applying Material 3 Expressive without sacrificing usability.

foundations/ux-writing.kmd

Voice, tone, vocabulary, and pattern guide for every user-facing string in Koder products.

git-object-format/objects-on-kdb.kmd

git-object-format/sha256-promotion.kmd

gpu/device-selection.kmd

Normative contract for how ANY Koder component that renders or decodes on a GPU decides WHICH physical GPU to use on hybrid machines (integrated iGPU vs discrete dGPU) and how it manages dGPU power.

interaction/haptics.kmd

A semantic vocabulary for haptic feedback — impact, notification, and selection families mapped to UI events — so Koder apps trigger touch feedback consistently and sparingly across platforms, always paired with a visual/audible signal and respecting the OS haptics/reduce-motion setting.

interaction/keyboard-mnemonics.kmd

Alt+letter access keys ("mnemonics") for menus, menu bars, dialog buttons, and form labels — the underlined-letter convention that lets keyboard users jump to a control without a pointer.

interaction/pull-to-refresh.kmd

Material 3 Expressive pull-to-refresh pattern: drag from top ≥ threshold triggers refresh; spring-snap release; loading indicator morphs during drag and persists until completion.

interaction/selection.kmd

How users mark/unmark items as selected — single-select, multi-select, range-select, and the visual + accessibility contract for each. Material parity (`/foundations/interaction/selection`).

interaction/states.kmd

Visual + behavioral contract for the 8 interaction states every Koder control passes through: enabled, hovered, focused, pressed, dragged, selected, activated, disabled.

ipc/protocol.kmd

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

kanon/expressions.kmd

Kanon é a linguagem de expressões de regra do governance plane da Koder Stack (stack-RFC-015): nomeada, versionada, NÃO-Turing-completa, com EBNF e corpus de conformidade próprios.

kdx/format.kmd

Formato universal de documento da Koder Stack (.kdx) — portável, autocontido, rival do PDF e melhor-estruturado.

kmd/alerts.kmd

Inline markdown alert callouts ([!NOTE] / [!TIP] / [!IMPORTANT] / [!WARNING] / [!CAUTION]) embedded in prose via the blockquote syntax, rendered with a per-type icon + semantic color token.

kmd/format.kmd

Especificação do formato KMD (Koder Markdown) — extensão de CommonMark com frontmatter YAML, cross-refs validados e blocos Koder Koda inline.

kmd/requirement-scenario.kmd

Gramática opcional, mas normativa quando usada, para expressar requisitos testáveis dentro de uma spec `.kmd`.

kmd/spec-delta.kmd

Formato e ciclo de vida do spec-delta: um `.kmd` revisável que nomeia sua spec canônica (`delta_of:`) e declara mudanças de Requirement em seções `## ADDED/MODIFIED/REMOVED Requirements`.

kode/config-format.kmd

kode/hooks.kmd

kode/skill-format.kmd

koder-app/behaviors.kmd

Comportamentos obrigatórios para todo app Koder (qualquer linguagem/ plataforma/canal): auth (Koder ID), branding, telemetria, auto-update, IPC, error reporting, i18n.

koder-app/collection-toolbar.kmd

Padrão de framework da Koder Stack para coleta de dados in-app, em TODAS as variantes de UI de TODOS os módulos.

koder-toml/category.kmd

Top-level `category` field in `koder.toml` placing each module in one of six canonical buckets.

koder-toml/design-coverage.kmd

kover/ab-report.kmd

Contrato de SAÍDA do Koder Kover: o JSON estável que `kover ab --json` e `kover gate --json` emitem para consumidores downstream (perf-gate de CI, bundle do Kortex, dashboards).

kover/capture.kmd

Define a captura (tela/vídeo/áudio) do Koder Kover e o tratamento dos dados: engine de captura (reusa kcap), metadados, tipos e categorias de dado, formatos de arquivo, organização de armazenamento (records em kdb + bytes no object-plane), retenção tiered, e o gate obrigatório de consentimento + redação antes de exportar para a Koder Observability / Kortex.

kover/protocol.kmd

Profile do protocolo de conectores do Koder Kover.

kover/scenario-dsl.kmd

Define a captura de entradas do usuário, a serialização em uma DSL de cenários reproduzíveis, e o modo espelho (executar a operação em um programa e replicá-la automaticamente em um segundo programa similar).

kpkg/format.kmd

Especificação do formato `.kpkg` (pacote universal da Koder Hub): estrutura ZIP+bootstrap, kpkg.toml, plataformas suportadas, assinatura, export targets.

kvg/format.kmd

Universal open vector format for the Koder Stack: 2D, animation, and 3D in a single self-contained document.

kvg/generative-extensions.kmd

Contract for emitting KVG from an LLM ("generative UI" — the Koder-native answer to prompt→prototype/wireframe/slide).

kvg/stencils.kmd

Stack-level system of reusable KVG object libraries ("stencils"): themed banks of parametric `kdef` primitives (BPMN, UML, ER, floor plans, furniture, civil/ mechanical/electrical/electronic, PCB/IC, signage, characters, devices, …) that any KVG editor inserts into a document.

kvs/activity-model.kmd

kvs/concurrent-merge.kmd

kvs/namespace-tree.kmd

kzip/format.kmd

Formato canônico de arquivos `.kz` gerados por `kzip`, o compactador da Koder Stack.

landing-pages/areas.kmd

Estrutura, seções e deploy das landing pages das Áreas da Koder Stack (foundation/, suite/, dev/, vertical/ e demais Áreas L1).

landing-pages/catalog.kmd

Estrutura e deploy de landing pages de **catálogo** (`platform.koder.dev`) — listagem filtrável de produtos.

landing-pages/conformance-privacy.kmd

Detector de conformance de privacidade de landing pages: uma página pública NÃO pode linkar pro repositório de código-fonte.

landing-pages/conformance-ux.kmd

Detector de conformance de UX de landing pages: responsividade mobile (breakpoints 768/480 + hamburger) e toggle de tema claro/escuro (anti-flash + color-scheme + botão).

landing-pages/download-button.kmd

Botão Download em landings de produto Koder: sempre via `<koder-download-button slug="…">` do `engines/sdk/koder_web_kit` v0.2+. URL canônica do CTA: `hub.koder.dev/apps/<slug>`.

landing-pages/institutional.kmd

Estrutura e deploy de landing pages **institucionais** (`www.koder.dev`, `company.koder.dev`) — marca Koder, não produto.

landing-pages/meta.kmd

Estrutura, IA, pipeline de render, deploy e governança do portal público de documentação da Koder Stack em `meta.koder.dev`.

landing-pages/packages.kmd

Estrutura, meta tags Open Graph + Twitter Card, e composição da OG image para páginas de pacote individual no Koder Hub (`hub.koder.dev/apps/{slug}`, `/skills/{slug}`, `/bundles/{slug}`, `/design-systems/{slug}`). Garante que sharing via WhatsApp/Facebook/Twitter/etc.

landing-pages/products.kmd

Estrutura, seções, OG image e deploy de landing pages de produtos Koder. HTML monolítico, sem deps externas, floor de idiomas en-US+pt-BR (toggle EN/PT, default en-US).

landing-pages/sectors.kmd

Estrutura e deploy de landing pages de **Sectors** (sub-divisões de Área que agrupam módulos relacionados).

landing-pages/specs.kmd

Estrutura, seções, OG image e deploy de landing pages de specs ou formatos abertos da Koder Stack — KVG, KPKG, KMD, RFCs públicas, e análogos.

messaging/cross-service-events.kmd

migrations/expand-migrate-contract.kmd

Receitas concretas pro padrão expand → migrate → contract mandado por `policies/always-on.kmd § R3.1`, por tier de storage.

multi-tenancy/contract.kmd

naming/brand-score.kmd

Fórmula do Brand score (Type/Pron/Son/Mem), bandas de rating, checklist de aplicação e alvos por categoria.

naming/forms.kmd

Forms of reference for every Koder Stack component: type, display name, bare name, slug, path, and aliases array.

naming/svid-identity.kmd

The SPIFFE-style URI scheme for internal service identities (SVIDs) issued by Koder ID for east-west mTLS (stack-RFC-009 Layer 2).

notices/broadcast-alerts.kmd

O sistema único de **alertas de broadcast** da Koder Stack: arquivos em `meta/context/notices/active/*.md` que o hook `notices-check.sh` (`UserPromptSubmit`) injeta no contexto de **toda sessão**, ANTES de qualquer ação, ordenados por prioridade, cada um com **expiração explícita** (auto-some) e/ou **disparo agendado** (`fires_on`, aparece só a partir de uma data futura — substitui `/schedule` para obrigações datadas).

observability/instrumentation-contract.kmd

Contrato único que todo binding de instrumentação Koder (Go, Dart, JS, Python, …) DEVE satisfazer.

operator-cockpit/chat-cockpit-surface.kmd

Estende o cockpit do Koder Triage (cockpit.kmd) a uma SEGUNDA superfície: o chat (Telegram + WhatsApp, via koder_root_bot).

operator-cockpit/cockpit.kmd

Koder Triage é o módulo oficial unificado de inventário/triagem de objetos da Koder Stack: ícones, nomes de componentes, tickets e assuntos/tarefas extraídos de chats (WhatsApp/Telegram).

pair/handshake.kmd

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

postgres-compat/perf-baseline-vs-pg17.kmd

postgres-compat/pg-dump-v17.kmd

privacy/consent-record.kmd

privacy/posture-schema.kmd

readmes/products.kmd

Formato canônico de README dos produtos Koder: seções obrigatórias, ordem, badges, links, idioma (en-US), regras de privacidade.

releases/packaging.kmd

Formatos canônicos de pacote por plataforma (.deb, .rpm, .apk, .AppImage, .kpkg, .msi, .dmg).

remote/krdp/protocol.kmd

The wire contract for Koder Pilot remote access: transport (QUIC / WebTransport / relay), the versioned capability handshake, the multiplexed channel set (video/input/clipboard/file/audio/device/control), codec carriage over engines/kodec, identity + connection-ID brokering (Koder ID + relay), the permission/consent model, and security.

rfc-frontmatter/phases.kmd

Convention for declaring multi-phase migration plans in RFC frontmatter so that `koder-spec-audit rfc-phase-pickup` can open backlog tickets automatically when each phase becomes eligible.

security/csp.kmd

Normative CSP posture for Koder Flow and every sibling Koder web surface (Hub, ID, KDS site, landings).

settings/patterns.kmd

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

signing/eidas.kmd

EU profile (`?jurisdiction=eu`) of the Koder Signer service per `rfcs/signing-RFC-001-multi-jurisdiction.kmd`.

signing/esign.kmd

US profile (`?jurisdiction=us`) of the Koder Signer service per `rfcs/signing-RFC-001-multi-jurisdiction.kmd`.

signing/icp-brasil.kmd

Normative contract for the Koder Signer service (`services/crypto/signer/`) covering ICP-Brasil digital signature: supported formats (PAdES, CAdES, XAdES), signature policies (AD-RB, AD-RT, AD-RV), hardware token integration (A3 via PKCS#11), file certificate (A1 PFX) loading, certificate chain validation, timestamp authority (TSA) interaction, and revocation checking (CRL + OCSP).

slo/flow.kmd

snapshots/manifest.kmd

Normative format for the Koder Snapshot manifest (`.kvg` — Koder Value Graph): file encoding (UTF-8/NFC), TOML-like section shape, required keys, and the trailing `[sig.ed25519]` block signed over canonical bytes.

sound/vocabulary.kmd

Canonical 8-cue vocabulary for UI audio in Koder products

testing/always-on-recipes.kmd

Receitas concretas pros 9 templates de teste obrigatórios em `policies/always-on.kmd § Templates de teste mandatórios`.

testing/auto-heal-selectors.kmd

testing/ouia-test-hooks.kmd

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

testing/ui-interaction-perf.kmd

Normative contract for measuring, comparing and gating the latency of reusable UI interaction primitives (open-context-menu, new-tab, focus-input, …) across every Koder surface.

themes/a11y-modes.kmd

Two additional theme modes alongside Verge light/dark — `color-blind` (deuteranopia-safe palette swap) and `low-vision` (text size +20%, font-weight ≥500, contrast floor AAA).

themes/brand-mandatory-tokens.kmd

Subset of design tokens flagged as brand-mandatory — must NEVER be overridden by a product preset or downstream consumer.

themes/color-customization.kmd

How tenants + users customize the Koder color system beyond preset picking — per-role overrides, brand color injection, accessibility presets, custom error/warning hues.

themes/color-dynamic.kmd

Generate a complete Koder color scheme from a single seed color — user-supplied (brand) or extracted from a wallpaper / hero image. Material parity (`/styles/color/dynamic/user-generated-source`, aka "Material You").

themes/color-resources.kmd

Catalog of color role exports per platform (CSS custom properties, Dart const, Compose ColorScheme, SwiftUI Color, Figma Variables). Material 3 parity (`m3.material.io/styles/color/resources`).

themes/color-roles.kmd

Semantic color role taxonomy — the mapping from concrete tokens (bg, surface, accent, error, etc.) to the UI elements that use each.

themes/color-schemes.kmd

Catálogo canônico de **esquemas de cor** (paletas) da Koder Stack — terceiro eixo da matriz visual (`ui-style × light-dark × color-scheme`), ortogonal aos dois primeiros.

themes/density.kmd

Three canonical page-level density modes (compact / default / comfortable) with token deltas, accessibility floor, persistence pattern, and multi-tenant override rules.

themes/depth.kmd

The cross-surface z-axis model.

themes/editorial-palette.kmd

12-color expressive palette for Koder marketing, landing illustration, blog headers, and social posts — distinct from Verge UI palette (Adwaita 1:1) which governs in-product surfaces.

themes/elevation.kmd

Elevation system — 6 levels (0-5) expressed as shadows + tonal surface colors.

themes/forced-colors.kmd

How Koder UIs respond when the OS forces a high-contrast color palette (Windows High Contrast / `forced-colors: active`, and equivalent platform modes): defer to the user's system colors, keep every shape and focus ring visible via borders + system-color keywords, and degrade the Verge token layer gracefully.

themes/koder-style.kmd

Companion to `specs/themes/verge.kmd`.

themes/lighting.kmd

The light source model behind every shadow in Koder Design.

themes/materials.kmd

Translucent surface tokens for floating UI (acrylic) and window-chrome backgrounds (mica).

themes/motion.kmd

Motion in Koder UI — index over 4 sub-specs: physics (principles + springs + reduced-motion), easing-duration (tokens), transitions (pattern catalog), spatial (parallax + 3D transitions / perceived depth).

themes/motion/easing-duration.kmd

Duration tokens (5) and easing curves (5) for every deterministic Koder UI animation.

themes/motion/physics.kmd

Motion physics for Koder UI — principles, performance budget, forbidden patterns, reduced-motion contract, and spring tokens (Material 3 Expressive).

themes/motion/reveal.kmd

Cursor-tracking radial highlight on hoverable surfaces.

themes/motion/spatial.kmd

Pseudo-3D motion on flat surfaces: pointer/gyroscope parallax, depth-on-scroll, and 3D transitions (flip, cube, perspective shared- element).

themes/motion/transitions.kmd

Transition pattern catalog for Koder UI — 7 canonical patterns (fade, scale, slide, container transform, shared axis, push/pop, cross-fade), per-state motion, and page-level transitions.

themes/palette.kmd

The PRIMITIVE color tier of the Koder Design System: named hues, each with an OKLCH tonal ramp (50–900).

themes/presets-families.kmd

Taxonomy organizing the Koder Design UI Style presets into 5 families: **Era**, **Brand**, **Mood/Aesthetic**, **Cultural**, and **Domain**.

themes/shape-library.kmd

Catalog of 35 named shapes + morphing contract for Material 3 Expressive parity.

themes/shape.kmd

Shape system — corner-radius scale, when to use which radius, and per-preset variation rules.

themes/typography.kmd

Typography system for Koder UIs — font stacks, type scale, weights, leading/tracking tokens, and the 12 type roles every widget binds against.

themes/verge.kmd

Verge is the canonical visual language of the Koder Design System — Koder's equivalent to Google's Material or Microsoft's Fluent.

tools/blog-changelog-index.kmd

HTML index page at `kds.koder.dev/blog/` that lists Koder Design releases as blog-style cards, ordered newest-first.

tools/blog-editorial-posts.kmd

Strict extension to `tools/blog-changelog-index.kmd` (#049.59).

tools/contrast-checker.kmd

In-browser tool at `kds.koder.dev/tools/contrast/` that validates foreground-background color pairs against WCAG 2.2 AA / AAA.

tools/design-kit-export.kmd

Exports the current Koder Design system into formats consumable by popular design tools — Figma Variables JSON, Sketch shared styles, Adobe XD libraries — so designers iterate in their tool while staying in sync with code.

tools/kds-sidebar-order.kmd

tools/migration-guides.kmd

Auto-generated migration guides covering both (a) Material → Koder Design adoption and (b) version-to-version Koder Design upgrades. Material parity (`/develop/migration`).

tools/migration-m3-expressive-uplift.kmd

Strict extension to `tools/migration-guides.kmd` (#049.58).

tools/theme-builder.kmd

Interactive in-browser tool at `kds.koder.dev/themer/` that turns a seed color into a full Material-3-style palette and exports tokens in every supported format.

variants/taxonomy.kmd

Define o termo **variante** como instância executável de um componente Koder para uma combinação específica de superfície (UI/forma) × alvo (plataforma/SO) × fator de forma (dispositivo).

web-apps/responsiveness.kmd

Responsividade e conformidade mobile para web apps Koder (admin, dashboards, consoles SaaS): breakpoints, touch targets, iOS Safari, hover, tabelas, formulários.

wire-compat/flow-vs-forgejo.kmd

Normative contract for the wire/API surfaces Koder Flow promises to keep byte- or semantically-equivalent with the upstream Forgejo it forks.

workflow/executor-protocol.kmd

Contrato de como o engine do Koder Workflow (services/ai/workflow) invoca os serviços que executam cada step kind — llm→gateway, tool→tools, code→sandbox, agent→agents — e como a resposta vira o output do step.