# Time Model and Cycles

Status: pedagogical
Companion spec: [`../specs/01-time-model-and-cycles.md`](../specs/01-time-model-and-cycles.md)

PROMETEU trata tempo como parte explícita da máquina.

## Core Idea

Nada acontece “de graça” ou “instantaneamente”. O programador deve pensar em:

- ritmo da máquina;
- custo por frame;
- distribuição de trabalho ao longo do tempo;
- impacto arquitetural de quando cada sistema roda.

## Why Cycles Instead of Milliseconds

Milissegundos variam com plataforma, jitter e hardware real. Cycles dão uma métrica de custo que pertence à máquina PROMETEU, não ao host.

Isso torna mais fácil comparar soluções, ensinar custo e raciocinar sobre performance sem esconder a conta atrás do sistema operacional.

## Temporal Distribution As Design

Uma das intuições mais importantes em PROMETEU é: otimização não é só “fazer menos”, é decidir **quando** fazer.

Exemplos úteis:

- IA em 30 Hz;
- pathfinding em 15 Hz;
- timers dirigidos por frame count;
- separação entre atualização pesada e apresentação.

## Why CAP Fits Here

O CAP reforça essa leitura de tempo como evidência técnica. Ele não existe para bloquear execução, e sim para tornar visíveis:

- picos;
- gargalos;
- distribuição de custo;
- decisões de arquitetura temporal.

## Teaching Value

Esse modelo ajuda a ensinar:

- planejamento de execução;
- trade-offs técnicos;
- leitura de perfil real;
- organização temporal como ferramenta arquitetural.