2 changed files with 20 additions and 0 deletions
@@ -171,6 +171,19 @@ tools directly. This ensures that the CI environment matches local development
 exactly. Each job runs `pip install uv nox` and then delegates to the
 appropriate nox session.

+### Pre-Migrated Database Template
+
+All nox test sessions (`unit_tests`, `integration_tests`, `slow_integration_tests`,
+`e2e_tests`, `coverage_report`) use a **pre-migrated database template** to
+eliminate redundant Alembic migrations across test runs. The template is created
+once via `_create_template_db()` and the path is passed to each session via the
+`CLEVERAGENTS_TEMPLATE_DB` environment variable. Each test worker copies the
+template rather than running migrations from scratch, significantly reducing
+total test suite wall-clock time.
+
+`slow_integration_tests` uses `pabot` (parallel Robot Framework runner) for
+consistency with `integration_tests`. (#2334)
+
 ### Quality Gates Summary

 All gates must pass for a PR to be mergeable:
@@ -2,6 +2,13 @@

 The `agents plan` command group manages plans in the CleverAgents v3 plan lifecycle.

+!!! warning "Legacy/v3 Plan Workflow Mixing"
+    `agents plan` commands detect and reject attempts to mix legacy plan commands
+    with v3 plan workflows in the same session. If you attempt to use a legacy
+    plan command alongside v3 commands, the CLI surfaces a clear error message
+    with migration guidance. Migrate all plan workflows to v3 before mixing
+    commands in a single session. (#1577)
+
 ## Commands

 | Command                        | Description                             |