prometeu-studio/docs/compiler/pbs/learn/README.md

PBS Learn

This directory consolidates the durable operational knowledge of the PBS domain.

It exists to replace transient workflow artifacts that already served their purpose:

• open agendas,
• closed decisions,
• execution PR/plans.

The normative contract for PBS lives primarily in:

• docs/specs/compiler-languages/pbs/
• docs/specs/compiler/

learn/ is the didactic layer:

• it explains the final model,
• highlights the tradeoffs that matter in maintenance,
• summarizes common pitfalls,
• and points back to the normative specs that should be updated or consulted first.

Learn Set

• 01. AST and Parser Contract.md
• 02. Name Resolution and Linking.md
• 03. Runtime Values, Identity, and Memory Boundaries.md
• 04. Diagnostics and Conformance Governance.md
• 05. Globals, Lifecycle, and Published Entrypoint.md