System
Arquitetura, princípios cross-cutting, RFCs, audit, testing, release model — como a Stack é estruturada.
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 nutrition labels
accessibility/nutrition-labels.kmdPublic per-product manifest declaring which accessibility features
- Audit Frontmatter
audit/frontmatter.kmdConvenção do bloco `audit:` em frontmatter YAML de specs e policies
- 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
- 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
- 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
- Feature deprecation / end-of-life communication
patterns/deprecation.kmdCanonical pattern for communicating a feature's deprecation — in-app
- Grammar and mechanics
content/grammar-and-mechanics.kmdRatified mechanical rules: capitalization, punctuation, numbers,
- ICP-Brasil digital signature — Koder Signer contract
signing/icp-brasil.kmdNormative contract for the Koder Signer service
- Koder Design — Density modes
themes/density.kmdThree canonical page-level density modes (compact / default / comfortable)
- 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 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 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
- 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
- Plain language
content/plain-language.kmdReading-level target (Flesch-Kincaid ≤ grade 8 for body; ≤ 6 for
- 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,
- Snapshot manifest format (.kvg)
snapshots/manifest.kmdNormative format for the Koder Snapshot manifest (`.kvg` — Koder Value
- Theme Builder
tools/theme-builder.kmdInteractive in-browser tool at `kds.koder.dev/themer/` that turns a
- 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