Troubleshooting

期待したデータが出ないときは、ここから確認してください。多くの原因は local git hook、git notes、GitHub Pages deploy settings のどれかです。

まず確認すること

local setup を確認します。
Terminal window
```
npx agent-note status
```
commit に note があるか確認します。
Terminal window
```
npx agent-note show
```

notes が push されているか確認します。

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

症状から探す

症状	まず見るところ
PR Report が空	notes が push され、workflow が git history を完全に取得しているか
期待した prompt が出ない	`compact` と `full` の表示差分
Dashboard は開くが PR の data がない	その PR の notes が公開済みか
通常の `git commit` で note が作られない	`init` を再実行し、`status` の `git:` 行を確認
Line Estimate が出ない	Agent が十分な編集情報を出せるか

PR Report が空

まずここを確認してください。

Agent Note 有効化後に PR branch を push している。
remote に refs/notes/agentnote が存在する。
workflow の actions/checkout が fetch-depth: 0 を使っている。
PR に AI-authored file を含む commit がある。

agent が触った committed file を見つけられない commit には note を書きません。人間だけの commit を AI が書いたように見せないためです。

Header が Total AI Ratio: — と Agent Note data: No tracked commits の場合、PR に commit はありますが、その commit の Agent Note data が見つかっていません。本当に AI Ratio が 0% という意味ではありません。

Prompt が足りない

prompt selection は session 全体ではなく commit window に基づきます。

compact は commit の説明に必要な prompt を中心に表示します。
full は保存された prompt をすべて表示します。
今回の commit に説明がある場合、古い task の prompt は省略されます。
短い prompt には、対象 file 名や code identifier が見つかったとき 📝 Context が付きます。

PR Report で保存済み prompt をすべて見たい場合:

with:
  prompt_detail: full

Dashboard に data がない

Dashboard workflow run と Pages settings を確認します。

GitHub Pages source は GitHub Actions にします。
workflow は dashboard: true で実行されている必要があります。
最初に deploy が成功すると、共有 /dashboard/ URL が作られます。
GitHub の environment protection で PR deploy が止まる場合、open PR の data は merge 後に表示されます。

Dashboard が違う PR を開く

Dashboard home は共有履歴を表示し、強制的に ?pr= へ移動しません。PR Report の link だけが該当 PR の ?pr=<number> を付けます。

古い Pages deploy がまだ移動する場合、Dashboard workflow を rerun するか、main から次の deploy が成功するのを待ってください。

普通の `git commit` が tracking されない

status の git: 行を確認します。

npx agent-note status

git hook がない場合は、もう一度 init を実行します。

npx agent-note init --agent claude

git hook は .git/ 内にあるため、agent config file が commit されていても clone ごとに local setup が必要です。

Line Estimate が出ない

多くの場合、これは期待通りです。

Claude Code は通常、Line Estimate に必要な編集情報を出せます。
Codex CLI は transcript の patch 行数が最終 commit diff と一致したときだけ行数を推定できます。
Cursor は edit 行数が一致し、committed file が最後の AI edit と一致したときだけ行数を推定できます。
Gemini CLI は現在、ファイル単位の AI Ratio のみを表示します。

証拠が足りない場合、Agent Note は推測せず、安全な判定に戻します。