coherence-checklisted
Install: claude install-skill ChindanaiNaKub/openthought
# Coherence checks
Two tiers. Deterministic rules are pure functions over the graph and run instantly.
Judgment checks need a reader, which is you, and their answers are cached by content
hash so an unchanged pair is never judged twice.
## Tier 1: deterministic
```
coherence check # everything, human-readable
coherence check --json # machine-readable
coherence check --severity warn # this severity and worse
coherence check --no-judgment # skip cached verdicts
```
(Commands assume `coherence` on PATH; a repo may vendor it at `bin/coherence`
instead. Use whichever exists.)
Exit code 1 means at least one `block`-severity finding. The thirteen rules:
| check | fires when |
|---|---|
| `dead-link` | a `parent:` or `serves:` points at an id that doesn't exist |
| `orphan` | non-root artifact with no parent, so nothing connects it to the mission |
| `illegal-parent` | the level chain is broken (a story hanging off a bet) |
| `duplicate-id` | two files claim the same id |
| `duplicate-singleton` | more than one live mission |
| `stale-premise` | live work whose ancestor is `dropped` or `done` |
| `lifecycle-contradiction` | done artifact with live children or unticked criteria |
| `decomposition-gap` | active bet/goal/project with no children, a sentence rather than a plan |
| `coverage-gap` | a user or problem nothing serves |
| `unrealized-commitment` | done story whose `code:` globs match no files |
| `priority-inversion` | child ranked mor