Add README examples listing guard test

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

CONTRIBUTING.md

@@ -85,7 +85,8 @@ This runs lint, format checks, compile checks, tests, and package build.
   - `tests/test_ci_workflow_quality_gates.py` (CI guard-stage + make-target enforcement),
   - `tests/test_makefile_quality_targets.py` (Makefile quality-gate target enforcement),
   - `tests/test_pyproject_architecture_marker.py` (pytest marker registration enforcement),
-  - `tests/test_architecture_marker_usage.py` (architecture marker coverage across guard modules).
+  - `tests/test_architecture_marker_usage.py` (architecture marker coverage across guard modules),
+  - `tests/test_readme_examples_listing.py` (README example-listing consistency enforcement).
 
 ## Code quality conventions
 

tests/test_readme_examples_listing.py

@@ -0,0 +1,15 @@
+import re
+from pathlib import Path
+
+import pytest
+
+pytestmark = pytest.mark.architecture
+
+
+def test_readme_example_list_references_existing_example_files():
+    readme_text = Path("README.md").read_text(encoding="utf-8")
+    listed_examples = re.findall(r"- `([^`]*examples/[^`]*)`", readme_text)
+
+    assert listed_examples != []
+    for example_path in listed_examples:
+        assert Path(example_path).is_file()