AIToday
大規模言語モデルAIコーディングZenn AI/ML掲載日時: 2026年10月16日 10:00

判断理由をAIと人に分離

LINEで送る
判断理由をAIと人に分離

3つのポイント

  1. 何が起きたか

    Claude Codeベースの開発環境を運用する5人チームが、理由を「推奨理由(AI)」と「根拠(人)」に分割し、Claudeに確信度が強いか平坦かを宣言させる/decideスキルを追加した。

  2. なぜ重要か

    最初の1週間で6件の判断記録が記録され、そのすべてがAIの推奨に従い、人による理由が付いていたのは1件だけだった。これにより、理由のないまま下された選択が読者に見えるようになった。

わからないところ、AIに聞けます

質問と回答はこのページに公開されます。

こういう要約が、毎朝あなたのメールに届きます。

背景と解説

チーム自身による意図負債の定義には2つの側面がある。後から追跡できない推論と、AIの「意図に見える」出力が人の判断であるかのように保存されることだ。前者は昔からある問題で、ベテランが去れば理由も一緒に失われる。彼らによれば、AIが変えたのは量である。1人が今やAIとともに、以前よりはるかに多くの判断を1日に行うようになった。後者はより新しい問題で、彼らはAddy Osmaniの「The Intent Debt」に結びつける。そこでは、AIが自信ありげな理由をでっち上げる方が、知らないと認めるより悪いと警告されている。

彼らの答えは行動ではなく構造によるものだった。AIの推論は研究として価値があるため保持されるが、人の根拠欄には入れられない。人が理由を示さない場合、記録は空白のままにせず、その旨を明示する。強制力は人が書くPRテンプレートのセクションから生まれ、CIスクリプトがその行の存在だけを確認する。言葉が人によるものかは決して検証しない。そんなことは機械には証明できないからだ。

この仕組みが自らの欠陥について正直である点は示唆に富む。/decideスキルは単に起動しないことがあり、その場合DEC IDが現れずCIは気づけない。Claudeを移行済み98ファイルに解き放ったとき、コメント外のトークン列は完全に一致し、型チェックとlintも変わらなかったが、レビューで3件の誤りが見つかった。その中には、元のコードに存在しなかった理由を引用するよう書き換えられたコメントもあり、これはまさにこのプロジェクトが防ごうとしている失敗の型だった。

よくある質問
/decideスキルは具体的に何をするのか?
Claude Codeに既存のコードと仕様を調査させ、推奨と自己申告の確信度を添えた選択肢を提示させ、確信度が平坦な場合は人に理由を尋ね、その後で判断記録を書き、コードにはIDだけを残す。
このルールの下でコードコメントはどうなるのか?
コメントに書けるのは、局所的な「なぜ」(制約、回避策、自明でない選択)を3行まで、`// DEC-012-03`のような参照、仕様へのポインタ、ID付きのTODOのみ。翻訳されたコード、背景の段落、変更履歴は禁止。
移行したコードコメントの整理はうまくいったのか?
はい。移行したアプリケーション98ファイルで、コメント行は1,433行から433行に減り、4行以上のブロックは53個から3個に減った。ただし残った3個のうち2個は、ルール対象外のビルドスクリプトの使用メモだった。
LINEで送る

あなたの仕事に関係するAIニュースを、毎朝お届けします。

業界と使っているAIツールを選ぶと、仕事に関係するニュースが毎朝届きます。

登録無料・Googleアカウントなら30秒・いつでも解除できますAITodayについて →

AIに質問

この記事についてわからないことをAIに質問できます。AIはこの記事・AIToday の過去記事・Wikipedia を読み、出典を付けて答えます。Q&Aはこのページに公開され、他の読者も読めます。

質問と回答はこのページに公開されます。

関連記事

次の記事へリーナス・トーバルズがAIでLinuxカーネル改善