Do Coder ao Arquiteto Orquestrador A Nova Metodologia Ágil Assistida por IA

No cenário atual da engenharia de software, a Inteligência Artificial deixou de ser apenas uma ferramenta de preenchimento automático para se tornar um pilar estratégico. Esta transição exige que o desenvolvedor mude seu paradigma: de um mero escritor de linhas de código para um Arquiteto Orquestrador.

Nesta metodologia, a IA escalona a produtividade ao lidar com tarefas repetitivas (boilerplate), enquanto o humano foca na supervisão estratégica, padrões arquiteturais e segurança. Abaixo, apresento o framework de 10 passos para configurar esse ecossistema e maximizar sua entrega.

O Ecossistema: Cérebro (Estratégia) vs. Execução (Tática)

O modelo divide-se em duas camadas essenciais:

O Cérebro (NotebookLM): Repositório de inteligência de domínio onde reside o contexto estratégico.
A Execução (VSCode/IntelliJ + Copilot): O braço operacional que transforma diretrizes em código funcional.

O Setup em 10 Passos

1. Escolha das Ferramentas

A combinação preferencial envolve o NotebookLM para gestão de contexto e o VSCode/IntelliJ integrado ao Copilot. O Copilot atua como um hub de IAs, permitindo alternar entre modelos como Claude, Gemini e GPT conforme a complexidade da tarefa.

2. Consolidação de Fontes Técnicas

O NotebookLM possui um limite de 50 fontes por caderno. Portanto, a curadoria deve ser cirúrgica. Devemos consolidar Contratos de APIs (Controllers, DTOs), Esquemas de Dados (DDLs) e o Núcleo de Negócio (Interfaces de Service) em "Super Documentos" para oferecer uma visão holística à IA.

3. Pesquisa de Fontes Externas e Normas

Complemente o "Cérebro" com legislação, notas técnicas e resoluções que regem o sistema. Incluir documentações de APIs externas (como arquivos JSON) ajuda a mapear integrações críticas e propor DTOs assertivos.

4. Definição de Templates de Prompts

Utilize o framework RTF (Role, Task, Format): defina quem a IA deve ser (Persona), o que ela deve fazer (Tarefa) e como deve entregar (Formato). Para segurança, use "Salty Tags" (etiquetas aleatórias como <abcde12345>) para envolver instruções e evitar ataques de injeção ou alucinações.

5. Produção de Artefatos com Foco em Entregas

A estratégia gerada deve resultar em especificações que o Copilot transformará em código: Entities, Repositories e Controllers no backend, e componentes Angular com estilos SCSS no frontend, mantendo a paridade visual e funcional.

6. O "Contrato de Atuação" (Prompt Start)

Antes de iniciar, formalize o Prompt Start. Defina a persona da IA como um Arquiteto Sênior e peça que ela liste os microsserviços e padrões de comunicação identificados. Isso valida se o "Cérebro" está alinhado com as fontes antes da codificação.

7. Arquivo de Governança (copilot-instructions.md)

Crie este arquivo na raiz do projeto (.github/). Ele serve como o Manual de Conduta inegociável para o Copilot, estabelecendo regras como isolamento de dados (proibição de queries cross-database) e padrões de comunicação entre serviços.

8. Gestão de Contexto Ativo na IDE

Para maximizar a assertividade, mantenha abertos apenas os arquivos de referência necessários e utilize o comando @workspace para fornecer contexto global às requisições do chat na IDE.

9. Execução Incremental e Mitigação de Contexto

Evite o truncamento de código solicitando a implementação por partes (primeiro o Backend, depois o Frontend). Reinicie chats periodicamente para evitar a "compactação da janela de contexto", onde a IA começa a "esquecer" regras antigas devido ao limite de tokens.

10. Segurança e Higienização de Dados

É proibido incluir fontes com secrets, tokens, senhas ou strings de conexão. Dados sensíveis (PII) como CPFs reais devem ser excluídos, e pastas de compilação como node_modules e target devem ser ignoradas pelos scripts de consolidação.

Automação: O Script ConsolidarProjetos.ps1

Para viabilizar a alimentação do NotebookLM respeitando o limite de fontes, o Arquiteto utiliza scripts PowerShell para agrupar centenas de arquivos em poucos documentos de texto. Abaixo, o conteúdo técnico do script especializado para Backend e Geral:

# Nome do arquivo de saída consolidado
# Nome do arquivo de saída consolidado
$OutputFile = "Contexto_Projeto.txt"
$CurrentDir = Get-Location

# Remove o arquivo se ele já existir para evitar duplicidade
if (Test-Path $OutputFile) { Remove-Item $OutputFile }

# Extensões relevantes para o contexto técnico
$Extensions = @("*.java", "*.ts", "*.xml", "*.md", "*.sql")

# Pastas de "lixo técnico" ou sensíveis a serem ignoradas
$ExcludeFolders = @("node_modules", "target", ".git", ".idea", "dist", "bin", "obj")

Write-Host "Iniciando consolidação de arquivos em: $CurrentDir" -ForegroundColor Cyan

# Busca arquivos recursivamente aplicando os filtros de exclusão
$Files = Get-ChildItem -Path . -Include $Extensions -Recurse | Where-Object {
  $filePath = $_.FullName
  $shouldExclude = $false
  foreach ($folder in $ExcludeFolders) {
      if ($filePath -like "*\$folder\*") { $shouldExclude = $true; break }
  }
  !$shouldExclude
}

foreach ($File in $Files) {
  $RelativePath = Resolve-Path -Path $File.FullName -Relative
  Write-Host "Lendo: $RelativePath" -ForegroundColor Gray

  # Insere cabeçalho para o NotebookLM identificar a origem do código
  Add-Content -Path $OutputFile -Value "------------------------------------------"
  Add-Content -Path $OutputFile -Value "ARQUIVO: $RelativePath"
  Add-Content -Path $OutputFile -Value "------------------------------------------"

  # Concatena o conteúdo e adiciona quebra de linha
  Get-Content -Path $File.FullName | Add-Content -Path $OutputFile
  Add-Content -Path $OutputFile -Value "`n"
}
Write-Host "Sucesso! O arquivo $OutputFile foi gerado." -ForegroundColor Green

Ao adotar o papel de Orquestrador, o profissional escala sua produtividade sem perder o controle da arquitetura. A agilidade real não vem de "escrever código mais rápido", mas de gerir o conhecimento de forma que a IA trabalhe com precisão cirúrgica sobre um contexto sólido.

Fontes Utilizadas:

Metodologia Ágil Assistida por IA - dev - v2.docx
Artigo-Metodologia Ágil de Desenvolvimento Assistido por IA.docx
Engenharia de Prompt: Guia Completo 2025 - TecJustiça
AWS Orientação Prescritiva: Práticas para evitar ataques de injeção
Engenharia de Prompt: O Guia Definitivo - Picinini/HostGator
Manifesto Ágil e Princípios do Scrum