Handbook

A03 — Migrate cursor_bridge package

Executor: Composer 2.5

Updated

Ceiling: technical ≤ I2_integrated, autonomy ≤ A1_supervised (cursor bridge remains supervised).

Plan

Migrate forge-cursor-bridge into forge-agents/packages/cursor_bridge/ with functional parity. Leave a redirect README in the old repo. All pytest tests must pass.

Do

  1. Copy or subtree-merge cursor-bridge sources into packages/cursor_bridge/.
  2. Ensure packages/cursor_bridge/pyproject.toml and tests/ are present.
  3. Run and fix pytest for cursor_bridge until green.
  4. Add deprecation notice to forge-cursor-bridge/README.md pointing at forge-agents.
  5. Do not add communication agent or orchestrator code in this phase.

Check

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

Act

Fix migration gaps until A03 gate passes; proceed to communication KB (A04).

Refuse

  • A2+ autonomy — cursor bridge must not auto-merge PRs or deploy without human gates.
  • Lenses SoR replacement — migration notes must not claim Lenses replacement.
  • Second executor — do not re-migrate with a different model without gate re-run.
  • Workcell migration — cursor bridge is a channel agent only, not a workcell runner.