claude-dev-skill

O que é claude-dev-skill?

claude-dev-skill é uma skill personalizada para Claude Code que transforma o Claude em um processo de “tech lead” para construir software com múltiplos agentes de trabalho de IA. A skill fornece um fluxo de trabalho estruturado em múltiplas fases que coordena o trabalho paralelo de workers em worktrees isolados, visando reduzir perda de contexto e conflitos de merge ao rotear mudanças via PRs e revisão.

Seu propósito principal é ir além da geração de código single-threaded: guia alinhamento de requisitos (PRD), decisões de arquitetura, decomposição de tarefas, implementação paralela, verificações estáticas de QA e uma etapa estruturada de revisão/merge de PR.

Principais Recursos

• Fluxo de comando /dev (SOP multifase): Inicia com classificação do pedido e passa por alinhamento de PRD, arquitetura e criação de issues, implementação por workers, verificação de QA e coordenação de merge de PR.
• Regra de roteamento tech-lead: A conversa principal é tratada como coordenadora; ela “nunca escreve código diretamente”, exigindo que mudanças passem por Worker Agent → PR → processo de revisão.
• Agentes Worker Paralelos via worktrees: Cria múltiplos agentes worker que desenvolvem em paralelo em worktrees isolados para suportar diferentes partes da feature (ex.: auth, API, frontend).
• Scan de conflitos pré-codificação: Antes do trabalho começar, os agentes worker escaneiam outras Issues abertas por sobreposição de arquivos para detectar conflitos prováveis mais cedo.
• Coordenação de PR pós-merge: Após merges, escaneia PRs abertas e notifica branches que precisam de rebase.
• Gate de segurança antes da revisão: Exige execução de ferramentas de segurança (ex.: bandit mais pip-audit para Python, ou npm audit para Node) como etapa obrigatória antes da fase de revisão.
• Checklist estruturada de revisão de PR com condições de veto: Revisão de código via checklist de 7 itens com condições de veto obrigatórias.
• Auto-verificação por contraexemplos para cobertura de testes: Inclui auto-verificação de seis categorias para garantir que workers considerem cenários de Null/Empty/Boundary/External failure/Concurrency/Malicious input.

Como Usar claude-dev-skill

1. Instale os arquivos da skill no diretório de comandos do Claude Code (instalação via script para macOS/Linux/Windows, ou cópia manual preservando a estrutura de diretórios).
2. Certifique-se de ter o Claude Code (CLI oficial da Anthropic) logado.
3. Use o GitHub CLI (gh) com sessão autenticada (execute gh auth login primeiro).
4. No Claude Code, execute /dev [descrição opcional]. A skill classificará o pedido (ex.: novo projeto, nova feature, correção de bug, hotfix, mudança arquitetural, refatoração) e entrará no fluxo apropriado.

Uma execução típica segue as fases mostradas no repositório: alinhamento de PRD (duas rodadas), arquitetura e decomposição de tarefas com GitHub Issues, execução de workers em worktrees paralelos, verificação estática de QA e revisão de PR guiada por checklist e merge.

Casos de Uso

• Construindo uma feature de backend web pequena a média com PRD existente: Use /dev para traduzir um documento de requisitos de produto existente em decisões de arquitetura, GitHub Issues e implementações paralelas de workers.
• Implementando múltiplos módulos ao mesmo tempo minimizando conflitos de merge: Tenha agentes worker separados lidando com componentes diferentes (ex.: autenticação vs. API CRUD de tarefas vs. componentes frontend) e conte com scan de conflitos pré-codificação e coordenação de rebase pós-merge.
• Correção coordenada de bugs ou hotfix: Para correções de bugs ou hotfixes emergenciais, o fluxo classifica o tipo de pedido e o roteia por revisão de arquitetura, mudanças de worker, verificação de QA e merge estruturado de PR.
• Refatoração sistemática com revisão estruturada: Na refatoração, a auto-verificação por contraexemplos do SOP e o gate de segurança pré-merge ajudam a garantir que workers considerem casos de borda e executem ferramentas de auditoria obrigatórias antes da revisão.
• Trabalho de mudança arquitetural que requer alinhamento antes da codificação: Use alinhamento de PRD na Fase 1 e decisões de arquitetura na Fase 2 para esclarecer o plano da equipe antes de workers iniciarem a implementação.

FAQ

• O que significa “tech lead” no fluxo de trabalho desta skill? A conversa principal atua como coordenadora: alinha o PRD, decide a direção da arquitetura, cria agentes de trabalho e garante que as mudanças de código passem por PRs de Worker Agent e revisão, em vez de edições diretas no chat.

• O claude-dev-skill escreve código diretamente da conversa principal? Não. O fluxo inclui uma “regra de ferro” de que a conversa principal nunca escreve código diretamente; as mudanças devem passar por um Worker Agent e depois por um PR para revisão.

• Como os conflitos são tratados durante o desenvolvimento paralelo? A skill inclui uma verificação pré-codificação de conflitos (agentes de trabalho checam Issues abertas por sobreposição de arquivos antes de começar) e um passo pós-merge que escaneia PRs abertas para identificar branches que precisam de rebase.

• Quais verificações de segurança são impostas? Antes da fase de revisão, exige a execução de ferramentas de segurança como bandit mais pip-audit para Python, ou npm audit para Node, conforme a descrição do Security gate do repositório.

• Isso é destinado a trabalho de deployment em produção? As notas de escopo do repositório indicam que não é adequado para projetos que exigem deployment em produção, pois não fornece capacidade de DevOps/deployment.

Alternativas

• Assistentes de código de agente único (estilo autocomplete/chat): Estes focam em escrever código diretamente de prompts, mas geralmente não fornecem um fluxo multi-agente de PRD a PR com gates de revisão obrigatórios.
• Prompts multi-etapa convencionais + fluxos manuais de PR: Você pode promptar o Claude manualmente para decompor tarefas e executar workers, mas perde a estrutura SOP integrada (classificação, escaneamento de conflitos, coordenação de QA e revisão por checklist).
• Fluxos de equipe padrão baseados em GitHub (Issues/PRs sem SOP de IA): Equipes podem replicar partes do fluxo usando Issues e revisões de PR do GitHub, mas a paralelização de “worker agent” e o roteamento automatizado de fases não são fornecidos da mesma forma.
• Outras skills personalizadas para Claude Code focadas em planejamento ou testes: Em vez de coordenar agentes de trabalho paralelos de ponta a ponta, algumas skills miram apenas uma parte do fluxo (ex.: geração de testes), deixando integração e coordenação de merge para o usuário.