Ferramentas

Workflow de Agentes

Uso Claude Code como ambiente de trabalho para pesquisa acadêmica. O sistema combina agentes especializados, regras de qualidade e um protocolo plan-first para tarefas como escrever papers, analisar dados, revisar manuscritos e preparar apresentações.

A inspiração veio do workflow de Pedro Sant'Anna. A minha versão é mais enxuta, adaptada ao meu dia a dia de pesquisa em ciência política e economia política internacional.

Como Funciona

Revisão e Qualidade de Pesquisa

Skills focadas em avaliar e melhorar manuscritos, com múltiplas perspectivas e critérios formais.

  • review-paper — Revisão estilo referee de top journal (dois pareceristas independentes)
  • research-pipeline — Pipeline com agentes separados: reviewer, implementador, verificação cruzada
  • edmans-review — Avaliação nas 3 dimensões Edmans: Contribution, Execution, Exposition
  • proofread — Gramática, typos e consistência
  • validate-bib — Validação cruzada de referências e citações
  • abstract-annotator / introduction-annotator — Avaliação estrutural de abstracts e introduções

Modelos Formais

Avaliação de papers com modelos formais em Ciência Política e Relações Internacionais.

  • review-formal-model — Parecer completo: design, apresentação técnica e exposição
  • formal-model-design — Design conceitual (Dixit, Varian, Board)
  • formal-model-writing — Notação, definições, provas e figuras (Thomson, Board)
  • formal-model-exposition — Comunicação e estrutura do paper
  • math-guide — Guia matemático em PDF para provas de artigos

Análise de Dados

  • data-analysis-r — Pipeline end-to-end em R (fixest, tidyverse, modelsummary)
  • data-analysis-python — Análise em Python (pandas, statsmodels, linearmodels)
  • review-r / review-python — Revisão de qualidade de código
  • compile-rmd — Compilar RMarkdown (PDF/HTML)

Apresentações e Escrita

  • slide-excellence — Revisão multi-dimensão de slides
  • visual-audit — Auditoria visual de apresentações
  • pedagogy-review — Narrativa, notação e pacing
  • theory-framing — Diagnóstico de enquadramento teórico
  • lit-review — Revisão de literatura sistemática + síntese + gaps
  • research-ideation — Geração de questões de pesquisa + estratégias empíricas
  • interview-me — Entrevista interativa para refinar ideias, clarificar argumentos e descobrir a mensagem principal

Análise de Stakeholders e Política

  • stakeholder-pipeline — Pipeline completo: mapeamento, crítica, verificação, bios e deep-dive
  • policy-analysis — Framework de análise de políticas públicas (9 módulos)
  • strategic-negotiation — Preparação de negociações complexas (9 módulos)
  • ipe-expert — Domain expert em Economia Política Internacional
  • devils-advocate — Desafiar argumentos e apresentações

Exemplos de Uso

Gestão de Projetos

Visão centralizada do portfólio de pesquisa, mantida automaticamente pelos agentes durante o trabalho.

  • dashboard — Visão geral, refresh e detalhe de todos os projetos de pesquisa ativos

Regras de Contexto

Quatro regras ativadas automaticamente conforme o tipo de arquivo ou situação:

  • Plan-First Workflow — Obriga planejamento antes de execução. Planos salvos em disco sobrevivem à compressão de contexto.
  • Quality Gates — Rubricas de scoring por tipo de arquivo (.R, .Rmd, .py, .qmd) com deduções por severidade.
  • Session Recovery — Protocolo de recuperação após compressão ou nova sessão: ler memória, verificar planos, checar git, declarar entendimento.
  • Dashboard Update — Regra global que instrui todo agente a atualizar o dashboard centralizado após sessões com resultado substantivo (commit, simulação, decisão estratégica).