Documentação de Requisitos com IA Generativa
Ir para notas que citam estaDocumentação de requisitos com IA generativa é usar um assistente conversacional para levantar, redigir, revisar e detalhar os requisitos de um sistema, apontando lacunas esquecidas.
O analista de requisitos faz a ponte entre clientes, usuários e equipe de desenvolvimento. Ele entende as necessidades, registra os requisitos de forma clara e precisa e garante que o time compreenda o que vai construir. Boa parte desse trabalho é escrita: especificações, casos de uso, histórias de usuário, diagramas de fluxo. Quando a IA assume a redação rotineira, sobra tempo para o que agrega mais valor, como a análise crítica dos requisitos e a conversa com as partes interessadas.
A qualidade do software começa antes do código. Requisito mal levantado gera refatorações sucessivas feitas sem entender o que se pede, e isso afeta tanto quem implementa agora quanto quem mantém depois. A prática também ajuda quem precisa vestir o chapéu de analista sem ter essa formação, situação comum em times sem a função dedicada, e se aproxima da Elicitação de Requisitos com Sistema Multiagente, que automatiza o diálogo com as partes interessadas por meio de vários agentes.
Construção incremental, um tópico por vez
Um estudo de caso ilustra o fluxo: um aplicativo fictício de controle de frequência de alunos, voltado a professores, sem cadastro de usuários e que precisa funcionar sem internet. Com só essas informações e o pedido de apontar lacunas, o assistente levantou pontos que ninguém tinha mencionado: segurança do login e gerenciamento de senhas, sincronização dos dados quando a conexão voltar e backup.
A documentação cresceu por partes. Primeiro uma lista de pontos importantes, depois tópicos por tela e função (login, home, frequência, sincronização), cada um pedido separadamente. Anotações informais e resumidas, do tipo "depois do login vai para a home", voltavam como texto formal e detalhado. Quando se registrou que o app precisaria de uma cópia do banco no dispositivo para operar offline, a IA acrescentou e desenvolveu o ponto.
O ritmo que funcionou foi o de uma reunião de levantamento: comandos curtos, pouca informação por vez. Despejar tudo de uma vez tende a produzir respostas rasas, e informação de menos também atrapalha. É um ajuste fino de Engenharia de Prompt. A conversa pôde ser retomada no dia seguinte, na mesma thread, sem reexplicar o contexto.
A IA como revisora do documento
Com o documento quase pronto, pedir uma revisão trouxe novas lacunas: controle de concorrência de dados, necessário justamente porque o app funciona offline, mais detalhe sobre cenários de falha e a recomendação de descrever melhor as tabelas do banco.
Duas técnicas simples deram retorno. Pedir uma nota de 0 a 100 para cada tópico, mesmo sem definir critérios, gerou pontos positivos, pontos negativos e a nota, o que orienta a próxima rodada de melhorias. E simular a dúvida de um desenvolvedor (o que acontece no login se não houver internet?) produziu uma resposta satisfatória que entrou direto no documento. No fim, um rascunho informal virou uma especificação formal e detalhada, com uma vulnerabilidade que o autor não tinha percebido. Aplicado a requisitos reais, o mesmo exercício revela falhas que dá para levar ao planejamento da sprint e corrigir antes de chegarem ao código.
Limites: diagramas e nomes inventados
Diante do script de criação do banco de dados, o assistente entendeu o texto, mas não gerou o diagrama de relacionamento entre as tabelas. A tentativa em outro assistente, o Copilot do Bing, também não deu o resultado esperado na primeira vez. Ao montar uma consulta que cruzava tabelas com joins, a IA inventou uma tabela chamada tb_aluno, quando no domínio o nome correto era tb_discente. Em outro momento, incluiu um ponto sobre criação de usuários, que tinha sido excluída de forma explícita.
O nome de tabela inventado é Alucinação por falta de contexto: o esquema real nunca foi informado. A IA dá um bom norte, mas não substitui o analista, e cada trecho gerado passa por revisão humana antes de virar requisito.