ADR-0008 — Governança de Uso de Inteligência Artificial no Projeto
Status
Aprovado
Contexto
O projeto EBDbe utilizará ferramentas de Inteligência Artificial (IA) como apoio ao desenvolvimento, incluindo:
- Geração de código
- Sugestões arquiteturais
- Refatoração
- Auxílio na escrita de documentação
- Sugestões de comandos de terminal
Ferramentas previstas:
- Cursor IDE
- ChatGPT (para arquitetura e ADR)
O uso de IA pode acelerar o desenvolvimento, mas também introduz riscos como:
- Alterações estruturais não planejadas
- Código inconsistente com ADRs
- Execução indevida de comandos
- Perda de rastreabilidade decisória
É necessário estabelecer regras claras de governança.
Decisão
A Inteligência Artificial será utilizada como assistente técnico, nunca como autoridade decisória final.
1. Princípios Gerais
- IA não substitui decisão arquitetural humana.
- Toda decisão estrutural deve ser formalizada via ADR.
- IA não pode realizar commits automáticos sem revisão.
- Código gerado por IA deve ser revisado antes de merge.
- IA não altera diretamente configurações críticas sem validação manual.
2. Escopo Permitido para IA
IA pode:
- Sugerir código
- Gerar estruturas iniciais
- Refatorar trechos
- Propor melhorias
- Sugerir comandos de terminal
- Analisar múltiplos arquivos
- Auxiliar na criação de testes
3. Escopo Restrito
IA não pode:
- Executar push automático
- Alterar regras de segurança do Firestore sem revisão
- Modificar estrutura organizacional definida nos ADRs
- Alterar configurações sensíveis de autenticação
- Criar decisões arquiteturais sem ADR correspondente
4. Controle de Qualidade
Toda contribuição gerada por IA deve:
- Passar por revisão humana
- Estar alinhada aos ADRs vigentes
- Não violar princípios de domínio ou separação de camadas
- Ser testada localmente antes de integração
5. Registro de Decisões
Se uma decisão arquitetural for influenciada por sugestão de IA, essa decisão deve:
- Ser formalizada em ADR
- Registrar o racional técnico
- Não depender exclusivamente da sugestão automática
6. Segurança
IA não deve:
- Receber credenciais sensíveis
- Armazenar tokens de produção
- Operar com acesso irrestrito ao ambiente
7. Evolução
Caso o uso de IA evolua para modelo mais automatizado (agente executor), será necessário novo ADR revisando as diretrizes.
Consequências
- O uso de IA será disciplinado e auditável.
- O projeto mantém controle humano sobre decisões estratégicas.
- A arquitetura permanece consistente ao longo do tempo.
- A produtividade é aumentada sem comprometer governança.