Sobre o projeto

O Spec Kit é um kit de ferramentas de código aberto do GitHub que ajuda equipes a usar o Desenvolvimento Guiado por Especificações (SDD) com agentes de codificação de IA. Em vez de tratar as especificações como andaimes descartáveis, o SDD torna as especificações executáveis: elas geram diretamente implementações funcionais. O kit de ferramentas fornece um processo guiado por especificações pronto para uso que pode ser personalizado ou substituído pelo seu próprio fluxo de trabalho. O componente principal é o Specify CLI, instalado via uv ou PyPI. Após executar `specify init`, ele configura um projeto e instala comandos slash ou habilidades de agente para agentes de codificação de IA comuns. As integrações suportadas incluem mais de 30 agentes de codificação baseados em CLI e IDE, como Copilot, Codex, Claude Code e outros. Os comandos slash principais seguem um fluxo de trabalho estruturado: - `/speckit.constitution` — estabelece princípios do projeto e diretrizes de desenvolvimento - `/speckit.specify` — define o que construir (requisitos e histórias de usuário) - `/speckit.plan` — cria um plano de implementação técnica - `/speckit.tasks` — divide o plano em tarefas acionáveis - `/speckit.taskstoissues` — converte tarefas em issues do GitHub - `/speckit.implement` — executa tarefas para construir a funcionalidade - `/speckit.converge` — compara a implementação com a especificação, o plano e as tarefas, e acrescenta o trabalho restante como novas tarefas Os comandos opcionais incluem `/speckit.clarify` para esclarecer áreas subespecificadas, `/speckit.analyze` para verificações de consistência entre artefatos e `/speckit.checklist` para listas de verificação de qualidade personalizadas. O repositório também inclui extensões opcionais. Uma extensão de correção de bugs adiciona um fluxo de trabalho de avaliar → corrigir → testar para correções de bugs com escopo definido e baseadas em evidências. Uma extensão de avaliação de ideias fornece um fluxo de trabalho de intake → research → define → shape → decide para transformar ideias brutas em decisões documentadas de go / needs-clarification / kill. A personalização é suportada por três mecanismos: extensões adicionam novos comandos e templates, presets substituem o comportamento de templates e comandos existentes, e bundles empacotam conjuntos curados de extensões, presets, etapas e fluxos de trabalho em configurações baseadas em funções (por exemplo, gerente de produto, analista de negócios, pesquisador de segurança, desenvolvedor). Substituições locais do projeto permitem ajustes pontuais. Os templates são resolvidos em tempo de execução, enquanto os comandos de extensão e preset são aplicados no momento da instalação. O Spec Kit também inclui comandos de autogerenciamento, como `specify self check`, `specify self upgrade --dry-run` e `specify self upgrade`, com opções para fixar tags de release específicas. Os recursos da comunidade incluem extensões, presets, bundles, walkthroughs e projetos relacionados no site de documentação. O projeto faz dogfooding de si mesmo: os mantenedores usam o Spec Kit ao desenvolver o Spec Kit, particularmente para funcionalidades substanciais, por meio de um fluxo de trabalho automatizado de avaliação de funcionalidades.