doc-align

doc-align pega um plano que você já tem e o testa contra o que o projeto já decidiu — seu glossário CONTEXT.md e seus ADRs — fazendo grilling em você uma pergunta por vez até o plano e o projeto falarem a mesma língua.

O que resolve

Um plano escrito no vácuo deriva do código de dois jeitos silenciosos: usa um termo pra dizer algo que o glossário já define diferente, e assume um design que os ADRs já descartaram. Nenhum aparece até a implementação, quando o descompasso é caro de desfazer. doc-align revela essas contradições antes do trabalho começar — e, de quebra, mantém os próprios docs do projeto honestos.

Como resolve

• Grilling, uma pergunta por vez — interroga o plano contra o glossário e as decisões de record, o mesmo ritmo uma-decisão-por-vez do interview, mas ancorado em documentos existentes.
• Revelar contradições — quando sua afirmação conflita com o código real ou uma decisão registrada, ele nomeia o conflito em vez de deixar passar.
• Atualização preguiçosa de docs — conforme os termos se resolvem no grilling, atualiza CONTEXT.md e os ADRs no lugar, então o alinhamento melhora a fonte da verdade, não só o plano.

É a contraparte do interview (que funciona greenfield, sem docs), faz par com doc-prd (que publica o plano alinhado), e o refactor-deepen o chama pros seus próprios sub-loops de grilling.

Quando usar

Quando um plano ou design já existe e você quer validá-lo contra a linguagem e as decisões do projeto antes de construir. Pra uma ideia nova sem plano, comece com interview.