Comandos do Raaghu Spec Kit
Os comandos do Raaghu Spec Kit geram conteúdo estruturado e o salvam no Wiki do projeto em Raaghu Spec Kit/ (projetos mais antigos ainda podem usar Speckit/). Execute-os pelo dropdown Command do painel de chat ou digitando o comando.
Prefere cards guiados sem comandos com barra? Use primeiro Workflows ou o Menu de contexto do Boards. Esta página é a referência completa de comandos.
Caminho recomendado: constitution → specify → clarify → plan → tasks → sync em Visuals. Passo a passo: Sua primeira Feature.
Antes de começar: Confirme que a IA está conectada e que o Raaghu Spec Kit está inicializado. Administradores da organização e Project Administrators usam Settings. Se você não vir Settings, peça a um admin.
Ajuda do comando (?)
Abra o dropdown Command para escolher um comando do Raaghu Spec Kit. Use os botões ? para ajuda no produto:
- Ao lado do título Command — abre How to use commands (selecione um comando, adicione uma descrição curta, pressione Enter), com um exemplo
- Ao lado de cada comando — abre um popover com Description, What to enter e um Example daquele comando
Os comandos
| Comando | Finalidade | Salvo em (Wiki) |
|---|---|---|
/speckit.constitution | Definir princípios e guardrails do projeto | Raaghu Spec Kit/specify/memory/constitution |
/speckit.specify | Criar uma especificação de feature com requisitos e critérios de aceite | Raaghu Spec Kit/specs/NNN-feature-name/spec |
/speckit.clarify | Detectar ambiguidades, fazer perguntas e atualizar a spec | Atualiza o spec da feature |
/speckit.plan | Criar um plano técnico de implementação | Raaghu Spec Kit/specs/NNN-feature-name/plan |
/speckit.tasks | Dividir o plano em uma lista de tarefas por fases | Raaghu Spec Kit/specs/NNN-feature-name/tasks |
/speckit.analyze | Cruzar spec, plan, tasks e constitution em busca de lacunas | Relatório no chat |
/speckit.checklist | Gerar um checklist de qualidade dos requisitos | Raaghu Spec Kit/specs/NNN-feature-name/checklists/… |
/speckit.converge | Após o push do código, comparar o repositório com spec/plan/tasks e acrescentar tarefas restantes | Acrescenta em tasks |
Em Settings → Commands Mapping, alterne entre Default (nomes amigáveis) e Spec Kit (IDs speckit.*). Exemplo: "Create Specification" é o mesmo que /speckit.specify.
Comandos de Idea Assessment
Avalie uma ideia antes de /speckit.specify. Prefira a UI guiada em Idea Assessment (Workflows → Idea Assessment → + New Assessment). Estes comandos com barra são as mesmas etapas para usuários avançados.
| Comando | Finalidade | Salvo em (Wiki) |
|---|---|---|
/speckit.assess.intake | Capturar a ideia bruta sem julgar | Raaghu Spec Kit/specify/assessments/<idea-id>/intake |
/speckit.assess.research | Reunir evidências a favor e contra | …/assessments/<idea-id>/research |
/speckit.assess.define | Definir o problema: quem é afetado, objetivos, métricas | …/assessments/<idea-id>/problem |
/speckit.assess.shape | Moldar 2–3 opções de conceito com trade-offs | …/assessments/<idea-id>/concept |
/speckit.assess.decide | Veredito Go / Needs Clarification / Kill | …/assessments/<idea-id>/decision |
/speckit.assess.refine | Refinar após Needs Clarification (em geral pelo fluxo guiado) | Atualiza a página de assessment indicada |
O slug=id-curto-da-ideia opcional mantém todas as etapas na mesma pasta do wiki (por exemplo slug=offline-mode). Após Go, você pode continuar conversando sobre a decisão e depois seguir com /speckit.specify. Após Needs Clarification, responda às perguntas no chat ou edite a página do wiki — não reinicie o funil completo.
/speckit.assess.intake "offline sync for field users" slug=offline-mode
/speckit.assess.research slug=offline-mode
/speckit.assess.define slug=offline-mode
/speckit.assess.shape slug=offline-mode
/speckit.assess.decide slug=offline-mode
Ordem recomendada
Execute os comandos de delivery nesta ordem. A constitution é definida uma vez por projeto; os demais são executados por feature. As etapas opcionais de Idea Assessment vêm antes do specify quando a ideia ainda é incerta.
| Ordem | Comando | Obrigatório | Descrição |
|---|---|---|---|
| — | /speckit.assess.* | Opcional | Avaliar a ideia primeiro (veja acima) |
| 1 | /speckit.constitution | Sim (uma vez) | Definir princípios do projeto |
| 2 | /speckit.specify | Sim | Definir o que construir |
| 3 | /speckit.clarify | Recomendado | Esclarecer áreas pouco especificadas antes do planejamento |
| 4 | /speckit.plan | Sim | Definir o stack técnico e o plano de implementação |
| 5 | /speckit.tasks | Sim | Gerar a lista de tarefas |
| 6 | /speckit.analyze | Opcional | Análise de consistência e cobertura |
| 7 | /speckit.checklist | Opcional | Checklist de qualidade dos requisitos |
| 8 | /speckit.converge | Opcional (após o push) | Reconciliar o código com a spec |
CREATE versus UPDATE
A maioria dos comandos é incremental:
- CREATE — quando ainda não existe arquivo para a feature atual, o comando o gera a partir de um template.
- UPDATE — quando o arquivo já existe, o comando adiciona conteúdo novo e mantém o que você já tem.
/speckit.specify cria o próximo spec numerado por padrão. Atualiza um spec existente apenas quando você pede explicitamente (por exemplo, update this spec ou nomear specs/001-feature-name). Depois do specify, clarify, plan, tasks, analyze e converge permanecem nessa feature até você nomear outra.
Exemplos
/speckit.constitution Create principles focused on code quality, testing standards, user experience consistency, and performance requirements
/speckit.specify Build an app to organize photos into date-grouped albums, with drag-and-drop reordering and a tile preview inside each album.
/speckit.clarify
/speckit.plan Use Vite with minimal libraries. Prefer vanilla HTML, CSS, and JavaScript. Store metadata in a local SQLite database.
/speckit.tasks
Após a execução de um comando, revise a prévia e escolha Keep ou Regenerate.
Em atualizações de arquivo, o painel mostra contagens reais +N / −N e a aba Diff (Contents / Preview / Diff). Diff aparece só quando há versão anterior e você não está editando. Criações pela primeira vez não mostram Diff.
/speckit.constitution
Define os princípios do projeto (uma vez por projeto). Visualize o rascunho e depois clique em Keep.
/speckit.specify
Cria o spec da feature (e páginas relacionadas, como requirements) em Raaghu Spec Kit/specs/NNN-feature-name/.
/speckit.clarify
Faz perguntas de esclarecimento no chat (muitas vezes com uma sugestão Optimal). Responda-as para que as lacunas sejam incorporadas de volta à spec.
As perguntas aparecem uma por vez no chat (Back / Next, depois Submit Answer na última pergunta). O mesmo fluxo é usado quando Idea Assessment ou Intake faz perguntas de esclarecimento.
/speckit.plan
Gera o plano de implementação e arquivos relacionados (plan, research, data-model e similares).
/speckit.checklist
Cria um checklist de qualidade dos requisitos na pasta checklists/ da feature.
/speckit.tasks
Divide o plano em uma lista tasks por fases.
/speckit.analyze
Cruza spec, plan, tasks e constitution. Os resultados aparecem como um relatório de análise no chat (lacunas, severidade e recomendações).
Workflows vs comandos
- Comandos (
/speckit.*) são ações diretas que você executa pelo chat. - Workflows são conversas guiadas em várias etapas a partir da aba Workflows, que usam o mesmo motor.
Para um passo a passo completo, consulte Sua primeira Feature.
Próximos passos
Caminho opcional de descoberta (antes do specify): Idea Assessment — intake → research → define → shape → decide → (Go) specify.