looping-agent

Orquestrador de testes QA end-to-end. Recebe PRD e/ou techspec, conduz entrevista para extrair expectativas do usuario, analisa requisitos, propoe plano de tasks por user story/feature, aguarda aprovacao do usuario, cria estrutura de evidencias, dispara subagentes via qa-task-runner e consolida relatorio final. Usar quando: executar testes QA; validar PRD/techspec; criar plano de testes E2E; orquestrar subagentes de teste.

Sample skill fixture used by installer tests.

Conduz análise semântica de uma tarefa implementada validando linha a linha contra PRD, TechSpec e task spec, e aplicando padrões do stack. Use no reviewer após flow-quality-checks passar. Não use se o pipeline de qualidade falhou — corrija o build primeiro.

Cria API Contracts (OpenAPI 3.1) como ponto de sincronização entre frontend e backend, a partir de um PRD existente. Use esta skill sempre que o usuário quiser definir o contrato de API, gerar OpenAPI spec, criar API-first design, sincronizar front e back, ou quando mencionar "contrato de API", "OpenAPI", "swagger", "API-first", "schema da API", "endpoints da API". Também dispare quando o usuário disser "vamos definir a API antes de implementar", "o front e o back não se encaixam", "quero mockar a API", "preciso do contrato antes de começar o frontend". Esta skill é a etapa 1.5 do pipeline PRD → API Contract → TechSpec (Backend) → TechSpec (Frontend) → Tasks. Requer que o PRD já exista em `tasks/prd-[nome-funcionalidade]/prd.md`.

Cria Domain Documents (Nível 1) para domínios específicos de um sistema complexo. Use esta skill sempre que o usuário quiser detalhar um domínio, módulo ou bounded context após o Vision Doc estar aprovado. Dispare quando o usuário mencionar "domain doc", "detalhar o domínio X", "documentar o módulo X", "bounded context", "quais features do domínio X", "vamos detalhar o financeiro/RH/estoque" ou qualquer variação que indique a necessidade de aprofundar um domínio específico antes de criar PRDs. Esta skill é o Nível 1 do pipeline Vision → Domain → PRD → TechSpec → Tasks. Requer que o Vision Doc já exista em `vision.md`. O documento gerado serve como entrada para a skill `flow-prd-creator`.

Exige evidência fresca de verificação antes de qualquer claim de conclusão, aprovação ou commit. Use quando um agente está prestes a declarar sucesso, aprovar uma tarefa ou fazer commit. Não use para planejamento inicial, brainstorming ou tarefas que ainda não chegaram em um passo concreto de verificação.

Persona e workflow do Finalizer no loop de execução do Looping Agent. Use esta skill quando o orquestrador invocar uma sessão ACP da fase de finalização, ou quando o desenvolvedor quiser fechar manualmente uma task aprovada (commit + integração linear) seguindo o mesmo padrão determinístico do loop. Dispare também quando o input mencionar "finalizar task N", "commitar e mergear", "rodar finalizer", "fechar task aprovada". A skill estabelece a persona, atualiza `tasks.md`, agrega todos os artefatos no commit, aplica o fluxo git linear (rebase + ff-only) e termina invocando o tool_call de conclusão `report_finalizer_result`.

Cria Especificações Técnicas de Frontend a partir de um PRD e de um API Contract obrigatório. Use esta skill sempre que o usuário quiser criar a tech spec do frontend, definir arquitetura de UI, estratégia de fetching, gerenciamento de estado, geração de tipos a partir de OpenAPI, ou quando mencionar "techspec frontend", "spec do frontend", "arquitetura do front", "como consumir essa API", "tipos do frontend", "estado global vs local". Esta skill é a etapa de TechSpec frontend do pipeline PRD → API Contract → TechSpec Backend / TechSpec Frontend → Tasks. Requer que o PRD exista em `tasks/prd-[nome-funcionalidade]/prd.md` E que o API Contract exista em `tasks/prd-[nome-funcionalidade]/api-contract.yaml`. Para TechSpec de backend ou features não-API, use a skill `flow-techspec-creator`.

Aplica fluxo git linear (rebase + merge fast-forward) para integrar uma feature branch em main, garantindo histórico limpo para tarefas curtas (1-2 commits). Use no finalizer após a revisão aprovar. Não use para branches com múltiplos commits complexos que exigem preservação de histórico (squash ou merge commit).

Persona e workflow do Implementer no loop de execução do Looping Agent. Use esta skill quando o orquestrador invocar uma sessão ACP da fase de implementação, ou quando o desenvolvedor quiser executar manualmente uma única task de PRD seguindo o mesmo padrão determinístico do loop. Dispare também quando o input mencionar "implementar task N", "executar tarefa", "implementar este task spec", "rodar implementer". A skill estabelece a persona, carrega na ordem correta as skills de runtime (memória → grounding → stack → verificação), aplica os limites rígidos da fase e termina invocando o tool_call de conclusão `report_implementer_result`.

Cria Product Requirement Documents (PRDs) corporativos, autocontidos e acionáveis através de brainstorming estruturado. Use esta skill sempre que o usuário quiser criar um PRD, definir requisitos de produto, especificar uma nova funcionalidade, documentar uma ideia de produto, ou mencionar "PRD", "requisitos de produto", "documento de requisitos", "nova feature", "nova funcionalidade", "especificação de produto". Também dispare quando o usuário disser "quero construir X", "preciso de um plano para X", "vamos definir o escopo de X", ou qualquer variação que indique a necessidade de capturar requisitos antes de implementar. Funciona em dois modos: Pipeline Mode (com Vision Doc e/ou Domain Doc disponíveis, herdando contexto) ou Standalone Mode (discovery completo). Esta skill é a etapa PRD do pipeline corporativo Vision → Domain → PRD → TechSpec → Tasks.

