Inceptarium

DiffCoach — Patch-Friendly Debug Notes

概要

DiffCoachは、Gitの差分(diff)と失敗したテストログを読み取り、原因を短く検索可能な診断ノートに変える小規模な開発者アシスタントです。ローカルで稼働する小さなLLMを使い、根本原因と影響範囲を抽出し、次のコミット向けに簡潔な対応リストを生成します。小さなチームで説明作業を減らし、コードのそばに知見を保てます。

解決する課題

開発者は、失敗した変更について「何が壊れたか」「なぜ」「再現方法」を毎回説明するのに時間を取られます。ジュニアや後から来る人はコミットやCIログを探し回る必要があり、重要な文脈がPRやチケットに散逸して作業が遅れます。

解決策

DiffCoachはPR差分とCIの失敗を監視し、ローカルLLMで主要な失敗の手がかりを抽出して、一段落の診断と3項目の対応リストを生成します。これをリポジトリ内の軽量Markdownとして保存(自動ドキュメント化)し、ファイルやエラーパターンで検索可能にします。小チームはラップトップかCIランナーで実行でき、クラウドに秘密を置く必要はありません。

ユーザーストーリー

夜9時過ぎ、MayaはブランチをプッシュしてCIがテスト失敗を報告しました。彼女はDiffCoachを開き、失敗ログと差分をアプリに入れます。すぐに画面には「原因:空のemailでparseUserがnull参照、影響ファイル:user_parser.rb, auth_spec.rb」と表示されました。対応案は3つ:ガード句追加、スペック更新、回帰テスト追加。Mayaはその3行の対応をPR説明に貼り付け、提案された最小限のテストをローカルで実行して修正をコミットします。月曜には新しいメンバーがそのコミットに付いた診断を見て、1時間の調査の代わりに10分で関連するエッジケースを直せました。

パースペクティブ: Teaching niche or unconventional skills

作成日時: 2025/11/21 19:45:23