ai-toolkit

Use quando for projetar arquitetura técnica de uma feature ou projeto. Ativado por "arquitetura", "stack", "design técnico", "padrão de camadas". Requer PRD como entrada. Auto-skip para features pequenas — ir direto para harness-tasks.

Use quando for revisar código antes de abrir um PR, ou ao processar feedback de review. Ativado por "revisar", "code review", "review do PR", "blockers do review". É um sensor inferencial — executar após todos os sensores computacionais (lint, type check, testes) passarem.

Use quando for atualizar documentação após concluir uma user story ou feature. Ativado por "documentar", "README", "doc da API", "atualizar catalog", "atualizar AGENTS.md". Sempre executar após harness-testing para fechar o loop de entrega.

Pipeline completo de desenvolvimento de software com IA — PRD → Arquitetura → Tasks → Código → Review → Testes → Docs → CI/CD → Iteração. Baseado nas práticas de Harness Engineering da Anthropic, OpenAI e Thoughtworks/Martin Fowler: guias (feedforward) + sensores (feedback) que se auto-corrigem antes de chegar ao humano. Ative quando o usuário mencionar "criar PRD", "planejar feature", "iniciar projeto", "especificar", "arquitetura", "quebrar em tasks", "implementar", "code review", "gerar testes", "documentar", "CI/CD", "analisar feedback", "por onde começo", "como organizo o projeto com IA", "quero construir um app", "vamos iniciar", "quero desenvolver", ou qualquer combinação dessas ações. Combine com skills disponíveis (tlc-spec-driven, superpowers, context7) para máxima efetividade — verificar disponibilidade via `harness.config.yaml`.

Use quando for implementar uma task técnica do breakdown. Ativado por "implementar", "código", "implement T-XX", "executar task". Uma task por invocação. Requer PRD (seções relevantes) + arquitetura + AGENTS.md como contexto.

Use quando for analisar feedback de produção para planejar o próximo ciclo de desenvolvimento. Ativado por "analisar feedback", "próximo ciclo", "o que melhorar", "retrospectiva", "dados de uso". Esta etapa fecha o steering loop e reinicia o pipeline.

Use quando for criar um PRD, especificar uma feature ou iniciar um novo projeto. Ativado por "criar PRD", "especificar", "iniciar projeto", "o que definir antes de codar", "por onde começo", "quero construir um app". Invocar antes de qualquer arquitetura ou breakdown de tasks.

Use quando for decompor um PRD e arquitetura em user stories e tasks técnicas. Ativado por "quebrar em tasks", "planejar tasks", "breakdown", "sprint". Requer PRD + arquitetura como entrada.

Use quando for configurar pipelines de CI/CD, automatizar sensores ou criar quality gates contínuos. Ativado por "CI/CD", "pipeline", "deploy", "monitoramento", "configurar sensores". Esta etapa codifica todos os sensores computacionais e inferenciais em workflows automatizados.

Use quando for gerar ou auditar testes automatizados de uma feature ou task. Ativado por "gerar testes", "cobertura", "testar", "testes automatizados". Esta etapa produz os sensores computacionais do harness.