From c4c06809bdee3bd9508e5a66ff0b5c93caf06043 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mark=20Randall=20Havens=20=E2=96=B3=20The=20Empathic=20Tec?=
 =?UTF-8?q?hnologist?= <mark.r.havens@gmail.com>
Date: Fri, 13 Feb 2026 22:18:12 -0600
Subject: [PATCH] docs(tools): add coherence tools README

---
 tools/coherence/README.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 tools/coherence/README.md

diff --git a/tools/coherence/README.md b/tools/coherence/README.md
new file mode 100644
index 0000000..b28f0f3
--- /dev/null
+++ b/tools/coherence/README.md
@@ -0,0 +1,31 @@
+# Coherence Tools
+
+Tools for maintaining site coherence.
+
+## Tools
+
+| Tool | Purpose | Usage |
+|------|---------|-------|
+| check-frontmatter.py | Validates YAML frontmatter exists | `python3 check-frontmatter.py <dir>` |
+
+## Usage
+
+```bash
+# Check all fieldnotes
+python3 check-frontmatter.py ../public/fieldnotes/
+
+# Check single file
+python3 check-frontmatter.py file.md
+```
+
+## Exit Codes
+
+- 0: All files have frontmatter
+- 1: Some files missing frontmatter
+- 2: Invalid arguments
+
+## Adding New Tools
+
+1. Create new tool in this directory
+2. Add entry to this README
+3. Document usage and exit codes