Na US
Problema, objetivo e critérios de negócio já documentados no backlog — a fonte da verdade do “o quê”.
Spike · análise
Spike · Kiro na esteira
Vamos avaliar o uso do Kiro — Crew Web + fluxo de
Specs — na esteira de desenvolvimento: da User Story no Azure DevOps
até artefatos em .kiro/ e enriquecimento EARS de volta na US.
- Crew Web
- Specs Kiro
- MCP Azure DevOps
- Agents
01 · Entrada
O que vamos avaliar
Partimos de uma User Story no Azure DevOps com descrição do problema, objetivo e critérios de negócio. No Crew Web, passamos o número da US e pedimos o refinamento + fluxo de Spec.
No Crew Web
Informamos o número da US e pedimos ao Crew o refinamento e o fluxo de Spec (workflow oficial do Kiro), orquestrado por agents.
Tom de spike: vamos avaliar esse caminho na esteira — não afirmamos que o Crew já oferece a mesma UI de Feature Spec do Kiro Web.
02 · Orquestração
Agente orquestrador (custom)
Um agente custom pretendemos que receba a US e conduza a análise até classificar o trabalho e derivar para o especialista certo.
-
MCP Azure DevOps → markdown
Obter dados da US via MCP e salvar markdown no workspace (dados da US, quem solicitou, etc.).
-
Inferir projetos / repositórios
Inferir quais projetos e repositórios analisar para atender a US.
-
Pesquisar código → AS IS
Pesquisar na base de código e montar um AS IS do estado atual.
-
Classificar o tipo
Classificar: feature nova · bug · alteração de feature existente.
-
Derivar ao especialista
Encaminhar para o agente especializado conforme o tipo classificado.
03 · Especialistas
Três agentes especializados
Cada tipo de trabalho segue um caminho distinto — sempre em tom de proposta do que pretendemos avaliar na spike.
Bug
Agente de bug
- Segue o fluxo Bugfix Spec
- Questiona o usuário para montar a spec
Alteração
Alteração de feature
- Com base no AS IS, levanta na base o que alterar
- Valida em código
- Executa grill with docs com o user (spec + casos de borda)
- Monta o TO BE
Feature nova
Feature nova
- Grill me with docs
- Pesquisa na base e questiona o user para montar specs
- Define projetos impactados e escopo da US
04 · Artefatos
Artefatos e Spec Kiro
Todos os agents pretendemos que salvem artefatos na raiz do workspace em
.kiro/ e criem Specs seguindo o workflow oficial do Kiro:
requirements | bugfix → design →
tasks / notação EARS.
requirements.md
ou bugfix.md
Critérios e comportamentos — ou análise do bug — em EARS quando aplicável.
design.md
Arquitetura
Design técnico derivado dos requisitos confirmados (ou da análise do bug).
tasks.md
Plano executável
Tarefas rastreáveis para implementação — no worktree da Spec.
Pasta pretendida: .kiro/specs/<nome>/
05 · Infra
Ambiente no servidor Crew
Repos no servidor
O servidor do Kiro Crew contém todos os repositórios relevantes para a esteira.
Branch develop
Um script mantém os repos atualizados com a branch develop.
Worktree por Spec
O trabalho de código acontece em git worktree por Spec, isolando cada iniciativa.
06 · Fechamento do ciclo
Enriquecimento no Azure DevOps
Pretendemos que os agents usem MCP para atualizar a US no Azure DevOps, colocando as specs em notação EARS na própria User Story — devolvendo clareza testável ao backlog.
De volta à US
Critérios refinados no formato EARS, alinhados ao que foi montado em
.kiro/specs:
WHEN [condição]
THE SYSTEM SHALL [comportamento]07 · Visão geral
Diagrama de fluxo
Esteira enriquecida da spike — da US no Azure DevOps até publish em QA e PR para
develop, com aprovações do Dev, branch por tipo e EARS de volta na US.
Pressione Iniciar
Descoberta
PO · US
Azure DevOps
PO cria a User Story no board do Azure DevOps.
Dev · Crew
refinamento no Crew Web
Dev inicia o refinamento no Crew Web passando o número da US.
MCP → markdown
Orquestrador
Via MCP obtém dados da US e salva markdown no workspace.
AS IS · projetos
refinar + escopo
Agente refina, monta o AS IS e define os projetos envolvidos.
Classificação
tipo na US (MCP)
Classifica a US e grava o tipo em comentários via MCP.
Bug
Alteração
Feature
→ Artefatos de requisito
Entrega
EARS na US
bugfix / requirements
Coloca as specs EARS na US via MCP (artefatos de requisito).
Spec aprovada
Dev no Crew
Após o Dev aprovar a Spec, o fluxo segue para design e tasks.
Design + Tasks
aprovação Dev
Agente monta design/tasks (informa/questiona); Dev aprova.
Worktree + dev
código das tasks
Cria worktree e inicia o desenvolvimento das tasks.
Review Dev
código gerado
Aguarda a review do Dev no código produzido no worktree.
QA · publish
branch qa + ambiente + testes
Commit + publish QA (branch qa e ambiente) e casos de teste na US.
PR → develop
após testes OK
Com testes aprovados, cria o PR para a branch develop.
← → avançam o marco · R repete · toque no card para a dica
Spike de análise: pretendemos validar essa esteira completa — Crew Web + agents + Specs Kiro + MCP Azure DevOps, com aprovação Dev, QA (branch + ambiente) e PR para develop.