Executa o pipeline completo de qualidade do stack (build, testes, lint, type check) e produz um relatório estruturado. Use no início da revisão, antes da análise semântica. Não use para execução de testes específicos (isso é atribuição do implementer durante desenvolvimento).

Registra telemetria estruturada de qualidade em docs/ai-dev/quality-ledger.md ao final de cada revisão, classificando problemas por categoria técnica e origem provável. Também gera resumo consolidado por PRD quando a última tarefa é concluída. Use sempre no reviewer, independente do resultado (aprovada ou rejeitada). Não use para logs operacionais ou memória de workflow.

Persona e workflow do Reviewer no loop de execução do Looping Agent. Use esta skill quando o orquestrador invocar uma sessão ACP da fase de revisão, ou quando o desenvolvedor quiser revisar manualmente uma task implementada seguindo o mesmo padrão determinístico do loop. Dispare também quando o input mencionar "revisar task N", "validar implementação", "rodar reviewer", "aprovar/reprovar task". A skill estabelece a persona, executa pipeline de qualidade + análise semântica, registra telemetria estruturada, gera o relatório de revisão e termina invocando o tool_call de conclusão `report_review_result`.

Identifica o stack do projeto (Java, .NET, React) e orienta quais skills do catálogo carregar antes de implementar ou revisar. Use sempre que um agente (implementer ou reviewer) precisar aplicar padrões específicos do stack. Não use para orquestração, tracking ou operações git.

Gera listas de tarefas abrangentes e detalhadas para implementação, baseadas em PRD e Especificação Técnica. Use esta skill sempre que o usuário quiser criar tarefas de implementação, quebrar uma funcionalidade em tasks, gerar um plano de execução, criar tickets de desenvolvimento, ou decompor trabalho técnico. Também dispare quando o usuário disser "criar tarefas", "gerar tasks", "quebrar em tarefas", "plano de implementação", "o que preciso implementar", "gerar tickets", ou qualquer variação que indique a necessidade de transformar um PRD/TechSpec em trabalho executável. Esta skill é a terceira etapa do pipeline PRD → TechSpec → Tasks. Requer que o PRD e a TechSpec já existam. As tarefas geradas são otimizadas para consumo por agentes de código (Cursor, Claude Code, etc.).

Orienta a execução de uma tarefa de PRD — leitura ordenada de fontes, detecção de conflitos, construção de checklist de execução e captura de sinal pré-mudança. Use sempre que um implementer for iniciar uma tarefa nova. Não use para remediação de PR, tarefas sem spec formal, ou refatorações fora de PRD.

Cria Especificações Técnicas detalhadas e prontas para implementação a partir de um PRD existente, com detecção automática de modo de operação (Standalone, Pipeline ou API-First). Use esta skill sempre que o usuário quiser criar uma tech spec, especificação técnica, documento de arquitetura, ou plano de implementação baseado em um PRD. Também dispare quando o usuário disser "como vamos implementar isso", "preciso da spec técnica", "vamos detalhar a arquitetura", "criar techspec", "gerar especificação técnica", ou qualquer variação que indique a necessidade de traduzir requisitos de produto em decisões técnicas e arquiteturais. Esta skill é a etapa TechSpec do pipeline Vision → Domain → PRD → [API Contract] → TechSpec → Tasks. Requer que o PRD já exista em `tasks/prd-[nome-funcionalidade]/prd.md`. Funciona de forma standalone, ou enriquecida com Vision Doc, Domain Doc e/ou API Contract quando disponíveis. Para TechSpec de frontend, use a skill `flow-frontend-techspec-creator`.

Cria o Vision Document (Nível 0) para sistemas grandes e complexos com múltiplos domínios, módulos ou perfis de usuário. Use esta skill sempre que o usuário quiser iniciar um sistema novo, modernizar um legado, ou estruturar um projeto grande antes de criar qualquer PRD. Dispare quando o usuário mencionar "sistema grande", "vários módulos", "ERP", "plataforma", "onde começo", "visão geral do projeto", "vision doc", "mapa do sistema", ou quando for evidente que o escopo é amplo demais para um único PRD. Esta skill é o Nível 0 do pipeline Vision → Domain → PRD → TechSpec → Tasks. Deve ser executada antes de qualquer Domain Doc ou PRD quando o sistema tiver mais de um domínio de negócio.

Compacta arquivos de memória do workflow (MEMORY.md e memory/*.md) quando ficam grandes ou ruidosos, preservando estado, decisões e riscos ativos. Use quando um arquivo de memória cresceu além do útil, tem repetição, logs longos ou narrativa cronológica. Não use para compactar código, documentos do PRD ou o quality-ledger.

Mantém memória do workflow entre execuções de tarefas do PRD — memória compartilhada (cross-task) e memória por tarefa. Use sempre que um agente (implementer ou reviewer) precisar ler, atualizar ou promover contexto durável entre execuções de tarefas. Não use para remediar PRs, preferências globais do usuário ou substituir o quality-ledger (que é telemetria de defeitos, não contexto operacional).