update-paper

name	update-paper
description	Atualiza secoes de resultados em arquivos LaTeX (.tex) quando analises, metricas ou CSVs mudam. Use apos rodar pipelines de ML/calibracao que geram novos resultados, apos correcoes de bugs que alteram numeros, ou quando o usuario pedir /update-paper ou "atualiza o paper/latex".

Skill: update-paper

Sincroniza arquivos .tex do projeto com os resultados numericos mais recentes. Trata apenas das secoes de resultados e metodologia afetadas pelas mudancas.

Quando usar

• Apos rodar um pipeline que gera ou atualiza CSVs de resultados
• Apos correcao de bug que muda valores numericos
• Apos adicionar novo metodo ou regiao ao pipeline
• Quando o usuario pede /update-paper, "atualiza o paper", "atualiza o latex"
• Ao final de sessao com mudancas significativas em analises

Passos

1. Mapear o projeto

Rodar em paralelo:

find . -name "*.tex" -not -path "./.git/*" | sort
find . -name "*.csv" -newer . -not -path "./.git/*" | sort
git diff HEAD --stat
git log --oneline -5

Identificar:

• Todos os .tex no projeto (paper principal, papers de experimentos)
• CSVs de resultados alterados desde o ultimo commit
• O que mudou no diff (novos metodos, regioes, metricas)

2. Ler os resultados atuais

Para cada CSV de resultados identificado, ler o conteudo completo. Exemplos comuns em projetos de calibracao/ML:

• plots/full_comparison.csv -- resultados por metodo e regiao
• plots/fairness_summary.csv -- metricas de equidade
• experiments/*/results.csv -- resultados de experimentos especificos

Calcular os valores resumo que aparecem nos papers:

• Medias por metodo (mean across regions)
• Melhores/piores valores por metrica
• Deltas vs baseline

3. Ler os papers LaTeX

Ler cada .tex identificado no passo 1. Localizar:

• Tabelas com resultados numericos (\begin{tabular} com valores decimais)
• Valores numericos citados no texto ("ECE = 0.0577", "$-18%$", etc.)
• TODOs de atualizacao (comentarios % TODO)
• Seccoes de resultados e discussao

4. Identificar o que atualizar

Para cada valor numerico no .tex, verificar se difere dos resultados atuais nos CSVs. Priorizar:

1. Tabelas de resultados (maior impacto, mais propenso a desatualizar)
2. Valores citados no abstract e conclusao
3. Valores citados na discussao
4. TODOs marcados no arquivo

Nao alterar:

• Equacoes e definicoes formais
• Referencias bibliograficas
• Secoes de metodologia (a menos que o metodo tenha mudado)
• Texto narrativo que nao depende de valores numericos especificos

5. Aplicar as atualizacoes

Atualizar apenas o que mudou. Para cada alteracao:

• Usar Edit para substituicoes pontuais (nunca reescrever o arquivo inteiro)
• Manter o estilo LaTeX existente (precisao decimal, formato de tabela)
• Remover comentarios % TODO dos itens resolvidos
• Adicionar comentario % updated YYYY-MM-DD nas tabelas alteradas

Regras de estilo (manter consistencia com o paper):

• Se o paper usa 4 casas decimais -> manter 4 casas
• Se usa \textbf{} para melhor resultado -> manter
• Se usa \multirow -> preservar estrutura

6. Verificar consistencia

Apos as edicoes, verificar:

• Abstract ainda reflete os melhores resultados?
• Conclusao ainda e valida com os novos numeros?
• Key findings na discussao continuam corretos?
• Numero de regioes/metodos citados no texto bate com os dados?

7. Reportar

Listar de forma concisa:

• Quais arquivos .tex foram alterados
• Quais tabelas/valores foram atualizados
• Se houver discrepancias que exigem revisao manual do usuario (ex: interpretacoes na discussao que mudaram de sentido)

Notas importantes

• NUNCA alterar definicoes formais, equacoes matematicas ou metodologia
• NUNCA inferir interpretacoes clinicas -- apenas atualizar numeros
• Se o sentido de um achado mudou (ex: metodo A era melhor, agora metodo B e melhor), reportar ao usuario em vez de reescrever a interpretacao automaticamente
• Respeitar todas as regras de humanizacao do CLAUDE.md (sem travessoes, sem Unicode decorativo)
• Se o paper estiver em PT e EN, atualizar ambos