---
name: integrations
description: Planejar integrações do pipeline SDD com Jira, Confluence, Bitbucket, Pipelines, Slack, MCP e webhooks. Use ao mapear onde cada artefato vive, definir automações de status, projetar callbacks de checkpoint, conectar agentes a ferramentas ou revisar se a arquitetura evita duplicação entre sistemas.
---

# Integrações SDD

## Divisão por dono

- Confluence: documentos vivos, PRD, Tech Spec, ADRs e memória humana.
- Jira: estado, épicos, issues, tasks, approvals e workflow.
- Bitbucket: branch, commits, PR, revisão e Pipelines.
- Slack: notificação e aprovação rápida, quando existir.
- MCP/API: leitura e escrita estruturada nos sistemas.
- Webhooks: retorno de eventos ao orquestrador durável.
- Local Markdown: fallback obrigatório em `docs/<slug-da-orquestracao>/` quando a integração externa estiver ausente ou parcial.

## Padrão de integração

Para cada etapa, defina:

- Sistema dono do conteúdo.
- Sistema dono do estado.
- Identificador canônico.
- Link para o artefato anterior.
- Evento que inicia a próxima etapa.
- Webhook ou polling necessário.
- Arquivo local de fallback e estado no `traceability-map.yaml`.

## Eventos recomendados

- Ideia criada: inicia PRD.
- PRD aprovado: inicia Tech Spec.
- Tech Spec aprovada: inicia Tasks.
- Refinement aprovado ou dispensado: libera Execution.
- PR aberto: inicia Review.
- CI verde e review aprovado: libera merge.
- Deploy aprovado/concluído: inicia Memory.

## Anti-padrões

- Copiar PRD inteiro para Jira quando Confluence é a fonte.
- Usar comentários livres como estado de workflow.
- Rodar agentes por polling quando o sistema emite webhook.
- Permitir merge só porque a IA revisou, sem CI e evidência.
- Colocar segredo, token ou configuração sensível em documento de spec.
- Depender de Jira/Confluence sem salvar fallback local quando a integração ainda não está operacional.

## Saída esperada

Quando planejar integração, entregue uma tabela com: etapa, artefato, sistema dono, evento de entrada, evento de saída, aprovação humana, fallback e observabilidade.
