Erweiterung Contracts und Guards

bin/docs-link-check.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+repo_root="$(cd -- "${script_dir}/.." && pwd)"
+cd "${repo_root}"
+
+tmp_file="$(mktemp)"
+trap 'rm -f "${tmp_file}"' EXIT
+
+rg -n -o '(?:/docs|docs)/[a-z0-9_/-]+\.md' \
+  README.md docs tools/codex-skills agent-system \
+  -g '*.md' \
+  -g '!agent-system/runs/**' \
+  > "${tmp_file}" || true
+
+missing=0
+while IFS= read -r line; do
+  file="${line%%:*}"
+  rest="${line#*:}"
+  line_no="${rest%%:*}"
+  ref="${rest#*:}"
+  normalized="${ref#/}"
+
+  if [[ ! -f "${normalized}" ]]; then
+    printf '%s:%s -> %s\n' "${file}" "${line_no}" "${ref}"
+    missing=1
+  fi
+done < "${tmp_file}"
+
+if [[ ${missing} -ne 0 ]]; then
+  echo "[FAIL] broken docs links found"
+  exit 1
+fi
+
+echo "[OK] docs links resolve (agent-system/runs/** excluded by default)"