Handbook

A08 — Orchestrator registry API

Executor: Composer 2.5

Updated

Ceiling: technical ≤ I2_integrated, autonomy ≤ A1_supervised (human-gated register/deregister).

Plan

Implement the agent orchestrator control plane: registry API, desired-state model, and Matrix register/deregister wrappers.

Do

  1. Scaffold orchestrator/src/forge_agents_orchestrator/.
  2. Implement api.py — list/register/deregister agents, health.
  3. Implement registry.py — desired vs actual state, SQLite or YAML registry.
  4. Implement matrix_admin.py — Synapse admin / register_new_matrix_user bridge.
  5. Do not add Fleet container lifecycle or web UI in this phase.

Check

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

Act

Fix orchestrator API until A08 gate passes; proceed to Fleet packaging (A09).

Refuse

  • A2+ autonomy — register/deregister requires explicit human or policy gate.
  • Lenses SoR replacement — orchestrator emits projections only; Lenses remains SoR.
  • Second executor — do not rewrite API contracts without schema update.
  • Multi-tenant Fleet — single-operator Granite scope only.