prometeu-studio/docs/compiler/pbs/agendas

PBS Agendas

This directory contains active PBS discussion agendas.

Closed agendas are moved to docs/pbs/agendas/archive.

Active Agendas

1. 18.0. Backend VM Pipeline - Orchestration Agenda.md
2. 18.1. Backend Workshop 1 - IRBackend Input Contract.md
3. 18.2. Backend Workshop 2 - LowerToIRVM and IRVM Contract.md
4. 18.3. Backend Workshop 3 - Bytecode Marshaling and Runtime Conformance.md
5. 18.4. Asset References in Game Code - Names vs Compile-Time Lowering Agenda.md
6. 18.5. Ignored Call Results in Executable Lowering Agenda.md
7. 19. Globals, Synthetic Module Init, and FRAME_RET Agenda.md
8. 19.1. PBS Globals Surface, Identity, and Module Boundaries Agenda.md
9. 19.2. PBS Lifecycle Markers, Program Init, and Frame Root Semantics Agenda.md
10. 19.3. Published Entrypoint, Synthetic Wrapper, and FRAME_RET Ownership Agenda.md
11. 19.4. Globals and Lifecycle Lowering to IRBackend-IRVM Agenda.md
12. 19.5. Diagnostics, Manifest Propagation, and Conformance Coverage Agenda.md

Purpose

An agenda exists to drive a decision, not to serve as final normative text.

Use an agenda when:

• the topic is still open,
• multiple options or tradeoffs must be evaluated,
• the scope and non-goals need to be made explicit,
• the order of discussion matters.

Move an agenda to docs/pbs/agendas/archive once the topic is no longer active.

Expected Format

An agenda should usually include:

1. Title
2. Status
3. Purpose
4. Context
5. Decisions to Produce
6. Core Questions
7. Expected Spec Material
8. Non-Goals
9. Inputs

Writing Rules

• Keep the document oriented around unresolved questions.
• Separate open questions from assumptions already fixed elsewhere.
• Name the concrete decisions the discussion must produce.
• Avoid drafting large blocks of final normative spec text here.
• Prefer explicit non-goals to prevent scope drift.

Exit Rule

An agenda should move out of the active set when:

• the key questions have been answered,
• the architectural direction is clear enough to record,
• and the topic is ready to become a decision record and then a spec update.