Troubleshooting

A maioria dos problemas vem de local git hooks, git notes ausentes ou configurações do GitHub Pages.

Checks rápidos

Verifique o setup local.
Terminal window
```
npx agent-note status
```
Verifique se o commit tem note.
Terminal window
```
npx agent-note show
```

Verifique as remote notes.

git fetch origin refs/notes/agentnote:refs/notes/agentnote
git notes --ref=agentnote show HEAD

Comece pelo sintoma

Sintoma	Comece por aqui
PR Report vazio	Confirme que as notes foram enviadas e que o workflow busca o histórico git completo
Um prompt esperado não aparece	Compare `compact` e `full`
Dashboard abre, mas a PR não tem dados	Verifique se as notes dessa PR já foram publicadas
`git commit` não cria note	Rode `init` novamente e veja a linha `git:` em `status`
Line Estimate não aparece	Verifique se o agent pode fornecer evidência de edição suficiente

PR Report vazio

O PR branch foi pushado depois de ativar Agent Note.
refs/notes/agentnote existe no remote.
actions/checkout usa fetch-depth: 0.
A PR contém commits com arquivos tocados pelo agent.

Agent Note não escreve note para commits em que nenhum arquivo commitado pode ser associado ao agent.

Se o header mostrar Total AI Ratio: — e Agent Note data: No tracked commits, a PR tem commits, mas nenhum dado do Agent Note foi encontrado para eles. Isso é diferente de um AI Ratio real de 0%.

Prompts faltando

Prompt selection segue a commit-to-commit window, não a session inteira.

compact mantém o relatório focado mostrando os prompts que explicam o commit.
full mostra todos os prompts salvos.
Prompts de tarefas antigas são omitidos quando o commit atual já tem explicação própria.
📝 Context aparece para prompts curtos quando um nome de arquivo ou identificador de código ajuda a entendê-los.

with:
  prompt_detail: full

Dashboard sem dados

GitHub Pages source deve ser GitHub Actions.
O workflow deve executar dashboard: true.
O primeiro deploy bem-sucedido cria /dashboard/.
Se Pull Request Deploys estiver bloqueado, Open PR data aparece após o merge.

Dashboard abre a PR errada

A home do Dashboard deve mostrar o histórico compartilhado sem forçar ?pr=. Apenas os links do PR Report adicionam o ?pr=<number> da PR atual.

Se um deploy antigo do Pages ainda redirecionar, rode novamente o workflow Dashboard ou espere o próximo deploy bem-sucedido a partir de main.

`git commit` não é rastreado

npx agent-note status
npx agent-note init --agent claude

Git hooks são locais em .git/, então cada clone precisa de init.

Line Estimate não aparece

Isso costuma ser normal.

Claude Code geralmente fornece evidência suficiente para Line Estimate.
Codex CLI só consegue estimar linhas quando a contagem de patches do transcript bate com o final commit diff.
Cursor só consegue estimar linhas quando as contagens de edição batem e o arquivo final ainda corresponde à última edição da IA.
Gemini CLI atualmente mostra apenas AI Ratio no nível de arquivo.

Quando a evidência está incompleta, o Agent Note volta para uma avaliação segura em vez de adivinhar.