README

bootstrap

Koder Design — System facet

Specs sobre *omo a Koder Stack é arquitetada* padrões arquiteturais, princípios crosscutting, decisões de stackwide backbone, audit, testing strategy, release model.

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

*ota 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 selfhostedfirst)
  • policies/environments.kmd

Governance

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

Source: ../home/koder/dev/koder/meta/docs/stack/specs/architecture/README.md