diff --git a/CLAUDE.md b/CLAUDE.md
index e953300..2263b20 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -16,7 +16,7 @@ cd ~/my-project && ./secrets pull # Pull + decrypt .env* files
 
 ```bash
 brew install bats-core
-bats test/          # runs secrets.bats + manifest.bats
+bats test/          # runs secrets.bats + manifest.bats + migrate.bats
 ./test/run-security.sh   # security regression subset + operator sign-off (see below)
 ```
 
@@ -77,6 +77,7 @@ hooks/pre-commit     # Pre-commit hook template
 test/
   secrets.bats       # bats-core test suite (133 tests)
   manifest.bats      # EGB-677 .secrets.json manifest tests (77 tests)
+  migrate.bats       # EGB-703 store-format-v2 migration tests (26 tests)
   test_helper.bash   # Shared setup/teardown
 README.md            # User-facing documentation
 CLAUDE.md            # This file
diff --git a/README.md b/README.md
index 354e23c..10cf7dc 100644
--- a/README.md
+++ b/README.md
@@ -500,7 +500,7 @@ For complete rotation with no historical exposure, create a fresh `~/.secrets/`
 ## Development
 
 ```bash
-# Run the test suite (210 tests across both files)
+# Run the test suite (236 tests across three files)
 brew install bats-core
 bats test/