Handbook

A01 — forge-agents monorepo scaffold

Executor: Composer 2.5

Updated

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

Plan

Create the private forge-agents monorepo skeleton: workspace pyproject.toml, top-level README.md, packages/, and orchestrator/ directories. Layout only — no agent implementation yet.

Do

  1. Add README.md describing forge-agents scope (channel agents, packaging, orchestrator).
  2. Add root pyproject.toml (workspace/meta package).
  3. Create empty packages/ and orchestrator/ directory trees with placeholder README.md files if needed.
  4. Do not migrate cursor-bridge or add Platform ADR content in this phase.

Check

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

Act

Revise repo scaffold until A01 gate passes; hand off Platform docs to A02.

Refuse

  • A2+ autonomy — scaffold must not include auto-lifecycle or unsupervised registration hooks.
  • Lenses SoR replacement — README must not claim Lenses replacement.
  • Second executor — do not re-scaffold with a different model without updating master sequence.
  • Workcell migration — no forge-workcells code in this repo.