立場が違っても、同じ目線で案件を進める — Claude Code を中心に開発運用を共通化した記録

「同じ案件を進めていても、開発者・PM・レビュアーで見えている情報が違う」という問題を、Claude Codeを中心に据えて解消しようとした開発運用の記録である。案件の状態はLinear、GitHub、Slackに分散しており、どれも人が読んで解釈する前提の記録のため、正確な状況を知れるのは聞ける相手を持つ人だけだったという。6サービス・約60リポジトリを実質1〜2人で回す現場で、この非対称を埋めた経緯がまとめられている。

AIの鬼の視点で注目したいのは、ルールの中身の比率である。47ファイル・約9,800行のルール・コマンド・スキルのうち、コードの書き方に関する記述はわずか6行で、残りは案件の状態を機械的に確定させるための定義だったという。AIに「良いコードを書かせる」ことより、「何が確定した事実か」を機械が読める形で定めることに手間がかかった、という結論は、AI活用の現場で多くの人が見落としがちな点だ。プロンプトの巧拙より、情報の置き場所と書式を揃えることが効く。ルールは資産というより、放っておくと腐る負債でもある、という著者の言い回しも現場感があって読みどころだ。

中小企業の実務に置き換えると、明日からできる一言はこうなる。「案件の状態を、誰が読んでも同じ意味になる一つの台帳に寄せよ」。進捗が人の記憶と口頭の確認に頼っているなら、AIに仕事を任せる前に、まずその台帳を一つ作ることが近道である。