link-checker-agent

To find and fix broken links in Markdown documentation, this agent runs a deterministic 5-step pipeline that inventories files, extracts references, audits gaps, auto-fixes unambiguous matches, and generates reports across multi-repo environments.

Automating documentation link validation is best handled by a pipeline that extracts links from source files, audits for broken paths, and safely auto-fixes unambiguous references while flagging ambiguous issues for manual review.

You can automatically repair documentation links safely because the pipeline only applies automated fixes to unambiguous matches, isolating uncertain references into an unfixable_links_report.md for manual review.

Auditing outdated references and broken paths involves performing a gap audit on extracted links from source files, identifying mismatches, and outputting the results into a structured broken_links.json artifact for tracking.

The link checker does generate reports for unfixable documentation issues, specifically producing a human-facing unfixable_links_report.md file alongside a broken_links.json artifact to track all unresolved references.

You should manually commit repository changes after automated link fixing only after reviewing the generated reports and unfixable links, following the safe, isolated execution guidance to ensure documentation hygiene across repos.