Add link-checker agentic workflow for automated documentation maintenance

[Copilot]

Automated daily workflow that finds and fixes broken HTTP(S) links in documentation files.

Implementation

Pre-processing step (bash script):

• Extracts all HTTP(S) links from docs/*.md and README.md using grep
• Tests each link via curl with 10s timeout
• Generates test report at /tmp/link-check-results.md

AI agent:

• Processes test results to identify broken links
• Uses cache-memory to skip known unfixable URLs
• Attempts fixes via web-fetch (URL variations, redirects, alternatives)
• Updates markdown files with working replacements
• Persists unfixable links to cache for future runs

Safe outputs:

• create-pull-request: Batch fixes with [link-checker] prefix
• noop: When all links working or all broken links cached as unfixable

Cache Memory Schema

{
  "unfixable_links": [
    {
      "url": "https://example.com/removed",
      "reason": "404 Not Found - content permanently removed",
      "first_seen": "2026-02-17"
    }
  ],
  "last_run": "2026-02-17"
}

Configuration

• Schedule: Daily on weekdays (fuzzy scheduling)
• Network: node, python, github ecosystems
• Tools: github (toolsets: default), cache-memory, web-fetch
• Timeout: 60 minutes

Files

• .github/workflows/link-checker.md - Workflow definition
• .github/workflows/link-checker.lock.yml - Compiled Actions workflow
• docs/link-checker.md - Documentation

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/github/gh-aw/git/ref/tags/v0.45.3
  • Triggering command: /usr/bin/gh gh api /repos/github/gh-aw/git/ref/tags/v0.45.3 --jq .object.sha (http block)
• https://api.github.com/user
  • Triggering command: /usr/bin/gh gh api user --jq .login (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.