ci: Add AsciiDoc linter workflow and pre-commit hook

[raifdmueller]

Summary

Add automated AsciiDoc quality validation for all anchor files.

Changes

GitHub Action ⚙️

• New workflow: .github/workflows/asciidoc-lint.yml
• Runs on PRs touching docs/anchors/**/*.adoc
• Runs on push to main for continuous validation
• Fails CI if linter finds issues

Pre-commit Hook 🪝

• Validates staged anchor files before commit
• Prevents committing invalid AsciiDoc
• Provides clear error messages

Benefits

• Quality gates: Catches AsciiDoc issues before merge
• Consistent standards: All anchors follow semantic patterns
• Fast feedback: Developers see issues immediately
• Zero manual checking: Automation ensures compliance

Installation (for contributors)

The pre-commit hook is in .git/hooks/pre-commit but needs manual installation:

```bash

Install asciidoc-linter

pipx install git+https://github.com/doctoolchain/asciidoc-linter.git

Install pre-commit hook (from repo root)

cp .git/hooks/pre-commit.sample .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit
```

Or copy the hook from the PR description.

Testing

• Workflow syntax validated
• Pre-commit hook tested locally
• All current anchor files pass validation

🤖 Generated with Claude Code