claude-md-link-check

CLAUDE.md Link Check (forked, read-only)

Optional path-glob: $ARGUMENTS (default . — entire tree).

Run these steps in order. Do not modify any file.

1. Inventory. find <root> -name "CLAUDE.md" -type f -not -path "/.git/" -not -path "/node_modules/". Also include .claude/rules/*.md. Record paths.
2. Extract candidates from each file:
3. Chain imports — lines matching ^@\S+. The literal after @ is a relative path.
4. Markdown links — [text](target) where target is not an HTTP(S) URL, not mailto:, not a bare anchor #section.
5. Resolve each candidate relative to the file containing it (use Read on the parent file to confirm position, then test -e <resolved-path> or Glob).
6. For @../CLAUDE.md inside skill/CLAUDE.md, resolved path is CLAUDE.md.
7. For [Backend](backend/CLAUDE.md) inside the root, resolved path is backend/CLAUDE.md.
8. Return the report in this exact shape:

## Link Check

Files inspected: <count>
References checked: <chain_imports> @-imports, <md_links> markdown links

### Broken
- <file>:<line> — `<original-target>` → does not resolve (expected `<absolute-path>`)
- ... (omit section if empty)

### Clean
<count> references resolved.

1. If everything resolves, return exactly ## Link Check\n\nAll <N> references resolved across <M> files.. Do not pad.

Hard rule: never invent a fix. Report the broken target verbatim. Repair is the user's call (or /sync-claude-md's).