diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d0b31cd..ffc3e6c 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -73,6 +73,9 @@ Minimum story recipe:
 - `Anatomy`: document stable slots and public `data-*` hooks
 - `Accessibility` or `Motion`: choose whichever behavior is easiest to misunderstand
 
+If a story becomes part of the curated browser review surface, add or update its entry in
+`tests/e2e/support/story-harness-contract.json` so smoke and a11y coverage stay aligned.
+
 Writing rules:
 
 - Use `docs.description.component` to explain when to choose the component.
@@ -117,6 +120,7 @@ Harness shortcuts:
 pnpm harness:select
 pnpm harness:validate:static
 pnpm harness:validate:changed
+pnpm harness:validate:a11y
 pnpm harness:validate:component
 pnpm harness:validate:docs
 pnpm harness:validate:consumers
@@ -135,6 +139,7 @@ Broader gates:
 ```bash
 pnpm harness:validate:pr
 pnpm harness:validate:release
+pnpm harness:orch -- doctor
 ```
 
 ## Practical repo guidance
diff --git a/README.md b/README.md
index 7a70a48..f52b371 100644
--- a/README.md
+++ b/README.md
@@ -180,6 +180,7 @@ uses:
 - Storybook interaction coverage for representative examples
 - Playwright smoke coverage for core Storybook flows
 - Storybook a11y checks as part of the docs review surface
+- a shared `tests/e2e/support/story-harness-contract.json` manifest for curated browser coverage
 
 ## Harness engineering
 
@@ -200,12 +201,14 @@ pnpm harness:select
 pnpm harness:suites
 pnpm harness:validate:static
 pnpm harness:validate:changed
+pnpm harness:validate:a11y
 pnpm harness:validate:component
 pnpm harness:validate:docs
 pnpm harness:validate:docs-smoke
 pnpm harness:validate:consumers
 pnpm harness:validate:pr
 pnpm harness:validate:release
+pnpm harness:orch -- doctor
 pnpm harness:orch -- status --run <run-id>
 ```