AIに任せると起きる「仕様は満たすが思想に反する実装」との付き合い方

SESでフロントエンドエンジニアを務める筆者が、Claude Codeを使って未知のコードベースに入る手順と、AIに任せて起きた失敗の記録をまとめた記事である。READMEは説明文よりセットアップのコマンドを見る、スキルでARCHITECTURE.mdを出力させる、実装前に方針を文章で出させる、といった流れが紹介されている。そのうえで、テストは通るがプロジェクトの思想に反する実装や、既存コンポーネントを見つけられずに新規実装してしまう失敗が取り上げられている。

AIの鬼の視点では、この記事の核心は「AIはコードは読めるが、なぜそう書かれているかは読めない」という一文にある。設計判断の理由は過去の障害やチームの合意といった、コードの外側に残っている。だからAIが一番苦手とするのは、動くのにレビューされるまで誰も気づかない実装だ。ここを、CLAUDE.mdに「Dialogという名前を使っている」のような命名の癖を書いておくという具体策に落としているのが実務的である。AIに文脈を渡す仕事は、結局のところ人間が暗黙知を言語化する仕事なのだと改めて思い知らされる。

中小企業の実務に効くのは、AIに頼む前に「既存の仕組みを探させ、流用しない理由を言わせる」という一手である。社内で業務ツールや帳票を作り直す前に、似た仕組みが既にないかを必ず確認させる。動くから良い、ではなく、今ある資産を使っているかを基準に見ると、無駄な二重管理を防げる。