feat(ORC-8134): add migration plan for ORMContext

Author: ganzyukv

README.md

@@ -55,6 +55,11 @@ default:
 
 > If you also want to use `ORMContext`, install [macpaw/behat-orm-context](https://github.com/macpaw/behat-orm-context) and follow its setup instructions.
 
+> 📄 **Migration Notice:** `OrmContext` will be removed from `behat-api-context` in the next major release.
+> Please migrate to [`behat-orm-context`](https://github.com/macpaw/behat-orm-context) using the [official migration guide](https://github.com/macpaw/behat-orm-context/blob/master/MIGRATION.md) to avoid test failures.
+> See the full [ORMContext Migration Plan](./docs/ormcontext-migration.md) for step-by-step instructions.
+
+
 ---
 
 ## Configuration

docs/ormcontext-migration.md

@@ -0,0 +1,31 @@
+## Migration plan for using ORMContext
+
+### Step 1: 📦 Add `behat-orm-context` to `composer.json`
+```bash
+composer require --dev macpaw/behat-orm-context
+```
+
+### Step 2: 🧩 Register `OrmContext` in `behat.yml`
+```yaml
+default:
+  suites:
+    default:
+      contexts:
+        - BehatOrmContext\Context\OrmContext
+
+```
+> If you previously used `BehatApiContext\Context\OrmContext`, replace it with `BehatOrmContext\Context\OrmContext`
+
+### Step 3: 🧪 Verify Scenarios
+1. Run Behat tests:
+```bash
+  vendor/bin/behat
+```
+
+2. Ensure that all steps previously relying on OrmContext still work correctly after the migration.
+
+### 🚨 Backward Compatibility Notice
+> `OrmContext` will be removed from `behat-api-context` in a future major release. If you don't migrate, your tests will break after updating dependencies.
+
+### 🔔 Recommendation
+Perform the migration before the next major release of `behat-api-context` to avoid CI/CD disruptions and unexpected test failures in your production pipeline.