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
1. Plan First
Toda tarefa não-trivial começa em modo planejamento. O agente lê a memória persistente, rascunha um plano, salva em disco e espera aprovação antes de executar.
2. Agentes Especializados
Cada skill é um prompt especializado: revisão de paper, análise de dados em R, auditoria de slides, proofreading, modelagem formal. O agente escolhe a skill certa para a tarefa.
3. Quality Gates
Scoring automático com rubrica por tipo de arquivo. 80/100 para commit, 90/100 para circulação, 95/100 como meta de excelência. Erros críticos zeram a nota.
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-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
Definindo a mensagem do site com interview-me
Quando montei este site, não tinha clareza sobre qual deveria ser a mensagem principal. Rodei a skill interview-me, que funciona como uma entrevista socrática: o agente faz perguntas encadeadas sobre minha pesquisa, trajetória e público-alvo, forçando-me a articular o que importa. Em três rodadas de perguntas, ficou claro que o fio condutor era a Ordem Liberal Internacional como agenda central de pesquisa, apoiada por métodos rigorosos de inferência causal e modelagem formal — algo que não aparecia na versão anterior do site. Isso reorganizou toda a comunicação: bio, pesquisa em destaque e a estrutura das páginas.
Reescrevendo um paper com edmans-review
Usei edmans-review para avaliar um working paper antes de submeter. O agente avalia Contribution, Execution e Exposition separadamente, com scoring e diagnósticos concretos. O parecer apontou que a contribuição estava diluída — eu listava vários resultados sem hierarquizar qual era o achado central. Mais útil foi a heurística bayesiana: o agente pergunta "quanto um leitor informado atualizaria suas crenças ao ler este paper?". A pergunta é simples, mas me forçou a separar o que era de fato novo do que eu apenas gostava de discutir. Na prática, reescrevi a introdução em torno de um único resultado e cortei uma seção que não mudava a conclusão de ninguém.
Visão de portfólio com dashboard
Com ~15 projetos de pesquisa simultâneos, cada um com seu próprio contexto e memória persistente, era impossível lembrar onde cada um estava. Criei uma skill dashboard que mantém um arquivo Markdown central com tabela resumo e seções detalhadas por projeto. A parte importante: os agentes atualizam o dashboard automaticamente ao final de cada sessão com resultado substantivo, via uma regra global. Rodar /dashboard mostra urgências e bloqueios em 10 segundos. /dashboard refresh escaneia todos os MEMORY.md e detecta discrepâncias. Na prática, eliminou o problema de reabrir um projeto e não lembrar onde parei — o dashboard sempre responde "onde está cada projeto e o que fazer a seguir".
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).