docs(tools): add coherence tools README

This commit is contained in:
Mark Randall Havens △ The Empathic Technologist 2026-02-13 22:18:12 -06:00
parent aac95b56d0
commit c4c06809bd

31
tools/coherence/README.md Normal file
View file

@ -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