System
Architecture, cross-cutting principles, RFCs, audit, testing, release model — how the Stack is structured.
Specs
- AI agent state hooks (useKoderAgent / useKoderChat)
patterns/ai-agent-state-hooks.kmdFramework-neutral state-machine contract for any AI chat / agent
- AI agent step trace
ai-ui/agent-step-trace.kmdVertical step list + per-step expand (tool call, args, result, duration)
- AI citations / source attribution
ai-ui/citations.kmdFootnote-style inline citations + hover/long-press preview cards +
- AI generated content disclaimer
ai-ui/ai-disclaimer.kmdRisk-tiered disclaimer mechanism for AI-generated content in Koder
- AI memory drawer
ai-ui/memory-drawer.kmdDrawer to edit AI persistent memory: list/search/edit/delete items;
- Accessibility conformance (BR)
accessibility/conformance-br.kmdHow a Koder surface declares accessibility conformance against the three
- Accessibility nutrition labels
accessibility/nutrition-labels.kmdPublic per-product manifest declaring which accessibility features
- Approval gate pattern
patterns/approval-gate.kmdA paused step that waits for an authorized human to approve or reject a
- Audio-parity TDDs (sound capture / presence + sync + acoustic similarity + loudness diff / cross-impl reference-target)
develop/audio-parity-tdds.kmdThe audio sibling of specs/develop/animation-parity-tdds.kmd (visual
- Audit Frontmatter
audit/frontmatter.kmdConvenção do bloco `audit:` em frontmatter YAML de specs e policies
- Audit log surface
patterns/audit-log.kmdThe immutable, filterable trail of "who did what, when" for a tenant —
- Backlog Ticket Numbering
backlog/numbering.kmdNumeração de tickets no monorepo é sequencial por backlog no disco
- Blog / changelog index
tools/blog-changelog-index.kmdHTML index page at `kds.koder.dev/blog/` that lists Koder Design
- Blog — editorial posts (extension)
tools/blog-editorial-posts.kmdStrict extension to `tools/blog-changelog-index.kmd` (#049.59). Adds
- Brand-mandatory tokens
themes/brand-mandatory-tokens.kmdSubset of design tokens flagged as brand-mandatory — must NEVER be
- Broadcast Alerts (cross-session notices with expiry + priority)
notices/broadcast-alerts.kmdO sistema único de **alertas de broadcast** da Koder Stack: arquivos em
- Browser and platform support matrix
develop/browser-support.kmdPublished support contract for kds.koder.dev and every koder_web_kit
- Chat Channel Capability Matrix
chat-channels/capability-matrix.kmdCanonical feature surface that every Koder bot chat channel
- Command Structure
commands/structure.kmdEstrutura canônica de um comando `/k-*` em `meta/context/commands/`:
- Content-Security-Policy — canonical posture for Koder Flow + sibling apps
security/csp.kmdNormative CSP posture for Koder Flow and every sibling Koder web
- Contrast checker
tools/contrast-checker.kmdIn-browser tool at `kds.koder.dev/tools/contrast/` that validates
- DS Studio
design-system/ds-studio.kmdO contrato do DS Studio — a surface que evolui o Themer (`/themer/`) pra
- Design System Manifest
design-system/manifest.kmdO contrato do que É um Koder Design System (DS). Um DS é declarado por um
- Design kit export (Figma / Sketch / Adobe XD)
tools/design-kit-export.kmdExports the current Koder Design system into formats consumable by
- Designer-to-developer handoff process
develop/handoff-process.kmdExplicit workflow for moving a design from "ratified" (spec PR
- Develop — Get Started
develop/get-started.kmdCross-platform onboarding index para `kds.koder.dev/get-started/`
- Document Generation
docs/generation.kmdTipos de documento gerados por categoria de objeto (Stack, Area, Sector,
- Download Button (landings)
landing-pages/download-button.kmdBotão Download em landings de produto Koder: sempre via
- ESIGN digital signature — Koder Signer US profile (stub)
signing/esign.kmdUS profile (`?jurisdiction=us`) of the Koder Signer service per
- Exhaustive interaction-driven visual parity (drive every event over every element, capture the dynamic result, compare against a reference)
develop/interaction-visual-parity.kmdDRAFT — 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.kmdNormative contract for every Koder component that acts as an OAuth 2.0
- Feature deprecation / end-of-life communication
patterns/deprecation.kmdCanonical pattern for communicating a feature's deprecation — in-app
- Forced colors / high contrast
themes/forced-colors.kmdHow Koder UIs respond when the OS forces a high-contrast color palette
- Grammar and mechanics
content/grammar-and-mechanics.kmdRatified mechanical rules: capitalization, punctuation, numbers,
- Haptic feedback
interaction/haptics.kmdA semantic vocabulary for haptic feedback — impact, notification, and
- ICP-Brasil digital signature — Koder Signer contract
signing/icp-brasil.kmdNormative contract for the Koder Signer service
- KRDP — Koder Remote Desktop Protocol
remote/krdp/protocol.kmdThe wire contract for Koder Pilot remote access: transport (QUIC / WebTransport
- KVG Generative Extensions (AI-emitted UI)
kvg/generative-extensions.kmdContract for emitting KVG from an LLM ("generative UI" — the Koder-native
- KVG Stencil Libraries
kvg/stencils.kmdStack-level system of reusable KVG object libraries ("stencils"): themed banks
- KVS activity model — PRs, issues, reviews, comments & the activity feed
kvs/activity-model.kmd - KVS concurrent-merge & mergeable refs (conflict-as-data)
kvs/concurrent-merge.kmd - KVS namespace tree & permission resolution
kvs/namespace-tree.kmd - Koder Design — Density modes
themes/density.kmdThree canonical page-level density modes (compact / default / comfortable)
- Koder Document eXchange Format (.kdx)
kdx/format.kmdFormato universal de documento da Koder Stack (.kdx) — portável, autocontido,
- Koder ID OAuth Flow — TDD Test Template
auth/oauth-flow-test-template.kmdTest template normativo pra implementações da `specs/auth/oauth-flow.kmd`
- Koder ID OAuth Flow — consumer-side contract
auth/oauth-flow.kmdNormative contract for every Koder component that authenticates
- Koder ID Passkeys / WebAuthn — RP contract + passkey-first login
auth/passkeys.kmdNormative contract for WebAuthn/passkeys in Koder ID: the Relying-Party
- Koder ID Token Exchange — RFC 8693 delegation grant
auth/token-exchange.kmdNormative contract for the OAuth 2.0 Token Exchange grant
- Koder Markdown Format (.kmd)
kmd/format.kmdEspecificação do formato KMD (Koder Markdown) — extensão de
- Koder Package Format (.kpkg)
kpkg/format.kmdEspecificação do formato `.kpkg` (pacote universal da Koder Hub):
- Koder Pair — peer-to-peer device pairing handshake
pair/handshake.kmdProtocolo de handshake para pareamento peer-to-peer entre dispositivos do
- Koder Triage — chat cockpit surface (Telegram/WhatsApp)
operator-cockpit/chat-cockpit-surface.kmdEstende o cockpit do Koder Triage (cockpit.kmd) a uma SEGUNDA superfície: o
- Koder Triage — unified inventory & triage surface
operator-cockpit/cockpit.kmdKoder Triage é o módulo oficial unificado de inventário/triagem de objetos da
- Koder Vector Graphics Format (.kvg)
kvg/format.kmdUniversal open vector format for the Koder Stack: 2D, animation, and 3D
- Kzip — Format Spec (v1 — restic-compatible bootstrap)
kzip/format.kmdFormato canônico de arquivos `.kz` gerados por `kzip`, o compactador da
- Landing Conformance — Privacy
landing-pages/conformance-privacy.kmdDetector de conformance de privacidade de landing pages: uma página
- Landing Conformance — UX
landing-pages/conformance-ux.kmdDetector de conformance de UX de landing pages: responsividade mobile
- Landing Pages — Catálogos
landing-pages/catalog.kmdEstrutura e deploy de landing pages de **catálogo** (`platform.koder.dev`)
- Landing Pages — Hub Package Pages
landing-pages/packages.kmdEstrutura, meta tags Open Graph + Twitter Card, e composição da OG image
- Landing Pages — Institucionais
landing-pages/institutional.kmdEstrutura e deploy de landing pages **institucionais** (`www.koder.dev`,
- Landing Pages — Meta Portal (meta.koder.dev)
landing-pages/meta.kmdEstrutura, IA, pipeline de render, deploy e governança do portal
- Landing Pages — Produtos Koder
landing-pages/products.kmdEstrutura, seções, OG image e deploy de landing pages de produtos Koder
- Landing Pages — Sectors
landing-pages/sectors.kmdEstrutura e deploy de landing pages de **Sectors** (sub-divisões de
- Landing Pages — Specs / Formatos
landing-pages/specs.kmdEstrutura, seções, OG image e deploy de landing pages de specs ou
- Landing Pages — Áreas
landing-pages/areas.kmdEstrutura, seções e deploy das landing pages das Áreas da Koder Stack
- MCP permission prompt
ai-ui/mcp-permission-prompt.kmdConsent gate UI before invoking MCP tools with side effects. Implements
- MCP sampling approval
ai-ui/mcp-sampling-approval.kmdUI for MCP server-initiated LLM completion requests delegated to
- Media — Transcription (STT) resilience — on-device-first
media/transcription.kmdContrato cross-surface para transcrição (speech-to-text) em apps Koder. Regra
- Migration guides
tools/migration-guides.kmdAuto-generated migration guides covering both (a) Material → Koder
- Migration — M3 baseline → M3 Expressive uplift
tools/migration-m3-expressive-uplift.kmdStrict extension to `tools/migration-guides.kmd` (#049.58). Adds 3rd
- Multi-tenancy contract
multi-tenancy/contract.kmd - OUIA test hooks (data-ouia-* contract)
testing/ouia-test-hooks.kmdEvery KDS-spec'd component MUST emit Open UI Automation (OUIA)
- Overrides API — named subpart contract for KDS components
develop/overrides-api.kmdDefines the named-subpart Overrides API every KDS component MUST
- Password policy
identity/password-policy.kmdThe NCSC/NIST-aligned password rules for Koder ID — the ONLY surface in
- Plain language
content/plain-language.kmdReading-level target (Flesch-Kincaid ≤ grade 8 for body; ≤ 6 for
- Plain language (pt-BR)
content/plain-language-ptbr.kmdThe Brazilian-Portuguese localization of the plain-language rule: a
- README — Produtos Koder
readmes/products.kmdFormato canônico de README dos produtos Koder: seções obrigatórias,
- RFC frontmatter — `phases:` array
rfc-frontmatter/phases.kmdConvention for declaring multi-phase migration plans in RFC frontmatter
- Release Packaging Formats
releases/packaging.kmdFormatos canônicos de pacote por plataforma (.deb, .rpm, .apk,
- Requirement / Scenario grammar for normative .kmd
kmd/requirement-scenario.kmdGramática opcional, mas normativa quando usada, para expressar
- Snapshot manifest format (.kvg)
snapshots/manifest.kmdNormative format for the Koder Snapshot manifest (`.kvg` — Koder Value
- Spec-delta lifecycle (.kmd deltas applied by requirement id)
kmd/spec-delta.kmdFormato e ciclo de vida do spec-delta: um `.kmd` revisável que nomeia sua
- Theme Builder
tools/theme-builder.kmdInteractive in-browser tool at `kds.koder.dev/themer/` that turns a
- UI interaction performance — request→painted latency tiers
testing/ui-interaction-perf.kmdNormative contract for measuring, comparing and gating the latency of
- Usability — applying M3 Expressive
foundations/usability.kmdFoundation guidance on applying Material 3 Expressive without
- Variantes — Taxonomy
variants/taxonomy.kmdDefine o termo **variante** como instância executável de um componente
- Visual golden widget pattern (headless compositor + screencopy)
patterns/visual-golden-widget.kmdCanonical recipe for shipping byte-exact visual regression
- Voice and tone
content/voice-and-tone.kmdPersistent voice across all Koder surfaces (4 traits) + tone matrix
- Wire/API compatibility — Koder Flow vs upstream Forgejo
wire-compat/flow-vs-forgejo.kmdNormative contract for the wire/API surfaces Koder Flow promises to
- Workflow Executor Protocol
workflow/executor-protocol.kmdContrato de como o engine do Koder Workflow (services/ai/workflow) invoca
- config-format
kode/config-format.kmd - eIDAS digital signature — Koder Signer EU profile (stub)
signing/eidas.kmdEU profile (`?jurisdiction=eu`) of the Koder Signer service per
- hooks
kode/hooks.kmd - koder.toml — `category` field
koder-toml/category.kmdTop-level `category` field in `koder.toml` placing each module in
- perf-baseline-vs-pg17
postgres-compat/perf-baseline-vs-pg17.kmd