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
- Read existing
CONTEXT.md,CONTEXT-MAP.md, and relevant ADRs. - Identify overloaded, vague, or conflicting terms.
- Challenge terms against code and docs.
- Propose one canonical term and definition.
- Update
CONTEXT.mdwhen a term is resolved. - 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.