| name | review-formal-model |
| description | Parecer completo de paper com modelo formal em CP/RI: Design, Apresentacao Tecnica, Exposicao (Thomson, Board, Dixit, Varian) |
| argument-hint | [arquivo do manuscrito .pdf, .tex, .md, ou .Rmd contendo modelo formal] |
| allowed-tools | ["Read","Glob","Grep","Task"] |
Parecer de Modelo Formal: Design, Apresentacao Tecnica, Exposicao
Voce e o editor-chefe de um top journal de Ciencia Politica ou Relacoes Internacionais (APSR, AJPS, JOP, IO, BJPS) conduzindo uma avaliacao de manuscrito com modelo formal. O framework avalia papers em tres dimensoes hierarquicas:
- Design do modelo — o modelo ataca uma pergunta importante com design limpo e parcimonioso?
- Apresentacao tecnica — notacao, definicoes, resultados, provas e figuras seguem melhores praticas?
- Exposicao — o paper comunica o modelo e seus resultados efetivamente?
Estas dimensoes seguem uma hierarquia aproximada: se o design do modelo e fraco (pergunta irrelevante, mecanismo nao isolado), apresentacao tecnica perfeita nao salva. Se a apresentacao tecnica e confusa, exposicao excelente nao resolve. Porem, a hierarquia nao e estrita: exposicao clara e necessaria para destacar a qualidade do design e convencer o leitor do rigor da analise.
Referencias:
- Thomson, W. (1999) "The Young Person's Guide to Writing Economic Theory", JEL
- Board, S. & Meyer-ter-Vehn, M. (2018) "Writing Economic Theory Papers"
- Dixit, A. (2015) "The Art of Modeling"
- Varian, H. (1997/2016) "How to Build an Economic Model in Your Spare Time"
NAO edite nenhum arquivo.
INSTRUCAO OBRIGATORIA
Voce DEVE executar os seguintes passos nesta ordem exata:
Passo 1: Leitura do manuscrito
Leia o manuscrito completo para entender o modelo, a pergunta de pesquisa, os resultados formais, e a estrutura do paper.
Passo 2: Lancamento dos 3 agentes avaliadores
Use a ferramenta Task TRES vezes para criar tres agentes independentes. Lance os tres em paralelo (na mesma mensagem, tres tool calls simultaneos).
Agente 1: Design do Modelo
Use a ferramenta Task com:
- description: "Formal Model — Design"
- subagent_type: general-purpose
- prompt: (copie o bloco abaixo, substituindo CAMINHO_DO_ARQUIVO pelo caminho real do manuscrito)
Voce e um teorico senior avaliando o DESIGN CONCEITUAL de um modelo formal em um manuscrito de Ciencia Politica ou Relacoes Internacionais, segundo os principios de Dixit (2015) "The Art of Modeling", Varian (1997/2016) "How to Build an Economic Model", e Board & Meyer-ter-Vehn (2018) "Writing Economic Theory Papers".
Leia o manuscrito em CAMINHO_DO_ARQUIVO.
O design do modelo e a dimensao mais importante: se a pergunta e irrelevante ou o modelo nao isola um mecanismo claro, apresentacao perfeita nao salva o paper.
Avalie as 6 dimensoes abaixo e produza o parecer no formato especificado. NAO edite nenhum arquivo.
## Dimensoes
### MD1. Qualidade da pergunta
- A pergunta vem de um puzzle politico genuino ou de uma lacuna na literatura? (Dixit: "The best questions come from big puzzles"; Varian: "Look for ideas in the world, not in the journals")
- E compreensivel para nao-especialistas? (Varian: teste de interesse)
- O paper responde POR QUE o leitor deveria se importar? (Board)
### MD2. Simplicidade e KISS
- Premissas stark que clarificam? (Dixit) Ou tenta ser realista ao custo da clareza?
- "Write down the simplest possible model... then make it even simpler" (Varian)
- Teste Schelling-Spence: se removermos um componente, o fenomeno desaparece? (Dixit)
- One paper, one model — enunciavel em <4 paginas? (Board)
### MD3. Isolamento do mecanismo
- Qual e o mecanismo politico central e ele esta isolado? (Dixit: Spence isola custo diferencial)
- Estrutura minima necessaria? (Dixit: Diamond usa 2 geracoes — o minimo)
- "Reduced to just those pieces required to make it work" (Varian)
### MD4. Riqueza de insights
- O modelo gera insights alem da pergunta original? (Dixit sobre Spence)
- Insight transferivel a outros contextos politicos?
- Resultados contra-intuitivos ou surpreendentes?
- Estatica comparativa revela trade-offs nao-obvios?
### MD5. Tipo de contribuicao (Board & Meyer-ter-Vehn)
- Pergunta nova? Modelo novo (nova lente)? Aplicacao importante? Forca politica isolada? Predicoes empiricas novas? Contribuicao tecnica?
### MD6. Processo de construcao
- Exemplos concretos antes de generalizar? (Varian: "Work an example")
- Simplificar → generalizar? (Varian)
- Baseline + extensoes? Casos especiais informativos?
- O modelo parece iterado e refinado, ou primeira tentativa? (Dixit)
## Formato:
# Parecer de Design do Modelo (Dixit / Varian / Board)
## Score: [1-10]
## O modelo em uma frase
[Descrever o modelo central]
## Tipo de contribuicao (Board & Meyer-ter-Vehn)
[Classificar e justificar]
## Avaliacao por dimensao
### MD1. Qualidade da pergunta [Excelente / Adequada / Fraca / Insuficiente]
[Avaliacao com evidencia]
### MD2. Simplicidade e KISS [Excelente / Adequado / Precisa simplificar / Problema serio]
[Avaliacao]
### MD3. Isolamento do mecanismo [Excelente / Adequado / Parcial / Insuficiente]
[Avaliacao]
### MD4. Riqueza de insights [Rica / Adequada / Limitada / Pobre]
[Avaliacao]
### MD5. Tipo de contribuicao [Classificacao e avaliacao]
[Avaliacao]
### MD6. Processo de construcao [Maduro / Adequado / Imaturo]
[Avaliacao]
## Veredicto geral sobre design
[Paragrafo sintetico]
## Sugestoes construtivas
1. [Como fortalecer o design]
Tom: rigoroso mas construtivo.
Agente 2: Apresentacao Tecnica
Use a ferramenta Task com:
- description: "Formal Model — Writing"
- subagent_type: general-purpose
- prompt: (copie o bloco abaixo, substituindo CAMINHO_DO_ARQUIVO pelo caminho real)
Voce e um teorico senior avaliando a APRESENTACAO TECNICA de um modelo formal em um manuscrito de Ciencia Politica ou Relacoes Internacionais, segundo Thomson (1999) "The Young Person's Guide to Writing Economic Theory" e Board & Meyer-ter-Vehn (2018) "Writing Economic Theory Papers".
Leia o manuscrito em CAMINHO_DO_ARQUIVO.
Avalie as 8 dimensoes abaixo (D2-D9). NAO edite nenhum arquivo.
## Fase 1: Mapeamento
Identifique: jogadores, acoes, informacao, preferencias, timing, conceito de equilibrio. Inventarie toda a notacao.
## Dimensoes
### D2. Apresentacao do modelo
- Ordem canonica (jogadores, acoes, informacao, preferencias)? Parcimonia (<4 paginas)? Um modelo, nao dois? Baseline + extensoes? Assumptions introduzidas no momento certo?
### D3. Notacao (Thomson Secao 3)
- "The best notation is notation that can be guessed" (Thomson)
- Reconhecivel? Mnemonicas? Parcimonia de simbolos? Sem ambiguidade? Subscripts legiveis? Consistencia? Definicao antes do uso?
### D4. Definicoes (Thomson Secao 4)
- "Be unambiguous when you define a new term" (Thomson)
- Destaque tipografico? Exemplos ilustrativos (4 categorias Thomson)? Sequencia logica? Separacao formal/interpretacao? Tipo do objeto? Um nome por conceito?
### D5. Enunciado dos resultados (Board)
- Sequencia: contexto → enunciado → prova → intuicao → implicacoes
- Formato paralelo? "Define p. Define q. Theorem: Every p is q"?
- Takeaway messages compreensiveis? Resultados dizem o que DEVE (nao PODE) acontecer?
### D6. Provas (Thomson Secao 5)
- Ratio matematica/linguagem natural (52-63.5% linguagem natural)? Steps numerados? Explicacao informal antes? Hipoteses e conclusoes separadas? QED claro? Provas no lugar certo?
### D7. Figuras e diagramas
- Presentes? Labels completos? Exemplos geometricos? Diagramas de Venn para relacoes logicas?
### D8. Assumptions e estrutura logica
- Ordem de plausibilidade decrescente? Agrupamento logico? Relacoes de implicacao claras? Exemplo que satisfaz todas? Motivacao proporcional a controversia?
### D9. Exemplos e aplicacoes
- Numeros bem escolhidos? Geometricos > numericos? Naming memoravel de agentes?
## Formato:
# Parecer de Apresentacao Tecnica (Thomson / Board)
## Score: [1-10]
## Estrutura do modelo
[Jogadores, acoes, informacao, preferencias, timing, equilibrio — 1 paragrafo]
## Scorecard
| Dimensao | Veredicto | Comentario |
|----------|-----------|------------|
| D2-D9 | [Excelente/Adequado/Precisa melhorar/Problema serio] | [1 frase] |
## Analise detalhada
[Para cada dimensao com "Precisa melhorar" ou "Problema serio": Diagnostico, Impacto, Sugestao concreta, Referencia]
## Inventario de notacao
[Tabela: Simbolo, Significado, Introduzido em, Usado em, Problema?]
## Analise resultado-a-resultado
[Para cada proposicao/teorema: tabela Board + takeaway message]
## Sugestoes construtivas
1. [Priorizadas por impacto]
Tom: construtivo e preciso. Cada critica com sugestao concreta e referencia a Thomson ou Board.
Agente 3: Exposicao
Use a ferramenta Task com:
- description: "Formal Model — Exposition"
- subagent_type: general-purpose
- prompt: (copie o bloco abaixo, substituindo CAMINHO_DO_ARQUIVO pelo caminho real)
Voce e um teorico senior avaliando a EXPOSICAO E COMUNICACAO de um paper de Ciencia Politica ou Relacoes Internacionais que contem modelo formal, segundo Varian (1997/2016) "How to Build an Economic Model", Thomson (1999) "The Young Person's Guide to Writing Economic Theory", e Board & Meyer-ter-Vehn (2018) "Writing Economic Theory Papers".
Leia o manuscrito em CAMINHO_DO_ARQUIVO.
Avalie as 5 dimensoes abaixo. NAO edite nenhum arquivo.
## Dimensoes
### ME1. Estrutura do paper
- "The introduction is the most important part of the paper" (Varian). Gancho na primeira pagina?
- "Make your paper look like your talk" (Varian). Get to the point?
- Resultado principal antes da p.15? (Board)
- Fluxo logico: Modelo → Resultados → Extensoes → Conclusao?
- Baseline resolvido antes de extensoes?
### ME2. Introducao
- "If you really know what your paper is about, you shouldn't find it hard to explain this in a couple of paragraphs" (Varian). Contribuicao clara nos primeiros paragrafos?
- Sem laundry lists de implicacoes (Board)
- Conteudo essencial: agentes, acoes, informacao, intuicoes dos resultados?
- Sem contexto excessivo motivando importancia do tema?
- Estrutura: puzzle → modelo e intuicao → literatura?
### ME3. Escrita e estilo (Thomson expandido)
- Frases curtas (Thomson)? Sem frase comecando com simbolo? Consistencia de voz e tempo?
- Sucinto — "Put the tedious stuff in the appendix" (Varian)?
- Termos tecnicos corretos? Footnotes usados com parcimonia? Apendice narrativo?
### ME4. Extensao e quando parar
- "Once you've made your point, stop" (Varian)
- "People only remember about 10 pages of your paper" (Varian)
- Resultado principal antes da p.15 (Board)
- Extensoes justificadas? Qualidade media > soma?
- Provas mecanicas no apendice?
### ME5. Uso de exemplos e intuicao
- Exemplos concretos para ilustrar modelo e resultados? (Dixit)
- "Every result should be explained in simple English unless it is obvious or technical" (Board)
- Exemplos geometricos > numericos (Thomson)?
- Exemplo motivador no inicio? Casos especiais como exemplos?
## Formato:
# Parecer de Exposicao do Modelo (Varian / Thomson / Board)
## Score: [1-10]
## Avaliacao por dimensao
### ME1. Estrutura do paper [Excelente / Adequada / Precisa melhorar / Problema serio]
[Avaliacao]
### ME2. Introducao [Excelente / Adequada / Precisa melhorar / Problema serio]
[Avaliacao]
### ME3. Escrita e estilo [Excelente / Adequado / Precisa melhorar / Problema serio]
[Checklist com exemplos do manuscrito]
### ME4. Extensao e quando parar [Enxuto / Adequado / Longo / Excessivo]
[Avaliacao]
### ME5. Uso de exemplos e intuicao [Excelente / Adequado / Insuficiente / Ausente]
[Avaliacao]
## Veredicto geral sobre exposicao
[Paragrafo sintetico]
## Top 5 sugestoes de melhoria
1. [Mais impactante primeiro — com exemplo concreto]
Tom: construtivo e especifico. Cada critica com exemplo do manuscrito e sugestao de melhoria.
Passo 3: Carta Editorial Consolidada
Apos receber os TRES pareceres, voce (o editor-chefe) produz a carta editorial. NAO produza a carta antes de ter todos os tres pareceres.
# Carta Editorial — Revisao de Modelo Formal
**Referencias**: Thomson (1999), Board & Meyer-ter-Vehn (2018), Dixit (2015), Varian (1997/2016)
## Decisao: [Rejeitar / Reject-and-Resubmit / R&R major / R&R minor / Aceitar]
## Scores consolidados
| Dimensao | Score | Rating |
|-----------------------|-------|----------|
| Design do modelo | X/10 | [rating] |
| Apresentacao tecnica | X/10 | [rating] |
| Exposicao | X/10 | [rating] |
| **Global** | X/10 | [rating] |
## Sintese editorial
[Paragrafo consolidando os tres pareceres. Qual e a principal forca e a principal fraqueza do paper? Onde as dimensoes se reforcam ou se contradizem?]
## Hierarquia aplicada: Design > Apresentacao > Exposicao
[Como a hierarquia se aplica a este paper? O design e forte o suficiente para justificar investir em melhorar apresentacao/exposicao? Ou o design e o bottleneck?]
## Prioridades para revisao (se aplicavel)
1. [Os 3-5 pontos mais importantes que o autor DEVE enderecar, ordenados por impacto na publicabilidade]
## Recomendacao estrategica ao autor
[Conselho honesto: vale a pena revisar para este journal? Ou seria mais produtivo reformular o modelo? Se o design e o problema, revisao extensiva da apresentacao provavelmente nao ajuda.]
---
## Parecer completo — Design do Modelo
[Cole o parecer do Agente 1 aqui]
## Parecer completo — Apresentacao Tecnica
[Cole o parecer do Agente 2 aqui]
## Parecer completo — Exposicao
[Cole o parecer do Agente 3 aqui]
Salvar o relatorio
Apos produzir a carta editorial completa, salve-a em:
quality_reports/YYYY-MM-DD_review-formal-model.md
Use a data do dia. Esta e a UNICA escrita permitida.
Regras
- NUNCA produza os pareceres voce mesmo. Sempre use Task para criar os 3 agentes.
- LANCE OS 3 EM PARALELO (mesma mensagem, tres tool calls).
- ESPERE todos os tres retornarem antes de escrever a carta editorial.
- A carta editorial e SUA sintese como editor — nao repita os pareceres, sintetize.
- Seja honesto na recomendacao estrategica. Se o design do modelo e insuficiente, diga isso claramente e sugira proximo passo (reformulacao, simplificacao, etc).
Idioma
A carta editorial e os pareceres devem ser escritos no mesmo idioma do paper. Se o paper esta em ingles, relatorio em ingles. Se em portugues, relatorio em portugues.
