Reference

audit/frontmatter.kmd

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

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.

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.

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).

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.

ipc/protocol.kmd

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

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.

kode/config-format.kmd

kode/hooks.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-toml/category.kmd

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

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.

kzip/format.kmd

Formato canônico de arquivos `.kz` (single-file) e `.kzip` (multi-file archive) 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/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/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}`). 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, 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.

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.

pair/handshake.kmd

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

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).

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.

settings/patterns.kmd

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

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.

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.