prometeu-runtime/docs/runtime/learn/mental-model-observability-and-debugging.md

Observability and Debugging

Status: pedagogical Companion spec: ../specs/10-debug-inspection-and-profiling.md

PROMETEU foi desenhado para ser observável.

Debug Philosophy

Há três ideias centrais aqui:

1. estado vem antes de abstração;
2. tempo é cidadão de primeira classe;
3. observar não deve alterar o resultado lógico.

Isso puxa o projeto para um estilo de depuração mais próximo de máquina e menos próximo de “tentativa e erro”.

Why This Matters

Quando a máquina expõe pilhas, heap, ciclos, buffers e faults de forma consistente, o programador consegue:

• localizar custo real;
• correlacionar tempo e memória;
• justificar decisão técnica;
• depurar sem inventar explicações mágicas.

Teaching Value

Essa superfície didática existe porque PROMETEU quer ensinar também como sistemas são analisados:

• debugging como observação informada;
• profiling como leitura de evidência;
• certification como relatório técnico reproduzível.