From 569666d300b06999d2d68573ad7d365709aadd0a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=7BAI=7Df=20D=2E=20M=C3=BCller?=
 <ralf.d.mueller+AI@gmail.com>
Date: Fri, 13 Feb 2026 19:44:34 +0100
Subject: [PATCH] ci: Add AsciiDoc linter workflow for PRs

- Run asciidoc-linter on all PRs touching anchor files
- Also runs on push to main for continuous validation
- Fails PR if linter finds issues
- Ensures all anchor files maintain quality standards

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
---
 .github/workflows/asciidoc-lint.yml | 37 +++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 .github/workflows/asciidoc-lint.yml

diff --git a/.github/workflows/asciidoc-lint.yml b/.github/workflows/asciidoc-lint.yml
new file mode 100644
index 0000000..05cc186
--- /dev/null
+++ b/.github/workflows/asciidoc-lint.yml
@@ -0,0 +1,37 @@
+name: AsciiDoc Linter
+
+on:
+  pull_request:
+    paths:
+      - 'docs/anchors/**/*.adoc'
+  push:
+    branches: [main]
+    paths:
+      - 'docs/anchors/**/*.adoc'
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install AsciiDoc Linter
+        run: |
+          pip install git+https://github.com/doctoolchain/asciidoc-linter.git
+
+      - name: Run AsciiDoc Linter
+        run: |
+          echo "Linting AsciiDoc anchor files..."
+          asciidoc-linter docs/anchors/*.adoc --format console
+
+      - name: Summary
+        if: success()
+        run: |
+          echo "✓ All anchor files passed AsciiDoc linter validation"