チームによる AI 駆動開発の勘所：第 3 回 CLAUDE.md に書いた規約が「守られるもの」と「守られないもの」の違い

バックグラウンドの異なる3人が Claude Code と Codex CLI を使って 110日間、同じリポジトリで 1,572 コミットを積み重ねた実践記録。動くアプリケーション開発と 10年動かし続けられるアーキテクチャの設計には異なる判断が必要であり、AGENTS.md だけでなくビルド検査・AI レビュアー・文書の 3か所に規約を分散配置することで、経験の浅い開発者でも大規模置換プロジェクトに参加できる体制を構築した。

Claude Code における指摘事項の処理先を、規約違反・実装パターン・知識不足・設計判断の4分類に仕分ける方法を解説。最も多い誤りは「機械的に判定できるもの（非推奨API、ログ出力、アーキテクチャ違反など）を CLAUDE.md に置く」ことで、これらは Hooks で止めるべき。

Claude Haiku 5.5 へ移行する際、モデル ID 交換前に応答処理と料金見積りの前提を分離するための Python コード例を紹介。思考ブロック・途中終了・使用量欠損を検査し、トークン数計算の変動・キャッシュ別計上・料金帯の適用など実装時の注意点を解説。公開 API 仕様（2026 年 10 月 8 日版）に基づく合成 fixture で再現可能。

Logic Apps から Messages API で Claude を呼び出し、Prompt Caching の動作を検証した記事。システムプロンプトをキャッシュすることで入力トークンコストとレイテンシを削減でき、cache_control 設定で ephemeral キャッシュを 5 分間保持する構成を紹介。Claude Sonnet 4.6 では 1,024 tokens 以上のプロンプトがキャッシュ対象。