Pre-ingestion quality gate for specifications and documents before they drive implementation. Use to score a spec/EPIC against a 13-item checklist (6-criterion rubric, must reach ≥9/10), surfacing hidden assumptions and ungrounded claims. Trigger on "score this spec", "is this spec ready", "run the clarity gate", "check this EPIC before implementation". A lightweight variant applies to routine docs.
How this skill is triggered — by the user, by Claude, or both
Slash command
/meaningfy-architecture:clarity-gateThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
A document is only as good as the assumptions it hides. The **Clarity Gate** is an
A document is only as good as the assumptions it hides. The Clarity Gate is an epistemic check run before a specification (EPIC, design, requirements) is allowed to drive code generation. It verifies that every claim is grounded, every assumption is made visible, and every requirement is specific enough to generate unambiguous output.
The primary failure mode it catches: a spec that reads fine but smuggles unstated assumptions which compound into defects downstream. Passing a readability check is not enough — the gate is designed to surface what the prose quietly assumes.
references/clarity-gate-checklist.md for the full checklist and scoring rubric.Owns: the readiness check for specs/docs — the checklist, the scoring, the ≥9/10 bar.
Does NOT own: producing the spec (that is epic-planning + the external stream-coding
method), writing code (cosmic-python), or writing the docs themselves (technical-writing).
The gate judges; it does not author.
Related: epic-planning (produces the EPIC the gate scores), stream-coding (the
doc-first method this gate sits inside), technical-writing (applies the lightweight check).
npx claudepluginhub meaningfy-ws/skillery --plugin meaningfy-architectureCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.