AIモデル・生成AIの選び方

AIコーディングの寄り道を減らす。古いTODOと完了条件を整理する

公開日 ・更新日

AIコーディングの速度を落とすのは、モデルだけではありません。古いTODOや完了条件のないメモが、依頼していない作業へエージェントを向けます。

TODOは作業依頼として読まれる

Googleの分析では、コードを読むセッションの13%がinline TODOやFIXMEに触れ、6%で追加行動が起きました。その追加行動の83%は依頼されていないものです。分析対象では、依頼外の寄り道が1セッションあたりの手順を70%、トークンを77%、待ち時間を105%増やしました。これはGoogleの分析対象に限る数字で、あなたの会社へそのまま当てはめるものではありません。

人には古いメモに見えても、エージェントには今すぐ確認すべき指示に見えることがあります。完了済みの課題、保留中の課題、依頼中の作業を同じ形式で残すと、調査の範囲が広がる。まず状態と担当を分けます。

完了済み・保留中・依頼外を分ける

リポジトリを読む前に、今回の依頼、触ってよい範囲、触らない範囲を一文で書きます。TODOには担当、期限、完了条件、参照する記録を置く。完了済みなら削除候補にし、削除が不安なら課題管理へ移してコードから外します。

AIエージェントに任せる作業は、一つの目的に絞ります。途中で見つけた別の問題は、依頼の中へ勝手に取り込まず、別の候補として人へ返す。これだけで、変更差分とレビューの範囲が見えます。

変更前に完了条件を決める

作業の開始時に、動作確認、テスト、目視確認の条件を先に決めます。エージェントが別のTODOを見つけても、完了条件にない変更は止める。人が差分を読み、公開や顧客データに関わる操作を最後に判断します。

あなたの会社でも、まず一つのリポジトリで古いTODOを一覧化してください。依頼範囲、完了条件、レビュー担当を決めてからAIを動かす。AIエージェントの作業範囲とレビュー設計は、COZITOへご相談ください。

著者: 松井 勇樹