clarify-domain-docs

Installation
SKILL.md

Clarify Domain Docs

Resolve language and decisions before implementation.

Ask one question at a time. If code can answer the question, inspect the code instead of asking.

Process

  1. Read existing CONTEXT.md, CONTEXT-MAP.md, and relevant ADRs.
  2. Identify overloaded, vague, or conflicting terms.
  3. Challenge terms against code and docs.
  4. Propose one canonical term and definition.
  5. Update CONTEXT.md when a term is resolved.
  6. Offer an ADR only for decisions that are hard to reverse, surprising, and trade-off driven.

Use context-format.md and adr-format.md only when writing.

Rules

Installs
1
First Seen
Jul 9, 2026
clarify-domain-docs — mergemat/agent-readiness-skills