Handbook

A12 — Granite deploy and smoke

Executor: Composer 2.5

Updated

Ceiling: technical ≤ I2_integrated, autonomy ≤ A1_supervised.

Plan

Ship Granite production path: install-granite.sh, deploy runbook, Matrix room bootstrap, and smoke tests for orchestrator + communication agent on Fleet.

Do

  1. Add executable scripts/install-granite.sh — orchestrator service + agent containers on Granite.
  2. Add docs/deploy/granite-runbook.md — Caddy/FAEP routes, secrets, rollback.
  3. Bootstrap #communication room (coordinate with forge-matrix scripts).
  4. Smoke: register communication bot → Element message → DB row → web UI chat.
  5. Do not run full pytest suite gate in this phase (A13).

Check

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

Act

Fix deploy/smoke until A12 gate passes; proceed to full test gate (A13).

Refuse

  • A2+ autonomy — install script must require explicit operator confirmation for production cutover.
  • Encrypted Matrix — smoke tests use unencrypted bot-readable rooms.
  • Second executor — do not change Granite paths without runbook update.
  • Multi-tenant Fleet — single-operator Granite scope only.