diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 3daf22a41..ca76c4dd9 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "a4b9755999b9c6eea865a83564a67762c5394be3",
-  "syncedAt": "2026-04-08T04:08:54.889Z"
+  "sha": "b73d8ef7d7e8ed66487245eca0576ea0b544dfe6",
+  "syncedAt": "2026-04-08T04:38:12.928Z"
 }
diff --git a/docs/concepts/qa-e2e-automation.md b/docs/concepts/qa-e2e-automation.md
index 42511cdef..d6ea14749 100644
--- a/docs/concepts/qa-e2e-automation.md
+++ b/docs/concepts/qa-e2e-automation.md
@@ -56,7 +56,8 @@ asset hash changes.
 
 Seed assets live in `qa/`:
 
-- `qa/scenarios.md`
+- `qa/scenarios/index.md`
+- `qa/scenarios/*.md`
 
 These are intentionally in git so the QA plan is visible to both humans and the
 agent. The baseline list should stay broad enough to cover:
diff --git a/docs/refactor/qa.md b/docs/refactor/qa.md
index a53adb41a..139eb967d 100644
--- a/docs/refactor/qa.md
+++ b/docs/refactor/qa.md
@@ -17,16 +17,20 @@ The desired end state is a generic QA harness that loads powerful scenario defin
 
 ## Current State
 
-Primary source of truth now lives in `qa/scenarios.md`.
+Primary source of truth now lives in `qa/scenarios/index.md` plus one file per
+scenario under `qa/scenarios/*.md`.
 
 Implemented:
 
-- `qa/scenarios.md`
-  - canonical QA pack
+- `qa/scenarios/index.md`
+  - canonical QA pack metadata
   - operator identity
   - kickoff mission
+- `qa/scenarios/*.md`
+  - one markdown file per scenario
   - scenario metadata
   - handler bindings
+  - scenario-specific execution config
 - `extensions/qa-lab/src/scenario-catalog.ts`
   - markdown pack parser + zod validation
 - `extensions/qa-lab/src/qa-agent-bootstrap.ts`
@@ -103,7 +107,8 @@ These categories matter because they drive DSL requirements. A flat list of prom
 
 ### Single source of truth
 
-Use `qa/scenarios.md` as the authored source of truth.
+Use `qa/scenarios/index.md` plus `qa/scenarios/*.md` as the authored source of
+truth.
 
 The pack should stay:
 
@@ -357,7 +362,8 @@ Generated compatibility:
 
 Done.
 
-- added `qa/scenarios.md`
+- added `qa/scenarios/index.md`
+- split scenarios into `qa/scenarios/*.md`
 - added parser for named markdown YAML pack content
 - validated with zod
 - switched consumers to the parsed pack