| 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-purposedescription: "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-purposedescription: "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-purposedescription: "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-purposedescription: "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-purposedescription: "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-purposedescription: "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-purposedescription: "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
- Leia o último mapeamento aprovado (
stage1_mapping_round{último}.md)
- Leia as últimas bios aprovadas (
stage2_bios_round{último}.md)
- Leia todos os relatórios de crítica para extrair scores
- Leia os relatórios de verificação (
stage1.5_verification.md, stage2.5_verification.md) para extrair scores de verificabilidade
- Se houver deep-dives, leia
deep_dive_[país].md para cada país
- 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
- Atualize o plano em
stakeholder_reports/plans/ com status COMPLETED
- 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:
- NÃO delegar a orquestração a outro agente — VOCÊ é o orquestrador
- Usar Task para spawnar cada agente (mapper, bio writer, critic, verifier, deep-dive) como
general-purpose
- Ler o SKILL.md de cada agente e incluir suas instruções completas na prompt do Task
- Manter controle do estado: qual round, qual score, qual estágio
- Salvar todos os artefatos intermediários em
stakeholder_reports/
- 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.
