I built a small CLI tool that scans a repo, checks which .md files are actually referenced in the root README, and reports the rest as "isolated". It also has an interactive fix option that appends the missing links directly into your README, and a GitHub Action if you want to enforce it in CI.
Single Python file, no config, runs offline. Would love feedback on whether the approach makes sense or if there are edge cases I haven't considered.