fix(ci): resolve markdownlint and internal link check failures

Wrap the local preview URL in CONTRIBUTING.md, generate docs/CONTRIBUTING.md before link checks, and ignore generated docs from markdownlint.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: TMHSDigital

.markdownlint-cli2.jsonc

@@ -0,0 +1,7 @@
+{
+  "config": ".markdownlint.json",
+  "ignores": [
+    "docs/CONTRIBUTING.md",
+    "research/**"
+  ]
+}

CONTRIBUTING.md

@@ -53,7 +53,7 @@ python scripts/prepare-mkdocs.py
 mkdocs serve
 ```
 
-Open http://127.0.0.1:8000/Awesome-Ads/ in your browser.
+Open [http://127.0.0.1:8000/Awesome-Ads/](http://127.0.0.1:8000/Awesome-Ads/) in your browser.
 
 ## Standards
 

scripts/AGENTS.md

@@ -15,6 +15,7 @@ Maintenance utilities for repository quality checks.
 - Resolves relative link targets from the containing file's directory.
 - Skips `http://`, `https://`, `mailto:`, `#`, and `ftp://` URLs.
 - Exit code `0` on success, `1` when broken links are found.
+- Runs `prepare-mkdocs.py` first so generated files such as `docs/CONTRIBUTING.md` exist before link resolution.
 
 Run from the repository root:
 

scripts/check-internal-links.py

@@ -4,6 +4,7 @@
 from __future__ import annotations
 
 import re
+import subprocess
 import sys
 from pathlib import Path
 
@@ -39,6 +40,10 @@ def collect_errors(root: Path) -> list[str]:
 
 def main() -> int:
     root = Path(__file__).resolve().parent.parent
+    prepare_script = root / "scripts" / "prepare-mkdocs.py"
+    if prepare_script.exists():
+        subprocess.run([sys.executable, str(prepare_script)], check=True)
+
     errors = collect_errors(root)
 
     if errors: