Handbook

A11 — Platform envelope wiring

Executor: Composer 2.5

Updated

Ceiling: technical ≤ I2_integrated, autonomy ≤ A1_supervised.

Plan

Wire Platform protocol envelopes under shared/envelopes/: forge.chat_intent.v1, forge.agent_event.v1, and forge.communication_interaction.v1. Orchestrator and agents emit/consume; Lenses hooks are projection-only.

Do

  1. Create shared/envelopes/ with thin Python bindings or schema refs.
  2. Implement chat_intent.py, agent_event.py, communication_interaction.py.
  3. Bridge orchestrator events to Platform schemas (no Fleet schema drift).
  4. Document Lenses projection hooks — read-only, not SoR replacement.
  5. Do not add Granite deploy scripts in this phase (A12).

Check

forge-agents/scripts/forge-agents-pdca/check-phase-gate.sh A11

Act

Fix envelope wiring until A11 gate passes; proceed to Granite deploy (A12).

Refuse

  • A2+ autonomy — envelopes must not trigger unsupervised outbound actions.
  • Lenses SoR replacement — projections only; Lenses owns ForgeRun SoR.
  • Second executor — do not fork schema shapes from Platform canonical JSON.
  • Fleet validates forge.run — never claim Fleet validates Platform run envelopes.