adr-0008-governanca-de-uso-de-ia-no-projeto

Decisão

A Inteligência Artificial será utilizada como assistente técnico, nunca como autoridade decisória final.

---

1. Princípios Gerais

1. IA não substitui decisão arquitetural humana.
2. Toda decisão estrutural deve ser formalizada via ADR.
3. IA não pode realizar commits automáticos sem revisão.
4. Código gerado por IA deve ser revisado antes de merge.
5. 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.