Sobre o projeto

Este é um pacote de habilidades open-source projetado para agentes de codificação com IA, criado por Addy Osmani para impor disciplina de engenharia em nível de produção em todo o ciclo de desenvolvimento de software. Ele aborda o problema comum de agentes de IA pular etapas críticas como escrita de especificações, testes, revisões de segurança e gates de qualidade, fornecendo workflows estruturados e opinativos que espelham as práticas de engenheiros seniores. O pacote inclui 25 habilidades no total: 24 habilidades focadas no ciclo de vida organizadas em 6 fases de desenvolvimento, mais 1 meta-habilidade para direcionar o trabalho ao workflow correto. As fases são: Definir (cobrindo entrevistas de requisitos, refinamento de ideias, desenvolvimento baseado em especificações e definição de restrições para esclarecer o que construir), Planejar (quebra de tarefas para decompor especificações em unidades verificáveis), Construir (implementação incremental, desenvolvimento orientado a testes, engenharia de UI frontend, design de API, engenharia de contexto, desenvolvimento orientado por fonte e desenvolvimento orientado por dúvidas para escrever código), Verificar (testes no navegador com DevTools e depuração/recuperação de erros para provar funcionalidade), Revisar (revisão de código, simplificação de código, endurecimento de segurança e otimização de desempenho para estabelecer padrões de qualidade), e Enviar (workflow git, automação CI/CD, descontinuação e migração, documentação e ADRs, observabilidade e instrumentação, e processos de lançamento para implantação em produção). Também inclui 4 personas de agentes especialistas pré-configuradas (revisor de código, engenheiro de testes, auditor de segurança, auditor de desempenho web) para tarefas de revisão direcionadas, e 7 checklists de referência cobrindo padrões compartilhados como definição de concluído, padrões de teste, segurança, desempenho, acessibilidade e observabilidade. O pacote suporta integração com mais de 70 agentes e ferramentas de codificação com IA, incluindo Claude Code (com suporte nativo a plugin e 8 comandos slash), Cursor, Antigravity CLI, Gemini CLI, Windsurf, OpenCode, GitHub Copilot, byNara IDE/CLI, Codex e Command Code, bem como qualquer agente que aceite prompts de sistema ou arquivos de instrução. Fornece 9 comandos slash principais mapeados para fases de desenvolvimento: /spec, /plan, /build, /test, /constraints, /review, /webperf, /code-simplify e /ship. O comando automático /buildsuporta execução autônoma de tarefas de plano e implementação após aprovação única do usuário, mantendo verificação test-driven por tarefa, commits individuais e pausa automática em falhas ou etapas de risco. As habilidades também ativam automaticamente com base no contexto da tarefa atual, como acionar habilidades de engenharia de UI frontend ao construir interfaces do usuário. Cada habilidade segue uma anatomia consistente com frontmatter, workflows passo a passo, tabelas anti-racionalização que contra-argumentam desculpas comuns de agentes para pular etapas (como "adicionarei testes depois"), requisitos de verificação não negociáveis que exigem evidências concretas em vez de julgamentos do tipo "parece certo", e revelação progressiva para minimizar o uso de tokens carregando apenas material de referência de suporte quando necessário. Os workflows incorporam práticas de engenharia comprovadas da cultura de engenharia do Google, incluindo a Lei de Hyrum para design de API, a Regra da Beyonce e a pirâmide de teste 80/15/5, normas de dimensionamento de alterações de cerca de 100 linhas para revisão de código, a Cercas de Chesterton para simplificação de código, desenvolvimento baseado em trunk para workflow git, Shift Left e feature flags para CI/CD, e uma mentalidade de código-como-passivo para descontinuação. O repositório inclui um guia de adoção tanto para projetos greenfield quanto para rollout incremental em codebases existentes, diretrizes de contribuição exigindo habilidades específicas, verificáveis, testadas no campo e mínimas, e um documento de comparação com pacotes de habilidades similares como Superpowers e as habilidades do Matt Pocock para ajudar os usuários a escolher a ferramenta certa para suas necessidades.