role-bug-finder-playbook

name	role-bug-finder-playbook
description	Issue Finder agent がコードベースの実際の不具合、仕様違反、境界条件や異常系の欠陥を発見するときに使う分野別の探索観点、課題判定、重要度基準、誤検知の除外条件を定義する。

Bug Finder Playbook

issue-finder-playbook と併用する。

探索観点

• 公開仕様、型、validation と実装の不一致
• 境界値、空値、欠損値、重複、順序、時刻、並行処理
• error の握りつぶし、誤変換、不完全な cleanup、部分成功
• 状態遷移、永続化、cache、再試行、冪等性の破綻
• caller と callee、producer と consumer の contract 不整合
• 正常系テストだけでは見逃される異常系と回帰経路

課題判定

実行結果、テスト、仕様との比較、または追跡可能な制御・データフローによって、期待と実際の振る舞いの差を説明できるものだけを課題にする。単なる可読性や将来の変更しにくさは maintenance finder へ委ねる。

重要度

• Critical: データ破壊、全体停止など広範囲で不可逆な障害が通常条件で成立する。
• High: 主要機能が失敗する、または重要データの整合性を損なう。
• Medium: 限定条件で機能が誤動作し、回避策や再試行が必要になる。
• Low: 周辺機能や表示などに限定された実害がある。

除外

• 再現条件や因果関係を示せない憶測
• 仕様上許容された振る舞い
• 動作上の問題へ結び付かない好みや style