Fluxos de trabalho
A aba Workflows é um menu guiado de ações prontas. Escolha uma fase à esquerda, clique em um card e responda algumas perguntas no chat. O Raaghu Spec Kit cria uma página no wiki, itens no Azure Boards ou um relatório.
Você não precisa lembrar comandos com barra.
Antes de começar
- Initialize Raaghu Spec Kit no projeto.
- Conecte um provedor de IA em Settings.
- Para a maioria das ações de Governance, crie a constitution primeiro com Comandos do Raaghu Spec Kit (
Create Constitution//speckit.constitution).
Como executar um comando
- Abra Workflows.
- Escolha uma fase (por exemplo Governance).
- Clique em um card de comando.
- Responda às perguntas no chat, depois revise e salve.
Use View all capabilities → para ver todos os comandos de uma vez, ou ← Back to current phase para voltar a uma fase.
Governance
Define as regras básicas do projeto: escopo, qualidade, segurança e auditoria.
| Comando | Finalidade |
|---|---|
| Create project foundation from constitution | Cria um documento de fundação em sete seções a partir da constitution no wiki. Use depois que a constitution existir. Precisa de constitution real (não o arquivo vazio). |
| Update constitution from linked artifacts | Atualiza a constitution a partir de um spec ou plan anexado, com resumo das mudanças. Anexe um arquivo primeiro. |
| Publish scope boundaries to Wiki | Publica o que está in scope, out of scope e as regras de limite. Melhor depois da fundação. |
| Generate delivery checklist (DoR / DoD) | Cria checklists “pronto para começar” (DoR) e/ou “pronto para terminar” (DoD). Usada depois no readiness do sprint. |
| Generate compliance & security guardrails | Escreve regras de segurança e compliance que o time deve seguir antes da entrega. |
| Generate audit traceability report | Mapeia requisitos e decisões em um relatório para auditoria. Mais completo se fundação, guardrails e checklist já existirem. |
Fluxo típico: Create Constitution → Create project foundation → outros cards de Governance conforme necessário.
Backlog
Transforma documentos em trabalho no Azure Boards: epics, features e stories.
| Comando | Finalidade |
|---|---|
| Generate epics from linked artifacts | Sugere epics de alto nível a partir de specs ou stories e pode criá-los no Boards. |
| Split epics into features | Divide epics grandes em features filhas com escopo e notas de aceite. |
| Generate stories from selected feature | Cria user stories sob uma feature escolhida. |
| Generate stories from linked artifacts | Transforma BRD/PRD ou docs do wiki diretamente em stories, sem dividir epics à mão. |
| Generate intake summary from BRD/PRD | Resume docs de intake em escopo, riscos e perguntas em aberto. |
| Link artifacts to selected work item | Liga caminhos de wiki ou spec a um item do Boards para rastreabilidade. |
Refine
Melhora stories existentes antes do time se comprometer.
| Comando | Finalidade |
|---|---|
| Refine selected stories | Melhora descrição e critérios de aceite; pode gravar o texto melhorado no Boards. |
| Standardize acceptance criteria | Reescreve critérios em um formato consistente (por exemplo Given/When/Then ou bullets). |
| Detect missing requirements | Encontra lacunas como casos de borda, integrações ou necessidades não funcionais. |
| Attach NFRs to stories | Associa desempenho, segurança e acessibilidade às stories relacionadas. |
| Detect duplicates or overlaps | Reporta stories parecidas. Não altera o Boards sozinho. |
| Highlight unclear or risky stories | Pontua clareza e risco para você corrigir primeiro as mais fracas. |
Sprint plan
Ajuda a preparar o sprint: metas, tarefas, estimativas e prontidão.
| Comando | Finalidade |
|---|---|
| Generate sprint goal from selected items | Redige uma meta curta de sprint a partir da iteration ou itens selecionados. |
| Generate dev tasks from selected stories | Cria tarefas de implementação sob as stories selecionadas. |
| Estimate tasks from plan | Sugere esforço das tarefas com base em um plano técnico. |
| Identify cross-team dependencies | Lista dependências de outros times ou sistemas no sprint. |
| Run readiness check (DoR validation) | Verifica itens contra a checklist DoR e pode salvar um relatório. Melhor depois de Generate delivery checklist. |
Develop
Apoia o time enquanto o trabalho está sendo construído.
| Comando | Finalidade |
|---|---|
| Generate technical plan for selected feature | Cria um plano de implementação e pode salvá-lo no wiki. |
| Refine tasks into implementation steps | Expande tarefas do Boards em passos ordenados. |
| Generate test cases from selected stories | Gera casos de teste a partir dos critérios de aceite para QA. |
| Convert bug to linked dev task | Transforma um bug em tarefas de correção vinculadas. |
| Track work items status from implementation progress | Sugere atualizações de status dos itens filhos conforme o progresso. |
QA & test
Fortalece testes e aceite antes do release.
| Comando | Finalidade |
|---|---|
| Generate test strategy for selected epic | Define escopo, níveis, ambientes e riscos de teste para um epic. |
| Generate negative / edge test cases | Adiciona cenários de falha e casos de borda além do happy path. |
| Generate test data matrix | Lista combinações úteis de entrada, papel e estado para testes. |
| Validate acceptance criteria completeness | Sinaliza critérios pouco claros, ausentes ou difíceis de testar. |
| Generate UAT checklist | Monta uma checklist de aceite para stakeholders. |
Release
Prepara implantação, gates e release notes.
| Comando | Finalidade |
|---|---|
| Generate CI pipeline checklist from constitution | Redige checks de CI/CD alinhados à constitution. Precisa de constitution preenchida. |
| Generate release gates from compliance rules | Define gates “precisa passar antes do release” a partir de regras de compliance. |
| Generate runbooks (deploy / rollback) | Escreve instruções passo a passo de deploy e rollback. |
| Generate release notes from completed work items | Resume o trabalho concluído no Boards em release notes. |
| Publish release notes to Wiki | Publica release notes formatadas no wiki do projeto. |
Change
Gerencia mudanças de escopo depois da linha de base.
| Comando | Finalidade |
|---|---|
| Detect scope drift from latest artifacts | Compara as specs mais recentes com o escopo acordado e sinaliza desvios. |
| Highlight changes since last PRD version | Mostra o que mudou entre versões do PRD. |
| Draft change request with impact analysis | Redige um pedido de mudança com escopo, prazo e impacto. |
| Mark items requiring approval | Marca itens do backlog que precisam de aprovação formal. |
| Generate stakeholder approval checklist | Cria uma checklist de aprovação com papéis e links de evidência. |
Dicas
- Comece por Governance, depois Backlog → Refine → Sprint plan.
- Se um comando pedir um documento que você ainda não tem, crie-o com outro card, Intake ou Comandos do Raaghu Spec Kit.
- Você pode Stop generating e Retry no chat quando precisar. Veja Painel de chat.