Fluxos de trabalho

A aba Workflows tem uma lista de fases à esquerda. Comece com Idea Assessment para avaliar uma ideia, ou escolha uma fase de delivery (Project Setup, Backlog, Refinement, etc.) para rodar cards de comando guiados.

Em Idea Assessment, use os cards de avaliação e o fluxo no chat. Nas fases de delivery, clique em um card de comando 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. Prefira este caminho se for iniciante ou não técnico.

Comece por aqui (primeiro dia)

Em um projeto novo, estes passos bastam para começar:

1. Crie uma constitution com Comandos do Raaghu Spec Kit (Create Constitution / /speckit.constitution) — uma vez por projeto.
2. Opcional: execute Idea Assessment para ideias ainda incertas antes de especificar.
3. Project Setup → Create project foundation — monta a fundação do projeto a partir dessa constitution.
4. Backlog — transforme documentos em epics, features ou stories (ou use Intake para uploads de BRD/PRD).
5. Abra Visuals para sincronizar itens do Boards nível a nível quando estiver pronto.

As tabelas abaixo listam todos os cards de delivery por fase. Você não precisa de todos no primeiro dia.

Antes de começar

1. Initialize Raaghu Spec Kit no projeto.
2. Confirme que a IA está conectada. Administradores da organização e Project Administrators usam Settings. Se você não vir Settings, peça a um admin.
3. Para a maioria das ações de Project Setup, crie a constitution primeiro com Comandos do Raaghu Spec Kit (Create Constitution / /speckit.constitution).

Como executar um comando de delivery

1. Abra Workflows.
2. Escolha uma fase na lista à esquerda (por exemplo Project Setup).
3. Clique em um card de comando.
4. 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.

Para avaliar ideias antes do specify, veja Idea Assessment.

Project Setup

Define as regras básicas do projeto: escopo, qualidade, segurança e auditoria.

Comando	Finalidade
Create project foundation	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 project guidelines	Atualiza a Project Constitution a partir de artefatos vinculados ou das informações mais recentes do projeto, com resumo das mudanças. Anexe um arquivo primeiro ao atualizar a partir de docs.
Publish project scope	Publica o que está in scope, out of scope e as regras de limite no wiki. Melhor depois da fundação.
Create delivery checklist	Cria checklists “pronto para começar” (Definition of Ready / DoR) e/ou “pronto para terminar” (Definition of Done / DoD). Usada depois no readiness do sprint.
Define compliance & security rules	Escreve regras de segurança e compliance que o time deve seguir antes da entrega.
Create 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 Project Setup 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.

Refinement

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 non-functional requirements (NFRs) — como 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 Planning

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 Create delivery checklist.

Development

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.

Testing & Quality

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 Management

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 com Project Setup, depois Backlog → Refinement → Sprint Planning.
• 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.

Próximos passos

• Idea Assessment
• Sua primeira Feature
• Comandos do Raaghu Spec Kit
• Painel de chat
• Intake