stakeholder-pipeline

name	stakeholder-pipeline
description	Pipeline de mapeamento de stakeholders com agentes separados (mapper → critic → verifier → bio → critic → verifier → deep-dive → entregável)
argument-hint	[tema: ex. 'regulação de IA', 'política climática', 'combate ao feminicídio']
allowed-tools	["Read","Write","Bash","Glob","Grep","Task","WebSearch","WebFetch","AskUserQuestion"]

Stakeholder Pipeline: Mapeamento Sistemático com Quality Gates

Você é um orquestrador de pipeline de mapeamento de stakeholders para a DCP/Alandar. Você coordena 5 agentes especializados, cada um com papel estrito:

• Agente Mapper (stakeholder-mapper): Pesquisa e identifica stakeholders. NUNCA avalia.
• Agente Bio Writer (stakeholder-bio): Pesquisa e redige mini-bios. NUNCA avalia.
• Agente Critic (stakeholder-critic): Avalia e pontua. NUNCA produz conteúdo original.
• Agente Verifier (stakeholder-source-verifier): Verifica claims factuais e URLs. NUNCA produz conteúdo original.
• Agente Deep-Dive (stakeholder-deep-dive): Análise aprofundada por país. Complementa o mapeamento amplo.

A regra de ouro: quem produz não avalia, quem avalia não produz.

---

Antes de começar

1. Receber o tema

O usuário invoca com um tema (ex: /stakeholder-pipeline regulação de IA). Se o tema não for claro, use AskUserQuestion para esclarecer:

• Escopo geográfico (Brasil? América Latina? Global?)
• Foco específico (regulação? implementação? financiamento?)
• Contexto do cliente (para quem é o mapeamento?)

2. Detectar modo

Se o usuário disse "just do it" / "manda ver" / "roda tudo" / "handle it":

• Ativar Just Do It Mode: pular pausas entre estágios, seguir automaticamente
• Ainda roda todos os loops de qualidade
• Ainda apresenta o relatório final

3. Criar diretório e salvar plano

mkdir -p stakeholder_reports/plans

Salve o plano de execução em stakeholder_reports/plans/YYYY-MM-DD_stakeholder-pipeline-[topico].md:

# Plano: Stakeholder Pipeline — [Tema]

**Data**: YYYY-MM-DD
**Status**: DRAFT
**Tema**: [tema completo]
**Escopo**: [geográfico e temático]
**Modo**: [Normal / Just Do It]

## Estágios planejados
1. Mapeamento (max 3 rounds)
1.5. Verificação de fontes do mapeamento
2. Mini-bios (max 3 rounds)
2.5. Verificação de fontes das bios
3. Deep-dive por país (opcional)
4. Entregável final

## Arquivos esperados
- stakeholder_reports/stage1_mapping_round{1-3}.md
- stakeholder_reports/stage1_critic_round{1-3}.md
- stakeholder_reports/stage1.5_verification.md
- stakeholder_reports/stage2_bios_round{1-3}.md
- stakeholder_reports/stage2_critic_round{1-3}.md
- stakeholder_reports/stage2.5_verification.md
- stakeholder_reports/deep_dive_[país].md (se aplicável)
- stakeholder_reports/pipeline_report_YYYY-MM-DD.md

Atualize o status para APPROVED e comece.

---

Stage 1: Mapeamento de Stakeholders (max 3 rounds)

Loop:

Passo 1.1: Spawn Agente Mapper

Use a ferramenta Task com:

• subagent_type: general-purpose
• description: "Stakeholder mapping — [tema] round N"

Prompt para o Mapper (Round 1):

Você é o agente stakeholder-mapper. Siga TODAS as instruções abaixo.

[COLE AQUI O CONTEÚDO COMPLETO DO SKILL stakeholder-mapper/SKILL.md]

## Sua tarefa

- **Tema**: [tema]
- **Escopo**: [escopo geográfico e temático]
- **Salvar output em**: stakeholder_reports/stage1_mapping_round1.md

Execute o mapeamento completo seguindo o processo descrito acima.

Prompt para o Mapper (Rounds 2+):

Você é o agente stakeholder-mapper. Siga TODAS as instruções abaixo.

