Descrição
Spec-first Agentic Development introduz uma abordagem estruturada para trabalhar com agentes de codificação de IA, garantindo que cada mudança seja iniciada por uma especificação claramente definida e revisada. Essa metodologia visa aumentar a confiabilidade e a manutenibilidade do código desenvolvido por agentes de IA, integrando supervisão humana e verificações automatizadas ao longo do ciclo de vida do desenvolvimento.
Ler mais
O princípio central envolve iniciar cada tarefa de desenvolvimento com uma especificação escrita armazenada no repositório. Essa especificação descreve o objetivo, fatos relevantes (incluindo referências de arquivo e linha), etapas a serem seguidas e critérios de 'concluído' precisos. Antes que qualquer código seja escrito, um revisor novo examina a especificação em relação à base de código existente para verificar sua precisão e viabilidade. Uma vez aprovada, um agente de IA prossegue para construir o recurso em sua própria branch isolada e worktree. O commit final só é permitido no repositório principal após todas as verificações e testes pré-definidos serem aprovados, garantindo a qualidade do código e a conformidade com a especificação.
Esse sistema difere significativamente da 'codificação por vibração' tradicional ao substituir prompts ad-hoc por uma especificação revisada e persistente. Ele registra cada decisão tomada pelo agente com sua justificativa, fornecendo um claro histórico de auditoria e reduzindo a necessidade de documentação pós-desenvolvimento. As especificações são projetadas para definir a intenção e a arquitetura, em vez de serem geradores de código excessivamente precisos, com testes e portas de commit fornecendo a precisão necessária. Especificações antigas são tratadas como registros de mudança imutáveis, semelhantes a commits, e não são atualizadas, prevenindo obsolescência.
Spec-first Agentic Development suporta desenvolvimento paralelo, permitindo que múltiplos agentes trabalhem em diferentes especificações simultaneamente usando IDs de branch e worktree únicos. O processo é ininterrupto, pois as especificações revisadas respondem previamente a perguntas em aberto, permitindo que os agentes construam diretamente para os critérios de 'concluído'. Todo o fluxo de trabalho é estruturado, com uma especificação correspondente a uma branch e um commit, simplificando pull requests e garantindo consistência. O estado é mantido em `context.yaml`, tornando o trabalho retomável mesmo após reinícios.
O método, os templates e o plugin Claude Code são todos licenciados sob MIT, tornando-o uma solução sem custo. Enquanto o plugin Claude Code automatiza funções de contabilidade e verificação, a metodologia também pode ser adotada com outros agentes como Codex, Cursor ou Copilot, seguindo `AGENTS.md` e instalando um hook de commit-msg do git para a verificação. Essa abordagem foi desenvolvida e refinada através da criação do Agent Smith, uma fábrica de software agente de código aberto, demonstrando sua aplicação prática e eficácia.
- CategoriaAssistentes de programação com IA
- Modelo de preçosGrátis
- ImplantaçãoNuvem
- PlataformasWeb
Recursos principais de Spec-first Agentic Development
Desenvolvimento orientado por especificações para agentes de codificação de IA
Especificações revisadas verificadas em relação ao código antes da construção
Worktrees isoladas para cada tarefa de desenvolvimento
Commits condicionados que exigem a aprovação de todas as verificações
Especificações persistentes armazenadas no repositório
Registro de decisões com justificativas para rastreabilidade
Suporte para desenvolvimento paralelo com IDs de branch únicos
Fluxos de trabalho retomáveis com estado armazenado em context.yaml
Método, templates e plugin Claude Code licenciados sob MIT
Compatibilidade com Codex, Cursor, Copilot e terminal
Hook de commit-msg do git para impor portas de commit
Verificação automatizada de evidências para citações de especificações
Pull requests estruturados para uma única especificação ou séries de especificações
Contextos e regras gerados a partir da base de código existente
Nenhum código escrito à mão é necessário para o processo de construção do Agent Smith
Como usar Spec-first Agentic Development?
Instalar Plugin/Hook: Instale o plugin Claude Code ou o hook de commit-msg do git em sua cópia do projeto.
Inicializar Projeto: Execute /spec-first:bootstrap-project para gerar contextos e regras a partir do seu código existente.
Criar Especificação: Defina uma nova tarefa com um objetivo, etapas, fatos e critérios de concluído usando a habilidade create-spec.
Revisar Especificação: Faça um revisor novo verificar a especificação em relação ao código para precisão e viabilidade.
Aplicar Especificação: O agente constrói a especificação em sua própria branch e worktree, seguindo as regras do projeto.
Entregar Especificação: Comite as mudanças através da porta, garantindo que todas as verificações sejam aprovadas, e abra um pull request.
Entregar Série: Para mudanças maiores, use /spec-first:deliver-series para gerenciar e entregar múltiplas especificações interdependentes.
Casos de uso de Spec-first Agentic Development
- Desenvolvimento de Código com Agentes de IA
- Garantindo a Qualidade do Código
- Gerenciando Projetos Complexos
- Aprimorando a Rastreabilidade do Código
- Facilitando Revisões de Código
- Automatizando Fluxos de Trabalho de Desenvolvimento
- Integração de Novos Desenvolvedores
- Integração com Ferramentas Existentes
