Koder Design — System facet

bootstrap

Specs sobre como a Koder Stack é arquitetada: padrões arquiteturais, princípios cross-cutting, decisões de stack-wide backbone, audit, testing strategy, release model.

Parte do Koder Design programme, facet System. Ver rfcs/design-RFC-001 § Facets.

Nota sobre o nome do diretório. O facet se chama "System" mas o diretório é specs/architecture/ porque a maior parte do conteúdo são padrões arquiteturais. A landing apresenta como "System" pra evitar choque com "system design" interview-style.

Specs planejadas

Spec Status Ticket
service-architecture.kmd future —
event-driven-patterns.kmd future —
failure-modes.kmd future —
observability.kmd future —
release-model.kmd future —

Specs e RFCs existentes que pertencem conceitualmente ao facet System

(via cross-link, sem mover os arquivos)

  • meta/docs/stack/specs/testing/ — strategy de testes Stack-wide
  • meta/docs/stack/specs/kode/ — Kode AI runtime model
  • meta/docs/stack/specs/readmes/ — convenção de README
  • meta/docs/stack/specs/releases/packaging.kmd — formato de releases
  • meta/docs/stack/specs/docs/generation.kmd — geração de docs
  • Todos os RFCs em meta/docs/stack/rfcs/ — decisões arquiteturais

Princípios "first" (cross-cutting, base pro facet System)

  • policies/self-hosted-first.kmd
  • policies/reuse-first.kmd
  • policies/hyperscale-first.kmd
  • policies/multi-tenant-by-default.kmd
  • policies/web-server.kmd (caso aplicado de self-hosted-first)
  • policies/environments.kmd

Governance

policies/design-governance.kmd. Mudanças que afetam padrões arquiteturais cross-cutting passam por RFC formal antes de spec.