Claude Code用のポータブルエンジニアリングシステム：フック、専門エージェント、自己改善機能を搭載

Claude Codeに繰り返し指示を出すことにうんざりしたある開発者が、~/.claude/に常駐し、すべてのプロジェクトに自動的に適用されるポータブルなエンジニアリングシステムを構築しました。このシステムは、2つの核心的な問題に対処します：Claude Codeが数日後に同じバグに遭遇し、最初から解決するという繰り返しのループ、および1つのプロジェクトで洗練されたルールが別のプロジェクトには存在しないというクロスプロジェクトの断絶です。

システム構成要素

このシステムには、いくつかの重要な構成要素が含まれています：

• 憲法 (CLAUDE.md) – 価値階層、意思決定境界、およびタスクの複雑さに応じた3つの実行モードを含む、650行のルール
• ルールを決定論的に強制するフック – AIが無視するかもしれない提案ではなく、強制プッシュ、誤ったパッケージマネージャーの使用、rm -rfなどの危険なコマンドを物理的にブロックするbashスクリプト
• 3つの専門エージェント – 委任するが決してコーディングしないオーケストレーター、リポジトリの隔離されたコピーで作業するビルダー、そして修正できない（報告のみ可能な）読み取り専用レビュアー
• スキルパイプライン – 計画から構築、出荷、本番環境への展開まで、ほとんど自律的に進行しますが、唯一の非交渉可能なゲートがあります：本番環境へのデプロイは常に確認を求めます
• 免疫システム – すべてのエラーは、根本原因と失敗したアプローチの両方と共に記録されます。2つ以上のプロジェクトで同じバグが発生すると、それは恒久的なルールとなり、抗体を発達させます
• アンチ・グッドハート検証 – 「すべてのテストが合格する」ことはアプリが機能することを意味しないため、すべてのエージェントが「完了」と主張する前に答えなければならない5つの質問

複合エンジニアリングアプローチ

このシステムは、複合エンジニアリングに基づいて構築されています：計画 → 作業 → レビュー → 複合。その4番目のステップは、システムが自己改善する場所です。開発者は、以前は毎日繰り返さなければならなかった特定のルールに言及しています：「npmではなくpnpmを使用する」、「合格したテストを削除しない」、「コミット前にテストを実行する」などです。

このプロジェクトはオープンソースで、https://github.com/vinicius91carvalho/.claude にあり、すべての15の構成要素の完全なウォークスルーは https://tail-f-thoughts.hashnode.dev/self-improving-engineering-system-claude-code で利用可能です。