Squirrel — Habilidade de Desenvolvimento de Software Full-Cycle

Visão Geral

Squirrel é uma habilidade de codificação com IA full-cycle que funciona em 9 agentes de codificação com IA. Ela detecta automaticamente o estado do projeto (greenfield, em andamento ou maduro) e adapta seu pipeline de engenharia de 8 fases de acordo. Em vez de um fluxo de trabalho único para todos, ela descobre onde o projeto realmente está e entra exatamente no ponto certo.

Quando Usar Esta Habilidade

• Use ao iniciar um novo projeto do zero (greenfield)
• Use ao melhorar uma base de código existente (em andamento ou maduro)
• Use ao corrigir bugs, adicionar funcionalidades ou refatorar
• Use ao adicionar testes, linting ou CI/CD a um projeto
• Use ao escrever documentação de nível de produção
• Use quando o usuário disser "construa para mim", "conserte isso", "squirrel este projeto" ou qualquer tarefa de desenvolvimento com várias etapas

Como Funciona

Etapa 0: Detectar Modo

Squirrel classifica o diretório do projeto:

O Pipeline de 8 Fases

1. Descobrir — Entender o projeto (auditar código existente ou coletar requisitos)
2. Planejar — Lista de tarefas concretas com dependências e critérios de conclusão
3. Construir — Escrever ou modificar código (sub-agentes paralelos quando suportado)
4. Testar — Executar testes existentes, escrever novos, meta de 70%+ de cobertura
5. Caça a Bugs — Análise estática + revisão manual
6. Polir — Lintar, formatar, verificar tipos, remover código morto
7. Documentar — README + documentação inline (atualizar existente, não sobrescrever)
8. Entregar — Checklist final: testes verdes, sem segredos, CI configurado

Recuperação de Falhas (Regra de 3 Avisos)

1. Aviso 1: Corrigir o erro específico. Executar testes. Seguir em frente.
2. Aviso 2: Relê o código. Tentar uma abordagem diferente.
3. Aviso 3: PARAR. Reverter. Documentar o que falhou. Perguntar ao usuário.

Exemplos

Exemplo 1: Construir uma API REST

> build me a REST API for a todo app with TypeScript and Express

Squirrel detecta automaticamente o modo greenfield e executa todas as 8 fases.

Exemplo 2: Corrigir um bug

> fix this bug in src/auth/login.py

Squirrel entra no modo direcionado — auditoria abreviada, correção com escopo, verificação.

Exemplo 3: Melhorar projeto existente

> squirrel this project — add tests, fix lint errors, write README

Squirrel audita a base de código existente e, em seguida, aplica as fases 4-8.

Melhores Práticas

• Respeita o código existente — combina convenções de nomenclatura, framework de teste, estilo de importação e arquitetura
• Lê 2-3 arquivos semelhantes antes de escrever um novo
• Nunca suprime erros de tipo com as any ou @ts-ignore
• Nunca exclui testes que falham para "passar"
• Nunca deixa o código em um estado quebrado

Compatibilidade de Plataforma

Squirrel funciona em: Claude Code, Codex, Cursor, Antigravity, Gemini CLI, GitHub Copilot, Windsurf, OpenCode, Aider (9 no total).

Instale com:

# Universal installer
npx skills add flyingsquirrel0419/squirrel-skill

Limitações

• Não substitui a validação específica do ambiente ou a revisão de especialistas
• Modelos de CI/CD são pontos de partida, não garantias de implantação direta
• A execução paralela de sub-agentes depende do suporte da plataforma

Habilidades Relacionadas

• @brainstorming - Para planejar antes da implementação
• @test-driven-development - Para fluxos de trabalho orientados a TDD
• @systematic-debugging - Para resolução metódica de problemas