---
name: domain-language
description: Alinhar termos de domínio, glossário e ADRs leves durante Idea, PRD, Tech Spec, Execution e Memory sem transformar glossário em spec.
---

# Domain Language SDD

## Objetivo

Evitar que agentes usem termos inconsistentes ou contradigam decisões documentadas. O discovery deve apontar `CONTEXT.md`, `CONTEXT-MAP.md` e `docs/adr/` quando existirem.

## Procedimento

1. Leia `CONTEXT-MAP.md` quando existir; senao procure `CONTEXT.md` no root e em contextos locais.
2. Leia ADRs relevantes antes de propor Tech Spec, refactor ou mudança dificil de reverter.
3. Quando um termo do usuário conflitar com o glossário, registre a divergencia e peça decisão humana no checkpoint.
4. Proponha ADR somente quando a decisão for dificil de reverter, surpreendente sem contexto e fruto de trade-off real.
5. Salve termos/decisões em artefatos SDD aprovados; atualização de glossário/ADR deve ser task explicita ou checkpoint.

## Regras

- `CONTEXT.md` e glossarios descrevem linguagem, não implementação.
- ADR aprovada tem precedencia sobre memória derivada.
- Não criar documentação nova durante discovery sem pedido explícito.

## Fonte externa

- Matt Pocock Skills: https://github.com/mattpocock/skills
