ci: strengthen verifier with link checks

Author: OgeonX-Ai

scripts/verify_repo.py

@@ -1,4 +1,5 @@
 from pathlib import Path
+import re
 
 ROOT = Path(__file__).resolve().parents[1]
 
@@ -11,16 +12,22 @@
     'VERSIONING.md',
     'CHANGELOG.md',
     'CODEOWNERS',
+    'AGENTS.md',
     '.github/PULL_REQUEST_TEMPLATE.md',
+    '.github/copilot-instructions.md',
     '.github/workflows/ci-docs.yml',
     '.github/workflows/sync-wiki.yml',
+    'docs/README.md',
+    'docs/methodology/quickstart.md',
     'docs/methodology/continuous-improvement-loop.md',
     'docs/methodology/definition-of-done.md',
+    'docs/methodology/maturity-model.md',
     'docs/diagrams/README.md',
     'docs/loops/feature.md',
     'docs/loops/bugfix-loop.md',
     'docs/loops/release.md',
     'docs/verifiers/README.md',
+    'docs/evaluations/README.md',
     'prompts/master-system-prompt.md',
     'prompts/chatgpt-web.md',
     'prompts/continuous-improvement.md',
@@ -32,14 +39,19 @@
 ]
 
 REQUIRED_MERMAID = [
+    'AGENTS.md',
     'docs/methodology/continuous-improvement-loop.md',
     'docs/methodology/definition-of-done.md',
+    'docs/methodology/maturity-model.md',
     'docs/diagrams/README.md',
     'docs/loops/feature.md',
     'docs/loops/release.md',
     'wiki/Home.md',
 ]
 
+LINK_RE = re.compile(r'\[[^\]]+\]\(([^)]+)\)')
+SKIP_PREFIXES = ('http://', 'https://', 'mailto:', '#')
+
 
 def fail(title, items):
     if items:
@@ -66,6 +78,22 @@ def fail(title, items):
         without_mermaid.append(p)
 fail('Required diagram docs without Mermaid:', without_mermaid)
 
+broken_links = []
+for md in markdown:
+    text = md.read_text(encoding='utf-8')
+    for match in LINK_RE.finditer(text):
+        target = match.group(1).split('#', 1)[0].strip()
+        if not target or target.startswith(SKIP_PREFIXES):
+            continue
+        resolved = (md.parent / target).resolve()
+        try:
+            resolved.relative_to(ROOT.resolve())
+        except ValueError:
+            continue
+        if not resolved.exists():
+            broken_links.append(f'{md.relative_to(ROOT)} -> {target}')
+fail('Broken relative links:', broken_links)
+
 print('Repository structure OK')
 print('Required files checked:', len(REQUIRED))
 print('Markdown files checked:', len(markdown))