34 lines
1.0 KiB
Markdown
34 lines
1.0 KiB
Markdown
# Observability and Debugging
|
|
|
|
Status: pedagogical
|
|
Companion spec: [`../specs/10-debug-inspection-and-profiling.md`](../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.
|