// Verify every @path chain import and every markdown link inside every CLAUDE.md in this project resolves to an existing file. Read-only — returns broken links with file:line refs, never edits.
Re-detect this project's tech stack from package.json / requirements.txt / pyproject.toml / go.mod / Cargo.toml and diff it against the Tech Stack section of every CLAUDE.md. Read-only — returns added / removed / renamed dependencies, never edits.
Audit every CLAUDE.md in this project for drift against the last week of git history. Flags sections that reference deleted files, renamed paths, or removed dependencies. Read-only — returns a punch list, never edits.
Behavioral guardrails for LLM-assisted coding. Use when writing, reviewing, or refactoring code in any project to avoid overcomplication, keep changes surgical, surface assumptions early, and execute against verifiable success criteria.
Analyzes, generates, and enhances CLAUDE.md files for any project type using best practices, modular architecture support, and tech stack customization. Use when setting up new projects, improving existing CLAUDE.md files, or establishing AI-assisted development standards.
| name | claude-md-link-check |
| description | Verify every @path chain import and every markdown link inside every CLAUDE.md in this project resolves to an existing file. Read-only — returns broken links with file:line refs, never edits. |
| when_to_use | Use when the user asks "check my CLAUDE.md links", "are the @-imports still valid?", "find broken cross-references", or as part of /sync-claude-md --weekly. |
| argument-hint | [path-glob] |
| context | fork |
| agent | Explore |
| allowed-tools | ["Read","Glob","Grep","Bash(find:*)","Bash(test:*)","Bash(ls:*)"] |
| disable-model-invocation | false |
Optional path-glob: $ARGUMENTS (default . — entire tree).
Run these steps in order. Do not modify any file.
find <root> -name "CLAUDE.md" -type f -not -path "*/.git/*" -not -path "*/node_modules/*". Also include .claude/rules/*.md. Record paths.^@\S+. The literal after @ is a relative path.[text](target) where target is not an HTTP(S) URL, not mailto:, not a bare anchor #section.Read on the parent file to confirm position, then test -e <resolved-path> or Glob).
@../CLAUDE.md inside skill/CLAUDE.md, resolved path is CLAUDE.md.[Backend](backend/CLAUDE.md) inside the root, resolved path is backend/CLAUDE.md.## 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.
## 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).