Bug Report Packet で AI 生成コードをデバッグする
AI-built app のエラーを Cursor、Claude Code、Codex、ChatGPT、Lovable、Bolt、Replit Agent や開発者に渡せる debugging packet に整理します。
AI 生成コードが壊れたとき、最後の error だけを別の prompt に貼るのは不十分です。良い handoff には exact error、expected behavior、actual behavior、reproduction、recent AI change、already tried が必要です。
Bug Report Packet Builder はその context をローカルで整理し、Cursor、Claude Code、Codex、ChatGPT、Windsurf、Lovable、Bolt、Replit Agent、issue tracker に渡せます。
Raw error だけでは足りない理由
Raw error は通常、次を説明しません。
- 何が起きるべきだったか
- ユーザーが何をしたか
- local、preview、production のどこで起きるか
- bug の直前に AI が何を変えたか
- 何をすでに試したか
これがないと agent は無関係なファイルを書き換えたり、失敗済みの修正を繰り返したりします。
入れる内容
| Section | Content |
|---|---|
| Context | tool、bug type、environment |
| Error | console error、stack trace、build log、API response |
| Expected | 修正後に期待する挙動 |
| Actual | 実際の壊れた挙動 |
| Reproduction | clean state からの numbered steps |
| Recent AI change | prompt、changed files、agent note |
| Already tried | command、rebuild、edit、prompt |
API bug では method、URL、headers、payload、status、server log も入れます。API debugging guide も使えます。
Packet を次の prompt にする
Use this bug report packet to identify the likely cause.
Ask for missing information before guessing.
Propose the smallest safe patch.
Do not rewrite unrelated files.
Explain how to verify the fix.
修正後は AI Coding Workflow Checklist に戻り、build、env vars、review gates、deploy を確認します。