diff --git a/docs/development/ci-cd.md b/docs/development/ci-cd.md
index 6f6bf7486..cc9c0a75a 100644
--- a/docs/development/ci-cd.md
+++ b/docs/development/ci-cd.md
@@ -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:
diff --git a/docs/reference/plan_cli.md b/docs/reference/plan_cli.md
index 17c7e5d83..f3a975900 100644
--- a/docs/reference/plan_cli.md
+++ b/docs/reference/plan_cli.md
@@ -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                             |