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