Enforce sync/async naming convention for examples

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

Author: cursoragent

CONTRIBUTING.md

@@ -85,6 +85,7 @@ This runs lint, format checks, compile checks, tests, and package build.
   - `tests/test_docs_python3_commands.py` (`README`/`CONTRIBUTING`/examples python3 command consistency enforcement),
   - `tests/test_example_run_instructions.py` (example run-instruction consistency enforcement),
   - `tests/test_example_sync_async_parity.py` (sync/async example parity enforcement),
+  - `tests/test_examples_naming_convention.py` (example sync/async prefix naming enforcement),
   - `tests/test_examples_syntax.py` (example script syntax guardrail),
   - `tests/test_guardrail_ast_utils.py` (shared AST guard utility contract),
   - `tests/test_makefile_quality_targets.py` (Makefile quality-gate target enforcement),

tests/test_architecture_marker_usage.py

@@ -27,6 +27,7 @@
     "tests/test_readme_examples_listing.py",
     "tests/test_examples_syntax.py",
     "tests/test_docs_python3_commands.py",
+    "tests/test_examples_naming_convention.py",
     "tests/test_example_sync_async_parity.py",
     "tests/test_example_run_instructions.py",
     "tests/test_computer_action_endpoint_helper_usage.py",

tests/test_examples_naming_convention.py

@@ -0,0 +1,15 @@
+import re
+from pathlib import Path
+
+import pytest
+
+pytestmark = pytest.mark.architecture
+
+
+def test_example_scripts_follow_sync_async_prefix_naming():
+    example_files = sorted(Path("examples").glob("*.py"))
+    assert example_files != []
+
+    pattern = re.compile(r"^(sync|async)_[a-z0-9_]+\.py$")
+    for example_path in example_files:
+        assert pattern.fullmatch(example_path.name)