| name | write-guideline |
| description | Promove candidatos de guideline aprovados a convenções pequenas, verificáveis e rastreáveis no Architecture Graph. Usar quando o usuário pedir para escrever, formalizar, publicar ou ativar uma guideline a partir de um candidato revisado. |
Write Guideline
Promover somente um guideline-candidate:gc-NNNN com review.status: approved.
Fluxo
- Localizar o repositório central por
architecture.yaml.
- Ler integralmente o candidato, os blips e a ADR normativa indicada.
- Confirmar uma regra atômica, imperativa e com severidade RFC 2119.
- Exigir owner, escopo, quando usar/não usar, how-to, instruções para IA e exceções.
- Exigir exemplos de código estruturados, conforme e não conforme, com explicação.
- Usar
write-guardrail para criar e provar o check determinístico nas duas fixtures.
- Executar internamente a promoção com inputs de Guideline e Guardrail.
- Validar os vínculos recíprocos e o repositório completo.
- Apresentar a guideline, a Guardrail e seu rastro no grafo.
Não pedir ao participante para executar Node ou terminal. Esses mecanismos são internos ao plugin, salvo pedido explícito de diagnóstico.
Uma guideline vigente deve declarar suggested-by, implements, applies-to e
verified-by. A Guardrail deve declarar verifies de volta. A promoção cria os
dois artefatos como um único bundle; não publicar guideline ativa sem Guardrail.