prometeu-studio/docs/packer/agendas

Packer Agendas

This directory contains active packer discussion agendas.

Active Agendas

1. 01.0. Packer Scope, Boundaries, and Golden Pipeline Agenda.md
2. 01.1. Asset Workspace, Registry, and Stable Identity Agenda.md
3. 01.2. Asset Specification, Raw Assets, and Virtual Asset Contract Agenda.md
4. 01.3. Build Artifacts and Deterministic Packing Agenda.md
5. 01.4. Diagnostics, Doctor, Quarantine, and Workspace Hygiene Agenda.md
6. 01.5. Incremental Build, Cache, and Watch Model Agenda.md
7. 01.6. CLI Surface and Mutating Operations Agenda.md
8. 01.7. Builder Integration, Versioning, and Trust Model Agenda.md

Purpose

An agenda exists to drive a decision.

Use an agenda when:

• the packer topic is still open,
• multiple options or tradeoffs must be evaluated,
• scope and non-goals need to be made explicit,
• the order of discussion matters,
• the team still needs a recommendation before committing direction.

An agenda should help the reader converge, not just accumulate notes.

Expected Format

A packer agenda should usually include:

1. Title
2. Status
3. Purpose
4. Context
5. Options
6. Tradeoffs
7. Recommendation
8. Open Questions
9. Expected Follow-up

Writing Rules

• Keep the document centered on unresolved questions.
• State the concrete decision the discussion is trying to produce.
• Prefer explicit tradeoffs over vague option lists.
• Avoid drafting large blocks of final normative spec text here.
• Be specific about packer scope: asset workspace, build artifacts, diagnostics, registry, builder boundary, and related contracts.

Exit Rule

An agenda should leave the active set when:

• the main tradeoffs are understood,
• a recommendation is clear enough to adopt,
• and the topic is ready to become a decision record.