【受託SE向け】「記憶を失う天才新人」AI（Claude Code）をプロジェクトに組み込むための運用設計図：39のフックと多層防御システム
本記事は、受託開発のSEが、AIコーディングツールであるClaude Codeを実際の受託開発プロジェクトで運用する際の、極めて詳細なノウハウを公開した技術解説記事です。著者は、AIの特性を「毎朝記憶が消える天才新人」に例え、プロジェクトの崩壊を防ぐための多層的な運用システムを構築した経緯を説明しています。
このシステムは、主に「規約」「hook」「外部ツール」「メモリ管理」の4つの層で構成されています。具体的には、プロジェクトの規約文書（CLAUDE.md）を59行に保つため、内容を分冊し本体を目次として機能させています。また、AIの役割を明確に分離するため、終了コードと出力先に基づいた39本の専用hookを設計・導入しています。
さらに、AIが「直しました」と主張する変更内容を機械的に検証するためのビルドタイムスタンプと4重チェック機構、そして知識の揮発を防ぐための自動pushとメモリindex監視の三点セットを導入しています。これにより、コンテキストの汚染を防ぎ、AIが過去の情報を忘れることをシステム的に補完しています。
また、外部ツール（RTKやkizami）導入時に直面した技術的な罠や、仕様を厳守させるための「Specs-First」な依頼フォーマットなど、実務で得られた知見が網羅されており、単なるAI利用ガイドではなく、AIをチームメンバーとして扱うための包括的な開発プロセス設計図となっています。
背景
大規模言語モデル（LLM）を開発プロセスに組み込む際、AIが持つ「コンテキストウィンドウの限界」や「記憶の揮発」といった特性が、プロジェクトの整合性維持における大きな課題となります。本記事は、この課題に対し、単なるプロンプト設計に留まらず、開発パイプライン全体をシステム的に設計し、AIの弱点を技術的な仕組みで補完する高度な手法を提示しています。
重要用語解説
- 受託SE: 受託開発型のシステムエンジニアの略称。クライアントから特定の要件に基づいたシステム開発を請け負い、納品するエンジニアを指します。プロジェクトの要件定義から実装まで幅広く担当します。
- Claude Code: Anthropic社が提供するClaude AIモデルを活用したコーディング支援ツール。開発者がAIの出力を利用し、実際の開発作業を行うための具体的な運用環境を指します。
- hook: ソフトウェア開発における「フック」は、特定のイベント（例：ファイルの保存、ビルドの開始、コミット）が発生した際に、自動的に実行されるスクリプトや関数を指します。ここではAIの役割を制御する仕組みとして利用されています。
今後の影響
本ノウハウは、AIを単なるアシスタントとしてではなく、明確な役割と制約を持つ「システムの一部」として扱う開発パラダイムを確立する点で極めて重要です。これにより、AI利用による開発の再現性と信頼性が飛躍的に向上し、今後のAIを活用した受託開発の標準的な運用モデルとなることが予想されます。