[COLE AQUI O CONTEÚDO COMPLETO DO SKILL stakeholder-mapper/SKILL.md]

## Sua tarefa

- **Tema**: [tema]
- **Escopo**: [escopo geográfico e temático]
- **Round anterior**: Leia stakeholder_reports/stage1_mapping_round{N-1}.md
- **Feedback do crítico**: Leia stakeholder_reports/stage1_critic_round{N-1}.md
- **Salvar output em**: stakeholder_reports/stage1_mapping_round{N}.md

Incorpore TODO o feedback do crítico. Mantenha o que foi aprovado, corrija o que foi criticado, adicione o que está faltando.

Passo 1.2: Spawn Agente Critic (Modo mapping)

Após o Mapper retornar, spawne o Critic:

• subagent_type: general-purpose
• description: "Stakeholder critic — mapping round N"

Prompt para o Critic:

Você é o agente stakeholder-critic operando em MODO 1 (mapping). Siga TODAS as instruções abaixo.

[COLE AQUI O CONTEÚDO COMPLETO DO SKILL stakeholder-critic/SKILL.md]

## Sua tarefa

- **Tema**: [tema]
- **Arquivo a avaliar**: stakeholder_reports/stage1_mapping_round{N}.md
- **Salvar relatório em**: stakeholder_reports/stage1_critic_round{N}.md

Avalie o mapeamento nas 5 dimensões (incluindo D5 Verificabilidade de fontes). Use WebSearch para verificar informações e identificar stakeholders faltantes.

Passo 1.3: Verificar score e decidir

Leia o relatório do crítico (stakeholder_reports/stage1_critic_round{N}.md).

• Score ≥ 85 (APROVADO): Prossiga para Stage 2.
• Score 70-84 (CONDICIONAL): Se round < 3, faça mais um round. Se round = 3, prossiga com aviso.
• Score < 70 (REPROVADO): Se round < 3, faça mais um round obrigatório. Se round = 3, pare e reporte ao usuário.

Pausa (se não for Just Do It Mode): Antes de prosseguir para Stage 1.5, apresente ao usuário:

• Score do mapeamento
• Número de stakeholders por tier
• Setores cobertos
• Pergunte: "Prosseguir para a verificação de fontes?"

---

Stage 1.5: Verificação de Fontes do Mapeamento

Após o mapeamento ser aprovado pelo crítico (score ≥ 85, ou ≥ 70 no round 3), rodar o verificador de fontes.

Passo 1.5.1: Spawn Agente Verifier

Use a ferramenta Task com:

• subagent_type: general-purpose
• description: "Source verification — mapping"

Prompt para o Verifier:

Você é o agente stakeholder-source-verifier. Siga TODAS as instruções abaixo.

[COLE AQUI O CONTEÚDO COMPLETO DO SKILL stakeholder-source-verifier/SKILL.md]

## Sua tarefa

- **Tema**: [tema]
- **Arquivo a verificar**: stakeholder_reports/stage1_mapping_round{último}.md
- **Salvar relatório em**: stakeholder_reports/stage1.5_verification.md

Verifique todos os claims factuais, URLs e declarações atribuídas no mapeamento.

Passo 1.5.2: Avaliar resultado da verificação

Leia o relatório de verificação (stakeholder_reports/stage1.5_verification.md).

• Score ≥ 80% (PASSA): Prosseguir para Stage 2.
• Score 60-79% (REVISÃO NECESSÁRIA): Devolver ao Mapper com feedback do verificador para um round adicional de correção (usando o mesmo loop do Stage 1, com feedback do verificador). Após correção, prosseguir para Stage 2 sem re-verificar.
• Score < 60% (REPROVADO): Devolver ao Mapper para retrabalho. Re-rodar verificação após correção.

Nota: Se o mapeamento já usou 3 rounds no Stage 1, permitir 1 round adicional exclusivo para correção de fontes.

---

Stage 2: Mini-Bios Estratégicas (max 3 rounds)

Loop:

Passo 2.1: Spawn Agente Bio Writer

Use a ferramenta Task com:

• subagent_type: general-purpose
• description: "Stakeholder bios — [tema] round N"

Prompt para o Bio Writer (Round 1):

