Guardrails de Arquitetura e Segurança¶
Recurso do plano Enterprise
Guardrails de organização estão disponíveis no plano Enterprise.
Guardrails são os padrões de arquitetura e segurança que o N45.AI respeita em todo discovery, spec, quick-feat e hot-fix de uma organização. É como o Owner garante que tudo que o N45 planeja e constrói — em qualquer projeto ou workspace da org — já nasce dentro das regras da casa.
Quem define, e onde¶
O Owner da organização define os guardrails na conta N45 (web), em Guardrails. São duas listas, cada linha um item:
- Padrões de arquitetura — ex.: usar Postgres (não Mongo); arquitetura hexagonal; erros sempre com wrap; testes obrigatórios no domínio.
- Guardrails de segurança — políticas que o N45 deve respeitar, inclusive em quick-feat e hot-fix.
Os guardrails são versionados: cada alteração vira uma nova versão, com histórico de quem mudou e quando.
Poucas regras, bem escolhidas
Os guardrails entram em toda execução. Muitas regras aumentam o custo de token e diluem o foco — prefira consolidar num conjunto enxuto de padrões que realmente importam.
Como o N45 aplica¶
Os guardrails são um piso sempre-ligado: valem pra todos os membros da org, sem ninguém precisar lembrar de ativá-los. Durante o planejamento (discovery e spec), o N45:
- Adequa a spec ao padrão — reescreve o que estava proibido pra alternativa aprovada, e adiciona o que é exigido (ex.: os testes obrigatórios).
- Avisa quando fez esse ajuste, pra ficar transparente o que mudou e por quê.
- Marca como
rejectedquando a intenção é irreconciliável com um guardrail (ex.: pede explicitamente algo proibido). É revisável — você ajusta a intenção ou o Owner revê o guardrail.
Assim a governança acontece na origem do trabalho, não como um veto no fim.