Prompts úteis para agentes de IA
Copie um contrato completo para revisar o planejamento, instalar o ambiente local ou conduzir a implementação até testes, evidências e pull requests. Escolha o fluxo antes de começar e substitua os campos entre < >.
Escolha o fluxo
Use Revisão quando quiser um diagnóstico sem alterações. Use Instalação · Docker para baixar e subir o painel local pela primeira vez. Para executar tarefas, escolha Execução · Docker se o painel estiver em localhost ou Execução · Remoto se estiver em feature-rollout.dev. Os dois prompts de execução usam, por enquanto, sincronização manual de pull requests.
REVISÃODocumentos → tarefas → cenários → testes, somente leituraINSTALAÇÃO DOCKERImagem pública, volume persistente, bind local e health checkEXECUÇÃO DOCKERFeature Rollout local, lifecycle pelo Docker e recursos pelo dashboard/CLI/APIREMOTOFeature Rollout hospedado, identidade autenticada e atualização manual de PRCopie e personalize
Substitua os campos entre < > e anexe ou disponibilize os documentos e repositórios necessários. O agente deve manter como não demonstrado tudo que não conseguir verificar.
Audita documentos, tarefas, cenários e testes sem alterar o estado.
<FEATURE_ID><PROJETO_OU_PORTFOLIO>Atue como revisor de coerência e rastreabilidade da feature <FEATURE_ID>.
Contexto disponível:
- documentos anexados e suas versões;
- projeto/portfólio: <PROJETO_OU_PORTFOLIO>;
- tarefas, critérios de aceite, cenários e testes já mapeados na interface;
- repositório, quando estiver disponível, apenas para confirmar a implementação e os testes existentes.
Objetivo
Revise o material sem alterar arquivos, documentos ou o estado da interface. Verifique se o planejamento cobre fielmente os documentos e se existe rastreabilidade completa no sentido:
documento/requisito → tarefa/critério de aceite → cenário → teste.
Como revisar
1. Leia integralmente todos os documentos anexados. Identifique versão, escopo, regras de negócio, integrações, restrições e critérios explícitos. Quando houver conflito entre documentos, não escolha silenciosamente: registre a divergência e indique as versões envolvidas.
2. Confira cada tarefa contra os documentos:
- a tarefa é necessária e coerente com pelo menos um requisito;
- descrição, detalhes de implementação e critérios de aceite não contradizem o documento;
- os critérios são objetivos e verificáveis;
- não há requisito sem tarefa, tarefa órfã, duplicada ou com escopo maior que o autorizado.
3. Confira os cenários ligados a cada tarefa:
- todos os critérios de aceite estão cobertos;
- pré-condição, ação e resultado esperado são claros;
- existem fluxos positivos, negativos, limites e falhas relevantes;
- quando aplicável, cubra permissões, idempotência, retry/timeout, concorrência, persistência, auditoria e observabilidade;
- não há cenário órfão, duplicado, contraditório ou ligado à tarefa errada.
4. Confira os testes ligados a cada cenário:
- o teste realmente valida o resultado esperado, e não apenas possui um nome parecido;
- o nível do teste é adequado (unitário, integração, contrato ou E2E);
- os casos críticos e negativos possuem cobertura;
- não há teste sem cenário, cenário sem teste ou referência quebrada;
- diferencie teste mapeado, teste implementado e teste executado com sucesso. Não trate uma dessas condições como prova das outras.
5. Não invente requisitos, IDs, resultados ou evidências. Marque como “não demonstrado” tudo que não puder ser confirmado.
Entregável
Apresente:
A. um resumo executivo com a conclusão “coerente”, “coerente com ressalvas” ou “incoerente”;
B. uma matriz de rastreabilidade com: documento/requisito, tarefa, critério de aceite, cenário, teste e status;
C. lacunas e contradições ordenadas por severidade (bloqueante, alta, média, baixa), sempre citando os IDs e o trecho/regra de origem;
D. tarefas, cenários ou testes que precisam ser criados, corrigidos, removidos ou remapeados;
E. perguntas objetivas que dependem de decisão humana.
Para cada problema, explique o impacto e proponha a menor correção suficiente. Encerre informando os totais de requisitos, tarefas, cenários e testes revisados, quantos estão totalmente rastreados e quais bloqueiam a execução.O que significa concluir
Um fluxo executado não termina na implementação. Ele termina quando tarefas, cenários, testes, relatórios, evidências double-checked e pull requests contam a mesma história no commit e ambiente corretos.
TESTESTodos os casos pertinentes executados e passandoEVIDÊNCIASDescrição breve, vínculo correto e conteúdo conferidoCENÁRIOSPASS somente com implementação, teste e prova coerentesPULL REQUESTSMetadados sincronizados manualmente e ordem de merge explícita