Governança

O fluxo de trabalho padronizado que toda tarefa segue, e as regras que o agente aplica enquanto trabalha.

Framework de Governança

Princípios de Governança

Princípios que mantêm você e o agente construindo a mesma coisa.

1. Blindagem

Segurança por Padrão

Configuration isolation and boundary-level security enforcement. Fail-fast protocols for incomplete environments. Default-to-deny access control.

2. Resiliência

Tolerância a Falhas

Defensive design for system stability and execution repetition. Idempotency and failure management protocols (graceful degradation) are mandatory standards.

3. A Cascata

Código como História

Caller-callee separation using top-down orchestration. Entry points must reveal high-level logic through vertical density and para-logical grouping.

4. Excelência Visual

Consistência

Rigorous adherence to semantic design tokens. High-contrast typography and layout consistency for technical interfaces.

5. Barreiras

Controle de Escopo

Restricted scope execution. Atomic actions only. Do not modify code outside the explicit project plan. Modifications are limited to files and functions defined in the current sprint.

6. Reflexão

Raciocínio Primeiro

Systematic architecture evaluation. Perform an internal reasoning trace before proposing plans or generating code blocks.

7. Protocolo

O Portão Soberano

Project rules override model training defaults. The agent recites the Work Checklist before writing, stops at SPEC and PLAN for approval, and never commits without explicit human authorization.

8. Eficiência de Contexto

Disciplina de Tokens

Maximize signal, minimize context rot. Prefer programmatic research over raw reads, load skills on demand, and reset context when history stops serving the current cycle.

Ciclo de Vida do Software (SDLC)

Oito etapas, do início do projeto até a produção. Cada uma se apoia na anterior.

1. Fundação

Configure o linter e as configurações base. Acerte os fundamentos desde o começo.

2. Observabilidade & Segurança

Adicione logging, rastreamento de erros e os padrões de segurança que o time sempre deve ter.

3. Esteira CI/CD

Configure o CI/CD para que cada push rode as mesmas verificações automaticamente.

4. Controle de Acesso

Adicione autenticação e controle de acesso. Defina quem pode fazer o quê e onde.

5. Padronização da Interface

Construa a biblioteca de componentes e defina os tokens de design para a UI ficar consistente.

6. Novas Funcionalidades

Entregue funcionalidades usando os padrões e a estrutura de domínio estabelecidos nas etapas anteriores.

7. Pronto para Produção

Verifique o pipeline de deploy de ponta a ponta, incluindo como fazer rollback de forma limpa.

8. Governança Operacional

Monitore em produção e mantenha um roteiro claro para quando algo sair do controle.

Regras de Governança

Todos os padrões de qualidade em um só lugar, para uma engenharia sólida.

Design de API: Consistência, Resiliência e Contratos

Architecture4 regras

A Lei da Resiliência (Confiabilidade do Contrato)
A Lei da Blindagem (Mascaramento de Dados)
A Lei da Cascata (Narrativa de Endpoint)
Protocolos de Alinhamento

Acesso a Dados: Performance, Segurança e Escalabilidade

Architecture8 regras

Gerenciamento de Conexão
Performance de Consulta
Estratégia de Indexação
Paginação
Estratégia de Caching
Migrações & Evolução de Esquema
Limites de Transação
Integridade de Dados no Nível do Banco