ci(docs): add markdown link linter and fix 10 broken local links

Adds .markdown-link-check.json and a dedicated lint-docs.yml workflow
that checks local file links in all .md files (excluding .agents/,
openspec/, web/docs/, and build artifacts) on every PR and push to main.

Broken links fixed:
- CHANGELOG.md: stale docs-build/ path → web/docs/articles/
- docs/architecture/c4-views/booter-components.md: /docs-internal/ absolute path → relative ./images/
- docs/architecture/c4-views/structurizr-dsl/INDEX.md: removed missing runner-components.dsl entry
- docs/architecture/README.md: removed runner-components.dsl from tree
- docs/architecture/models/flows/bot-connection.md: ADR numbers 0001→0009, 0002→0003
- docs/architecture/models/flows/turn-execution.md: ADR number 0003→0011
- docs/architecture/models/message-schema/state.md: wrong depth ../adr/ → ../../adr/
- docs/architecture/adr/0034-breakpoint-mode.md: wrong depth ../../schema/ → ../../../schema/
- docs/architecture/adr/0036-start-game-debug-options.md: same schema depth fix

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: flemming-n-larsen

.github/workflows/lint-docs.yml

@@ -0,0 +1,26 @@
+name: Lint Docs
+
+on:
+  push:
+    branches: [main]
+    paths: ['**/*.md']
+  pull_request:
+    paths: ['**/*.md']
+
+jobs:
+  check-links:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check local links in markdown files
+        run: |
+          find . -name "*.md" \
+            -not -path "*/.agents/*" \
+            -not -path "*/openspec/*" \
+            -not -path "*/web/docs/*" \
+            -not -path "*/node_modules/*" \
+            -not -path "*/.gradle/*" \
+            -not -path "*/.venv/*" \
+            -not -path "*/build/archive/*" \
+            | xargs -P4 -n1 npx --yes markdown-link-check --config .markdown-link-check.json

.markdown-link-check.json

@@ -0,0 +1,8 @@
+{
+  "ignorePatterns": [
+    { "pattern": "^https?://" },
+    { "pattern": "^mailto:" },
+    { "pattern": "^/" },
+    { "pattern": "\\.html$" }
+  ]
+}

CHANGELOG.md

@@ -549,7 +549,7 @@ The Python Bot API has been refactored to match Java and .NET:
 | `self.set_adjust_gun_for_body_turn(True)` | `self.adjust_gun_for_body_turn = True` |
 
 > **Full migration guide**: See the `MyFirstBot` sample bots
-> and [Team Messages](docs-build/docs/articles/team-messages.md) article.
+> and [Team Messages](web/docs/articles/team-messages.md) article.
 
 ### 🚀 Improvements
 

docs/architecture/README.md

@@ -213,8 +213,7 @@ docs-internal/architecture/
 │   │   ├── bot-api-components.dsl
 │   │   ├── gui-components.dsl
 │   │   ├── booter-components.dsl
-│   │   ├── recorder-components.dsl
-│   │   └── runner-components.dsl
+│   │   └── recorder-components.dsl
 │   └── images/
 │       ├── system-context.svg
 │       ├── container.svg

docs/architecture/adr/0034-breakpoint-mode.md

@@ -329,4 +329,4 @@ Bot API detects debugger (JDWP, `Debugger.IsAttached`, `sys.gettrace()`) and aut
 ## References
 
 - [GitHub Issue #204](https://github.com/robocode-dev/tank-royale/issues/204) — Original feature request
-- [`bot-policy-update` schema](../../schema/schemas/bot-policy-update.schema.yaml) — Existing per-bot policy message
+- [`bot-policy-update` schema](../../../schema/schemas/bot-policy-update.schema.yaml) — Existing per-bot policy message

docs/architecture/adr/0036-start-game-debug-options.md

@@ -177,4 +177,4 @@ Add `debuggingEnabled` or a bot-address-keyed policy map to `start-game`.
 
 - [GitHub Issue #205](https://github.com/robocode-dev/tank-royale/issues/205) — Feature request: start battle paused / graphical debugging toggle
 - [ADR-0033](./0033-bot-debug-mode.md) — Server Debug Mode
-- [start-game schema](../../schema/schemas/start-game.schema.yaml)
+- [start-game schema](../../../schema/schemas/start-game.schema.yaml)

docs/architecture/c4-views/booter-components.md

@@ -8,7 +8,7 @@
 
 ## Architecture Diagram
 
-![Booter Components](/docs-internal/architecture/c4-views/images/component-Booter.svg)
+![Booter Components](./images/component-Booter.svg)
 
 ---
 

docs/architecture/c4-views/structurizr-dsl/INDEX.md

@@ -12,4 +12,3 @@
 | [gui-components.dsl](./gui-components.dsl) | C4 Level 3 — GUI Components |
 | [booter-components.dsl](./booter-components.dsl) | C4 Level 3 — Booter Components |
 | [recorder-components.dsl](./recorder-components.dsl) | C4 Level 3 — Recorder Components |
-| [runner-components.dsl](./runner-components.dsl) | C4 Level 3 — Runner Components |

docs/architecture/models/flows/bot-connection.md

@@ -567,8 +567,8 @@ netstat -an | grep 7654
 - **[Turn Execution Flow](./turn-execution.md)** — What happens after game starts
 - **[Handshakes](../message-schema/handshakes.md)** — Handshake message schemas
 - **[Events](../message-schema/events.md)** — Event message schemas
-- **[ADR-0001: WebSocket Protocol](../../adr/0001-websocket-communication-protocol.md)** — Protocol design
-- **[ADR-0002: Cross-Platform Bot APIs](../../adr/0002-cross-platform-bot-api-strategy.md)** — API design
+- **[ADR-0009: WebSocket Protocol](../../adr/0009-websocket-communication-protocol.md)** — Protocol design
+- **[ADR-0003: Cross-Platform Bot APIs](../../adr/0003-cross-platform-bot-api-strategy.md)** — API design
 - **[ADR-0035: Bot Debugger Detection](../../adr/0035-bot-debugger-detection.md)** — `debuggerAttached` field
 
 ---

docs/architecture/models/flows/turn-execution.md

@@ -746,7 +746,7 @@ for (Bot other : nearby) {
 - **[State Objects](../message-schema/state.md)** — Bot state and bullet state schemas
 - **[Events](../message-schema/events.md)** — Tick events and bot gameplay events
 - **[Intents](../message-schema/intents.md)** — Bot intent message schema
-- **[ADR-0003: Game Loop](../../adr/0003-realtime-game-loop-architecture.md)** — Design rationale
+- **[ADR-0011: Game Loop](../../adr/0011-realtime-game-loop-architecture.md)** — Design rationale
 - **[ADR-0033: Server Debug Mode](../../adr/0033-bot-debug-mode.md)** — Turn-by-turn stepping
 - **[ADR-0034: Breakpoint Mode](../../adr/0034-breakpoint-mode.md)** — Per-bot breakpoint pause
 - **[Schema YAML Definitions](/schema/schemas/)** — Raw YAML message format specifications