Add helper script to resolve internal links.

Author: MarkvanMents

.claude/scripts/README.md

@@ -0,0 +1,38 @@
+# Claude Helper Scripts
+
+Utility scripts to support Claude Code when working with this documentation repository.
+
+## resolve-doc-url.sh
+
+Resolves a documentation URL to its source markdown file.
+
+### Usage
+
+```bash
+.claude/scripts/resolve-doc-url.sh "/path/to/page/"
+```
+
+### Examples
+
+```bash
+# Find the file for a specific URL
+.claude/scripts/resolve-doc-url.sh "/community-tools/contribute-to-mendix-docs/"
+# Output: content/en/docs/community-tools/contribute-to-mendix-docs/_index.md
+
+# Check if a URL exists
+.claude/scripts/resolve-doc-url.sh "/some/page/"
+# Exit code 0 if found, 1 if not found
+```
+
+### Benefits
+
+- **Fast**: Uses grep optimized for file-only output
+- **Token-efficient**: Returns only the file path, no surrounding context
+- **Reliable**: Matches exact URL in front matter using fixed-string search
+
+### When to Use
+
+- Following cross-references between documentation pages
+- Validating internal links
+- Finding files by their published URL
+- Checking if a URL is already in use

.claude/scripts/resolve-doc-url.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Resolve a documentation URL to its source markdown file
+# Usage: resolve-doc-url.sh "/path/to/page/"
+
+if [ -z "$1" ]; then
+    echo "Usage: resolve-doc-url.sh <url>"
+    echo "Example: resolve-doc-url.sh '/community-tools/contribute-to-mendix-docs/'"
+    exit 1
+fi
+
+# Search for the URL in front matter
+# Using grep with -l (files only) and -F (fixed string) for speed
+grep -rl --include="*.md" "^url: $1$" content/en/docs/
+
+# Exit code 0 if found, 1 if not found

CLAUDE.md

@@ -99,9 +99,14 @@ Call tools in parallel for independent operations (reading multiple files, multi
 * **Glob** – Use to find files by pattern (e.g., `*.md`, `**/*config*`)
 * **Grep** – Use to search file contents for specific text or patterns
 * **Write** – Use only for creating new files (prefer Edit for existing files)
+* **Helper Scripts** – Use `.claude/scripts/resolve-doc-url.sh` to resolve documentation URLs (e.g., `/path/to/page/`) to their source markdown files. This is faster and more token-efficient than using Grep to search front matter.
 
 ### Cross-Reference Verification
 
+When following or verifying documentation links:
+* Use `.claude/scripts/resolve-doc-url.sh "/path/to/page/"` to quickly find the source file for a URL
+* This is more efficient than Grep for URL-to-file lookups
+
 When modifying URLs or anchor IDs:
 1. Use Grep to search for the old URL/anchor across all documentation files
 2. Identify all references that need updating