Handbook

A02 — Platform Agents handbook, ADR, schemas

Executor: Composer 2.5

Updated

Ceiling: technical ≤ I2_integrated, autonomy ≤ A1_supervised (channel agents default A0_assisted).

Plan

Land Platform documentation for the Agents ecosystem: handbook hub under docs/agents/, an ADR for forge-agents placement, and JSON schemas for agent registry and communication interactions.

Do

  1. Create forge-platform/docs/agents/index.md — Agents handbook hub (channel agents vs workcells).
  2. Add ADR under forge-platform/adr/ (e.g. ADR-00XX-forge-agents-monorepo.md).
  3. Add schemas: communication_interaction.v1.schema.json, agent_registry.v1.schema.json.
  4. Cross-link ecosystem and repository-strategy pages where applicable.
  5. Do not migrate cursor-bridge or implement orchestrator code in this phase.

Check

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

Act

Revise Platform docs and schemas until A02 gate passes; proceed to A03 migration.

Refuse

  • A2+ autonomy — ADR must not authorize unsupervised agent deployment.
  • Lenses SoR replacement — handbook must position Lenses as control plane SoR.
  • Second executor — do not rewrite ADR with a different model without program override.
  • Encrypted Matrix — do not document encrypt-first rooms as default for bots.