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