Handbook

A04 — Communication agent knowledge base

Executor: Composer 2.5

Updated

Ceiling: technical ≤ I2_integrated, autonomy ≤ A0_assisted (deterministic KB answers only).

Plan

Implement the communication agent KB layer: knowledge corpus, index build, routing, and citation formatting under packages/communication/.

Do

  1. Scaffold packages/communication/ with pyproject.toml.
  2. Add knowledge/ corpus (FI + Platform + Blueprints scope per program brief).
  3. Implement src/forge_communication/kb/index.py — build_index, routing, confidence bands.
  4. Require citations on all !comm ask responses.
  5. Do not add Matrix bot or interaction store in this phase.

Check

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

Act

Revise KB until A04 gate passes; hand off store work to A05.

Refuse

  • A2+ autonomy — KB must not hallucinate policy or auto-send outbound messages.
  • Chat as SoR — land KB sources in repo paths; do not rely on external chat threads.
  • Second executor — do not re-index with a different model without program override.
  • LLM-only answers — deterministic KB routing required; no unconstrained generative replies.