diff --git a/tools/coherence/README.md b/tools/coherence/README.md
index 8788017..54a6424 100644
--- a/tools/coherence/README.md
+++ b/tools/coherence/README.md
@@ -9,6 +9,7 @@ Tools for maintaining site coherence.
 | check-frontmatter.py | Validates YAML frontmatter exists | `python3 check-frontmatter.py <dir>` |
 | check-metadata.py | Validates required fields | `python3 check-metadata.py <dir>` |
 | fix-frontmatter.py | Adds missing frontmatter | `python3 fix-frontmatter.py <dir>` |
+| check-links.py | Finds broken internal links | `python3 check-links.py <dir>` |
 
 ## Usage
 
@@ -16,13 +17,15 @@ Tools for maintaining site coherence.
 # Check all fieldnotes
 python3 check-frontmatter.py ../public/fieldnotes/
 python3 check-metadata.py ../public/fieldnotes/
+python3 check-links.py ../public/fieldnotes/
 
-# Fix missing frontmatter (dry run first!)
+# Fix missing frontmatter
 python3 fix-frontmatter.py --dry-run ../public/fieldnotes/
 python3 fix-frontmatter.py ../public/fieldnotes/
 ```
 
 ## Exit Codes
 
-- 0: Success
+- 0: Success / No issues
+- 1: Issues found
 - 2: Invalid arguments