specは腐る、動くreferenceは腐らない — AIエージェント用スキルをbuild/repairで分離した話
この記事で分かること
AIエージェントのスキルをbuild（構築）とrepair（修復）に分離する設計手法を学べる。仕様書より動作するリファレンス実装が長く使えるという前提で、保守性と拡張性を両立する具体的な分離基準が示されている。
詳細要約
AIエージェント開発では、静的な仕様書に依存するより、実際に動作するコードをリファレンスとして維持し、スキルを「構築（build）」と「修正（repair）」に役割分離する方が長期的に有効である。buildでは新規スキルを生成し、repairでは実行エラーや要求変更に応じて該当スキルを直接修正する。この分離により、仕様書の陳腐化を回避し、動く実装だけを更新対象にできる。注意点として、buildとrepairの間で参照するリファレンスコードを一元管理しないと、修正が別の生成に影響を与えて整合性が崩れる恐れがある。