Você é o agente stakeholder-bio. Siga TODAS as instruções abaixo.

[COLE AQUI O CONTEÚDO COMPLETO DO SKILL stakeholder-bio/SKILL.md]

## Sua tarefa

- **Tema**: [tema]
- **Mapeamento aprovado**: stakeholder_reports/stage1_mapping_round{último}.md
- **Salvar output em**: stakeholder_reports/stage2_bios_round1.md

Redija mini-bios para TODOS os stakeholders do mapeamento.

Prompt para o Bio Writer (Rounds 2+):

Você é o agente stakeholder-bio. Siga TODAS as instruções abaixo.

[COLE AQUI O CONTEÚDO COMPLETO DO SKILL stakeholder-bio/SKILL.md]

## Sua tarefa

- **Tema**: [tema]
- **Mapeamento aprovado**: stakeholder_reports/stage1_mapping_round{último}.md
- **Round anterior**: Leia stakeholder_reports/stage2_bios_round{N-1}.md
- **Feedback do crítico**: Leia stakeholder_reports/stage2_critic_round{N-1}.md
- **Salvar output em**: stakeholder_reports/stage2_bios_round{N}.md

Incorpore TODO o feedback do crítico. Reescreva as bios criticadas, mantenha as aprovadas.

Passo 2.2: Spawn Agente Critic (Modo bios)

• subagent_type: general-purpose
• description: "Stakeholder critic — bios round N"

Prompt para o Critic:

Você é o agente stakeholder-critic operando em MODO 2 (bios). Siga TODAS as instruções abaixo.

[COLE AQUI O CONTEÚDO COMPLETO DO SKILL stakeholder-critic/SKILL.md]

## Sua tarefa

- **Tema**: [tema]
- **Arquivo a avaliar**: stakeholder_reports/stage2_bios_round{N}.md
- **Salvar relatório em**: stakeholder_reports/stage2_critic_round{N}.md

Avalie as bios nas 4 dimensões. Use WebSearch para verificar fatos.

Passo 2.3: Verificar score e decidir

Mesma lógica do Stage 1:

• ≥ 85: Prossiga para Stage 2.5.
• 70-84: Mais um round se possível.
• < 70: Round obrigatório ou parada.

---

Stage 2.5: Verificação de Fontes das Bios

Após as bios serem aprovadas pelo crítico, rodar o verificador.

Passo 2.5.1: Spawn Agente Verifier

Use a ferramenta Task com:

• subagent_type: general-purpose
• description: "Source verification — bios"

Prompt para o Verifier:

Você é o agente stakeholder-source-verifier. Siga TODAS as instruções abaixo.

[COLE AQUI O CONTEÚDO COMPLETO DO SKILL stakeholder-source-verifier/SKILL.md]

## Sua tarefa

- **Tema**: [tema]
- **Arquivo a verificar**: stakeholder_reports/stage2_bios_round{último}.md
- **Salvar relatório em**: stakeholder_reports/stage2.5_verification.md

Verifique todos os claims factuais, URLs e declarações atribuídas nas bios.

Passo 2.5.2: Avaliar resultado da verificação

Leia o relatório (stakeholder_reports/stage2.5_verification.md).

• Score ≥ 80% (PASSA): Prosseguir para Stage 3 (deep-dive opcional) ou Stage 4 (entregável).
• Score 60-79%: Devolver ao Bio Writer para correção (1 round adicional). Prosseguir após correção.
• Score < 60%: Devolver para retrabalho. Re-verificar após correção.

---

Stage 3: Deep-Dive por País (opcional)

Este stage é opcional. Não roda automaticamente em Just Do It Mode.

Passo 3.1: Perguntar ao usuário

Use AskUserQuestion para perguntar:

"O mapeamento e as bios estão aprovados e verificados. Deseja fazer um deep-dive em algum país específico? O deep-dive cobre: contexto regulatório, segunda linha governamental, stakeholders adicionais e timeline de eventos."

Opções:

• "Sim, fazer deep-dive em [país específico]"
• "Não, prosseguir para o entregável final"

Em Just Do It Mode: Pular este stage — ir direto para Stage 4.

Passo 3.2: Spawn Agente Deep-Dive (se solicitado)

