From f7918706d889f94a51ab1857742b37753a669039 Mon Sep 17 00:00:00 2001
From: rustfuture <121799572+rustfuture@users.noreply.github.com>
Date: Fri, 2 Oct 2026 16:55:25 +0300
Subject: [PATCH] Check README and docs links and anchors in CI

---
 .github/workflows/links.yml | 21 +++++++++++++++++++++
 docs/readme-details.md      |  2 +-
 2 files changed, 22 insertions(+), 1 deletion(-)
 create mode 100644 .github/workflows/links.yml

diff --git a/.github/workflows/links.yml b/.github/workflows/links.yml
new file mode 100644
index 0000000..9f30d14
--- /dev/null
+++ b/.github/workflows/links.yml
@@ -0,0 +1,21 @@
+name: Links
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  links:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Check links and anchors in README and docs (offline)
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: --offline --include-fragments --no-progress README.md 'docs/**/*.md'
+          fail: true
diff --git a/docs/readme-details.md b/docs/readme-details.md
index d658543..69b4df7 100644
--- a/docs/readme-details.md
+++ b/docs/readme-details.md
@@ -101,7 +101,7 @@ python3 -m venv /tmp/grainx-render-venv && /tmp/grainx-render-venv/bin/pip insta
 /tmp/grainx-render-venv/bin/python demos/capture_tui.py target/debug/grainx /tmp/tui.raw /tmp/tui.txt 5 110 50
 ~~~
 
-See [demos/README.md](demos/README.md) and [demos/verification_2026-09-11.md](../demos/verification_2026-09-11.md)
+See [demos/README.md](../demos/README.md) and [demos/verification_2026-09-11.md](../demos/verification_2026-09-11.md)
 for the full commands, hashes, privacy review, and limitations.
 
 ## Performance and Microbenchmarks