everything-claude-code-エージェントハーネス最適化システム

2026-03-30

整理日: 2026-03-23

基本情報

種類: GitHubリポジトリ
作者: affaan-m（Anthropicハッカソン優勝）
ソース: https://github.com/affaan-m/everything-claude-code
規模: 28エージェント、125スキル、60コマンド、50K+ スター

概要

Claude Code を「ただ使う」から「システムとして動かす」レベルに引き上げるための設計集。Claude本体はオーケストレーターとして振る舞い、コードレビュー・セキュリティ監査・ビルドエラー解決などは専門エージェントに委譲する。

核心的な学び

計画先行が絶対原則 — /plan コマンドはユーザーの明示的な承認なしにコードを1行も書かない。「書く前に計画→承認→実装」がワークフローの基本形
エージェント委譲パターン — Claude本体が何でもやろうとせず、専門エージェント（planner, security-reviewer, tdd-guide等28種）に委譲する設計
フックによる自動化の5段階 — PreToolUse → PostToolUse → Stop → SessionStart/SessionEnd で品質チェックを自動化
メモリ管理の3構造 — 約50ツール呼び出しでコンテキスト圧縮提案、セッション跨ぎの状態自動保存、パターン抽出→インスティンクト化
セキュリティ義務チェックリスト — ハードコードシークレット禁止・SQLインジェクション防止・XSS防止がCLAUDE.mdレベルで明文化
ファイルサイズ規律 — ファイル200-400行（最大800行）、関数50行以下、ネスト深さ4段階以下
テスト駆動の数値基準 — カバレッジ80%以上をCLAUDE.mdに明記

構造図

flowchart TD
    A["計画先行が絶対原則"]
    A --> B["エージェント委譲パターン"]
    B --> C["メモリ管理の3構造"]
    C --> D["セキュリティ義務チェックリスト"]
    D --> E["テスト駆動の数値基準"]
    E --> F["テスト駆動の数値基準 — カバレッジ80%以上をCLAU.."]
    style F fill:#c05746,color:#fff,stroke:none

要約

このリポジトリはClaude Codeを「ただ使う」から「システムとして動かす」レベルに引き上げるための設計集だ。中心的なコンセプトは「エージェントに委譲する」こと。Claude本体はオーケストレーターとして振る舞い、コードレビュー・セキュリティ監査・ビルドエラー解決などは専門エージェントが担う。

特に実用的なのがフックシステムで、コマンド実行前後・セッション開始終了に自動処理を挟める。「Prettierの自動整形」「TypeScriptエラーチェック」「console.log検出」「セッション状態のSQLite保存」などをフックで自動化し、手動の品質チェックを省力化できる。

CLAUDE.mdの設計も参考になる。スタイルルール・セキュリティ義務・テスト基準を数値付きで明文化し、エージェントが迷わない状態を作っている。メモリ管理への意識も高く、50ツール呼び出しごとのコンテキスト圧縮提案やセッション間の状態引き継ぎまでフックで自動化している。

主要ファイル構成

| カテゴリ | 内容 | 数 | |---|---|---| | agents/ | 特化サブエージェント（planner, architect, security-reviewer等） | 28個 | | skills/ | ワークフロー定義・ドメイン知識 | 125個 | | commands/ | スラッシュコマンド（/plan, /tdd, /code-review等） | 60以上 | | hooks/hooks.json | ライフサイクル自動化フック | 1ファイル | | examples/CLAUDE.md | CLAUDE.mdのテンプレート | 1ファイル |

kodachanへの適用

CLAUDE.mdにセキュリティチェックリストを追加 — 「コミット前必須確認」として「ハードコードシークレット確認・環境変数チェック」を入れる
/planパターン — 新しいプロジェクトや機能を作るときは「要件・リスク・フェーズ」を書き出してから承認を得るルーチンに
フックの概念 — 「50回ツール呼び出ししたらコンパクションを提案する」ルールをCLAUDE.mdに追記
ファイルサイズ規律 — 開発プロジェクトのCLAUDE.mdに「ファイル最大400行・関数最大50行」を入れる

今週やるアクション

[ ] CLAUDE.mdにセキュリティチェックリストを追加
[ ] /planパターンを新規プロジェクト開始時のルーチンとしてCLAUDE.mdに追記

基本情報

概要

核心的な学び

構造図

要約

主要ファイル構成

kodachanへの適用

今週やるアクション

関連ノート