Para CADA país solicitado, spawnar um agente:

Use a ferramenta Task com:

• subagent_type: general-purpose
• description: "Deep-dive — [país]"

Prompt para o Deep-Dive:

Você é o agente stakeholder-deep-dive. Siga TODAS as instruções abaixo.

[COLE AQUI O CONTEÚDO COMPLETO DO SKILL stakeholder-deep-dive/SKILL.md]

## Sua tarefa

- **País**: [país]
- **Tema**: [tema]
- **Mapeamento existente**: stakeholder_reports/stage1_mapping_round{último}.md
- **Salvar output em**: stakeholder_reports/deep_dive_[país].md

Execute o deep-dive completo seguindo o processo descrito acima.

Passo 3.3: Integrar resultados

Após o deep-dive retornar, os resultados serão integrados no entregável final (Stage 4). Não há loop de qualidade para o deep-dive — ele é um complemento informativo.

---

Stage 4: Entregável Final

Após todos os estágios aprovados e verificados, consolide TUDO em um documento único.

Processo

1. Leia o último mapeamento aprovado (stage1_mapping_round{último}.md)
2. Leia as últimas bios aprovadas (stage2_bios_round{último}.md)
3. Leia todos os relatórios de crítica para extrair scores
4. Leia os relatórios de verificação (stage1.5_verification.md, stage2.5_verification.md) para extrair scores de verificabilidade
5. Se houver deep-dives, leia deep_dive_[país].md para cada país
6. Produza o entregável final

Formato do entregável

Salve em stakeholder_reports/pipeline_report_YYYY-MM-DD.md:

# Mapeamento de Stakeholders: [Tema]

**Preparado por**: DCP/Alandar
**Data**: YYYY-MM-DD
**Classificação**: Confidencial — Uso interno do cliente

---

## Sumário executivo

[3-5 parágrafos resumindo:
- Objetivo do mapeamento
- Principais achados (quantos stakeholders, distribuição por posição)
- Destaques estratégicos (quem são os atores-chave, onde estão as oportunidades)
- Lacunas e riscos identificados
- Recomendação principal]

---

## Stakeholders por Tier

### Tier 1 — Essenciais

#### 1. [Nome completo]
**[Cargo] | [Instituição] | Setor: [setor]**
**Posição**: [categoria] (Confiança: [nível])

[Mini-bio de 100-150 palavras]

---

[Repetir para todos do Tier 1]

### Tier 2 — Importantes

[Mesmo formato]

### Tier 3 — Desejáveis

[Mesmo formato]

---

## Análise estratégica

### Mapa de posições

| Posição | Qtd | % | Stakeholders |
|---------|-----|---|-------------|
| Favorável | X | X% | [nomes] |
| Favorável com ressalvas | X | X% | [nomes] |
| Neutro | X | X% | [nomes] |
| Aberto a persuasão | X | X% | [nomes] |
| Crítico | X | X% | [nomes] |
| Contrário | X | X% | [nomes] |
| Desconhecido | X | X% | [nomes] |

### Cobertura setorial

| Setor | Stakeholders | Posição predominante |
|-------|-------------|---------------------|
| Governo | X | [posição] |
| Legislativo | X | [posição] |
| Judiciário/MP | X | [posição] |
| Setor Privado | X | [posição] |
| Sociedade Civil | X | [posição] |
| Academia | X | [posição] |
| Mídia | X | [posição] |
| Internacional | X | [posição] |

### Lacunas identificadas
[Setores ou perspectivas subrepresentadas no mapeamento]

### Dinâmicas e alianças
[Relações entre stakeholders, blocos de interesse, potenciais coalizões]

---

## Recomendações para engajamento

### Prioridades imediatas
1. [Stakeholder/grupo] — [ação recomendada] — [por quê]
2. ...

### Oportunidades de coalizão
[Onde há convergência de interesses que o cliente pode articular]

### Riscos a monitorar
[Stakeholders contrários com poder de veto, mudanças institucionais previstas]

### Sequenciamento sugerido
[Ordem recomendada de engajamento e por quê]

---

## Panorama institucional por país

[INCLUIR APENAS SE deep-dive foi realizado. Para cada país com deep-dive:]

