gap-and-contradiction-registerlisted
Install: claude install-skill synaptiai/synapti-marketplace
# Gap and Contradiction Register
Owns what the package does **not** know, and where its sources disagree. The evidence ledger asserts; this register refuses to.
## Iron Law
**NEVER RESOLVE A CONTRADICTION BY CHOOSING. Record both sides, name the decision impact, escalate to the owner.**
Picking the more convenient version is the single most damaging thing a documentation run can do, because the result is indistinguishable from a verified fact and carries the same authority.
## Two registers
| Register | ID | Records |
|---|---|---|
| Assumptions and open questions | `AQ-####` | Something required is not established: a silent source, an inaccessible system, an unstated owner, an assumption the package rests on |
| Contradictions | `CT-####` | Two or more sources disagree about the same claim |
Both live in one file because they answer the same reader question — "what is not settled here?" — and splitting them buries half the answer.
Column schemas and ID grammar: `references/register-schemas.md`.
## Gap classification
Classify on decision impact, not on effort to resolve.
| Class | Definition | Effect on the run |
|---|---|---|
| **Blocking** | Documentation would materially mislead a reader without resolution | Drafting of the affected document stops. Everything else continues |
| **Material, non-blocking** | The package can proceed with a visible qualification in the affected document | Draft with the qualification inline; the row stays open |
| **Minor** | Useful