| name | write-guardrail |
| description | Cria e valida Guardrails determinísticas — scripts, linters, analyzers, testes arquiteturais ou políticas executáveis — para verificar se uma guideline foi seguida nos projetos. Use ao escrever ou promover uma guideline, criar seu check automático, definir fixtures ou conectar enforcement ao Architecture Graph. |
Write Guardrail
Transformar a regra da guideline em observação determinística. Ler
references/quality-gate.md antes de criar o mecanismo.
Fluxo
- Ler candidato, guideline em autoria, ADR e blips relacionados.
- Escolher o menor sinal determinístico capaz de reprovar a violação.
- Implementar script, linter, analyzer, architecture test ou policy.
- Criar fixture conforme e fixture não conforme.
- Provar que a primeira passa e a segunda falha pelo mesmo comando.
- Preencher o template de Guardrail e validar internamente.
- Entregar o input à promoção atômica de
write-guideline.
- Validar no grafo os vínculos recíprocos
verified-by e verifies.
Não usar LLM como executor da Guardrail. LLM pode ajudar a escrevê-la, mas a
decisão de conformidade deve ser reproduzível com a mesma entrada e comando.
Uma guideline vigente não pode existir sem Guardrail ativa. Se o check ainda não
é viável, manter o candidato pendente ou a guideline em draft fora da promoção.