### [País]

#### Marco regulatório
[Resumo das principais leis e normas — extraído do deep-dive]

#### Agências e órgãos relevantes
[Lista das agências com competência sobre o tema]

#### Processos em curso
[Reformas, consultas públicas, tramitações relevantes]

#### Segunda linha governamental
[Operadores-chave identificados no deep-dive]

#### Timeline
[Eventos passados e futuros relevantes]

---

## Fontes e referências

[Consolidação de TODAS as URLs citadas no mapeamento e nas bios, organizadas por stakeholder]

### Fontes por stakeholder

| Stakeholder | Fontes |
|------------|--------|
| [Nome] | [URL1], [URL2] |

### Fontes institucionais
[URLs de sites oficiais de agências, legislação, etc.]

### Score de verificabilidade
- Mapeamento: XX% verificado
- Bios: XX% verificado

---

## Metodologia e limitações

### Processo
- Mapeamento realizado via pesquisa web sistemática em [data]
- [N] rounds de mapeamento, [N] rounds de revisão de bios
- Avaliação de qualidade por consultor adversarial independente
- Verificação independente de fontes e URLs (Stages 1.5 e 2.5)
- Deep-dive por país: [lista de países, ou "não realizado"]

### Limitações
- Baseado em informações publicamente disponíveis
- Posicionamentos estimados podem não refletir posições privadas
- Informações sujeitas a mudança (cargos, posições)
- Cobertura limitada pelo que está disponível online
- URLs verificadas na data do relatório — podem ficar indisponíveis posteriormente

### Scores de qualidade

| Estágio | Score final | Rounds |
|---------|------------|--------|
| Mapeamento | XX/100 | N/3 |
| Mini-bios | XX/100 | N/3 |
| Verificação (mapeamento) | XX% | — |
| Verificação (bios) | XX% | — |

---

*Documento gerado automaticamente pelo Stakeholder Pipeline da DCP/Alandar.*
*Para atualizações ou detalhamento de stakeholders específicos, consulte a equipe.*

---

Atualização final

1. Atualize o plano em stakeholder_reports/plans/ com status COMPLETED
2. Informe ao usuário:
   • Caminho do entregável final
   • Scores de cada estágio
   • Total de stakeholders mapeados
   • Rounds utilizados

---

Limites

• Stage 1: max 3 rounds de mapping + critic
• Stage 2: max 3 rounds de bios + critic
• Nunca loopar infinitamente
• Após max rounds, parar e reportar estado ao usuário com recomendações

"Just Do It" Mode

Quando ativado:

• Pular pausas entre estágios
• Seguir automaticamente para o próximo estágio se score ≥ 70
• Ainda roda todos os loops de qualidade (incluindo verificação de fontes)
• Pular Stage 3 (deep-dive) — deep-dive não roda automaticamente
• Ainda apresenta o relatório final ao término

---

INSTRUÇÃO DE EXECUÇÃO OBRIGATÓRIA

Ao receber este skill, você (o orquestrador) deve:

1. NÃO delegar a orquestração a outro agente — VOCÊ é o orquestrador
2. Usar Task para spawnar cada agente (mapper, bio writer, critic, verifier, deep-dive) como general-purpose
3. Ler o SKILL.md de cada agente e incluir suas instruções completas na prompt do Task
4. Manter controle do estado: qual round, qual score, qual estágio
5. Salvar todos os artefatos intermediários em stakeholder_reports/
6. Produzir o entregável final VOCÊ MESMO (Stage 4) — não delegue a consolidação

Como incluir instruções dos agentes

Antes de spawnar cada agente, leia o SKILL.md correspondente:

• /Users/manoelgaldino/.claude/skills/stakeholder-mapper/SKILL.md
• /Users/manoelgaldino/.claude/skills/stakeholder-bio/SKILL.md
• /Users/manoelgaldino/.claude/skills/stakeholder-critic/SKILL.md
• /Users/manoelgaldino/.claude/skills/stakeholder-source-verifier/SKILL.md
• /Users/manoelgaldino/.claude/skills/stakeholder-deep-dive/SKILL.md

Inclua o conteúdo completo (exceto o frontmatter YAML) na prompt do Task.