Handbook

A06 — Communication Matrix bot

Executor: Composer 2.5

Updated

Ceiling: technical ≤ I2_integrated, autonomy ≤ A0_assisted.

Plan

Wire the communication agent to Matrix: !comm bot, command handlers, room join policy, and markdown formatting. Rooms remain unencrypted for bot readability.

Do

  1. Implement src/forge_communication/matrix/bot.py — Matrix client lifecycle.
  2. Implement src/forge_communication/matrix/commands.py — !comm help|topics|ask|cite|policy.
  3. Integrate KB (A04) and store (A05) on inbound commands.
  4. Document room bootstrap (#communication) in package README.
  5. Do not add orchestrator or packaging agents in this phase.

Check

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

Act

Fix Matrix integration until A06 gate passes; proceed to packaging agents (A07).

Refuse

  • A2+ autonomy — bot must not auto-register users or send unsolicited messages.
  • Encrypted Matrix — do not require E2EE rooms for bot operation.
  • Second executor — do not swap Matrix library without gate re-run.
  • Protocol gateway sprawl — Matrix only; no SMTP/Teams/Slack in this phase.