Promoção e rastreabilidade

A promoção é o processo de transformar uma ideia aprovada em um work item pronto para implementação. A rastreabilidade é a capacidade de percorrer toda a cadeia, desde o feedback de um usuário até a tarefa que o resolve. Juntas, essas funcionalidades conectam a voz do usuário ao trabalho da equipe.

A cadeia de rastreabilidade

O Almirant mantém uma cadeia de relações entre três níveis:

Nível	O que representa	Exemplo
Feedback	O que um usuário solicita ou relata	"Gostaria de poder exportar para PDF"
Ideia	A proposta avaliada pela equipe	"Exportação em PDF nos relatórios"
Work Item	A tarefa planejada em um board	"Implementar exportação em PDF - Story A-S-42"

Cada nível mantém sua referência ao anterior, formando uma cadeia que pode ser percorrida nas duas direções.

Promover uma ideia a work item

Pré-requisitos

• A ideia deve estar no status Approved (aprovada).
• Deve existir pelo menos um board no projeto onde criar o work item.

Processo passo a passo

1. Acesse a ideia aprovada -- Abra os detalhes da ideia que deseja promover.
2. Clique em Promover -- O botão para promover fica disponível quando a ideia está no status Approved.
3. Configure o work item -- Um formulário é aberto para definir os dados do work item:

Campo	Descrição
Título	É preenchido previamente com o título da ideia (editável)
Tipo	Tipo de work item: Epic, Feature, Story ou Task
Board	Board em que o work item será criado
Descrição	É preenchida previamente com a descrição da ideia (editável)

4. Confirme -- O work item é criado no board selecionado e a ideia muda automaticamente para o status Promoted.

Título e descrição editáveis

Embora o título e a descrição sejam preenchidos previamente a partir da ideia, você pode modificá-los antes de criar o work item. É comum ajustar o título para que fique mais técnico ou específico quando ele passa para a etapa de implementação.

O que acontece após a promoção

• Um novo work item é criado no board selecionado.
• A ideia muda para o status Promoted.
• É estabelecido um vínculo bidirecional entre a ideia e o work item.
• Todo o feedback vinculado à ideia fica indiretamente associado ao work item.
• A ideia promovida não pode mais ser modificada e fica como registro histórico.

Ver a rastreabilidade

Pelo work item

Nos detalhes de um work item criado por promoção, você verá uma seção de Rastreabilidade que mostra:

• A ideia original da qual ele se originou.
• O número de entradas de feedback vinculadas àquela ideia.
• Um link direto para a ideia, para ver todos os seus detalhes.

Pela ideia

Nos detalhes de uma ideia promovida, você verá:

• O work item resultante, com seu identificador e status atual.
• Todas as entradas de feedback vinculadas.
• O histórico completo: quando a ideia foi criada, aprovada e promovida.

Pelo feedback

Nos detalhes de uma entrada de feedback vinculada, você pode navegar diretamente até a ideia associada e, a partir dela, até o work item, percorrendo toda a cadeia.

Vincular feedback existente

Não é necessário vincular o feedback antes da promoção. Você pode vincular feedback adicional a uma ideia a qualquer momento, mesmo depois de promovê-la. Isso é útil para:

• Adicionar novo feedback que chega após a promoção.
• Agrupar feedback que inicialmente não foi detectado como relacionado.
• Documentar a demanda acumulada por uma funcionalidade.

Para vincular feedback, consulte Feedback -- Vincular feedback a ideias.

Exemplo completo

Suponha que sua equipe receba feedback de vários usuários solicitando notificações por e-mail:

1. Chegam três entradas de feedback de fontes diferentes.
2. A IA as agrupa em um cluster "Notificações por e-mail".
3. Uma ideia é criada e o feedback é vinculado a ela.
4. A equipe aprova a ideia.
5. Ela é promovida a work item no board "Product Backlog".
6. O work item é implementado com rastreabilidade completa até o feedback original.

Benefícios da rastreabilidade

Benefício	Descrição
Decisões baseadas em dados	Priorize o que seus usuários mais solicitam, não o que você supõe
Transparência	Qualquer membro da equipe pode ver por que algo está sendo construído
Responsabilidade	Você pode rastrear qual feedback originou cada tarefa
Fechamento do ciclo	Quando o work item é concluído, você sabe quais usuários notificar
Histórico	Mantém um registro completo de como as ideias evoluem

Para desenvolvedores

A rastreabilidade está disponível via MCP:

Tool	Descrição
promote_idea_item	Promove uma ideia aprovada a work item
get_idea_item_traceability	Obtém a cadeia completa: feedback vinculado, ideia e work item resultante
link_feedback_to_idea_item	Vincula feedback a uma ideia (veja Feedback)
unlink_feedback_from_idea_item	Desvincula feedback de uma ideia

A tool get_idea_item_traceability é especialmente útil para que um agente de IA entenda o contexto completo de um work item: por que ele foi criado, quais usuários o solicitaram e qual era a ideia original.

---

Relacionado: Gerenciamento de ideias | Feedback | Work Items