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.
Ordem recomendada
Execute os comandos nesta ordem. A constitution � definida uma vez por projeto; os demais s�o executados por feature.
| Ordem | Comando | Obrigat�rio | Descri��o |
|---|---|---|---|
| 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.
/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.


/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.