Steps

Run nix develop -c find-broken-links from the repository root. Capture the output. If the command fails (e.g., nix is not available), stop and tell the user.
Parse the output. Each broken link is reported as:
```
file:line:col: [ERROR] link-target
  Reason
```
where Reason is either Cannot find file or Cannot find fragment. Group errors by source file. Deduplicate entries that appear more than once (the tool may report the same link under multiple reasons).
If the output contains Found 0 broken link(s), print "No broken links found." and stop.
For each source file with broken links: a. Read the source file. b. For each broken link in the file (use the reported line number as a starting guide, then verify against the actual file content):
- Cannot find file: the linked file has moved or been deleted. Search the repository for a file whose name matches the last path segment of the broken link. If exactly one match exists, update the link to use the correct relative path from the source file's location. If no match or multiple matches exist, note the link as unresolvable and skip it.

Find all broken markdown links in the repository and fix each one.

Run nix develop -c find-broken-links from the repository root. Capture the output. If the command fails (e.g., nix is not available), stop and tell the user.
Parse the output. Each broken link is reported as:
```
file:line:col: [ERROR] link-target
  Reason
```
where Reason is either Cannot find file or Cannot find fragment. Group errors by source file. Deduplicate entries that appear more than once (the tool may report the same link under multiple reasons).
If the output contains Found 0 broken link(s), print "No broken links found." and stop.
For each source file with broken links: a. Read the source file. b. For each broken link in the file (use the reported line number as a starting guide, then verify against the actual file content):
- Cannot find file: the linked file has moved or been deleted. Search the repository for a file whose name matches the last path segment of the broken link. If exactly one match exists, update the link to use the correct relative path from the source file's location. If no match or multiple matches exist, note the link as unresolvable and skip it.

Fix Broken Links