What problem does it solve?
It prevents contradictory, unverifiable, or poorly organized project fact files by enforcing strict state rules, lexical ordering, and structured density.
Core Features & Use Cases
- Verifiable Facts Only: Records objective, repo-grounded truths while rejecting subjective prose and unsupported claims.
- Contradiction Transparency: Detects and eliminates silent overwrites by replacing conflicting facts rather than appending them.
- Lexical Sorting & State Compression: Enforces strict alphabetical/natural ordering to preserve deterministic, high-density state representation.
- Reversibility Focus: Keeps history in Git diffs rather than embedding obsolete states inside the fact store.
Quick Start
Load the fact-writer skill and update FACTS.md or FACTS.mmd only by replacing or inserting verifiable nodes in strict alphabetical order after fully reading the current file contents.