結論(先に)
- ECC = Agent ハーネス向け OSS:246+ Skills、61 Agents、Hooks 記憶、AgentShield — MIT。
- 数本の Cursor Rules とは違い research-first、eval-harness、セッション横断記憶、監査可能なインストール。
- Claude Code / Cursor / Codex 等に対応するが インストール経路の二重化禁止——Hook 重複が最大の遅延原因。
- 個人は
minimal+ 厳選 Skills;チームは Hook 方針を決めてから 2 週間 PoC。 - ECC は「書き方」、クラウド Mac は「どこでビルドするか」——並列 Agent 節参照。

1. Star 数に踊らない:ECC が解く痛みは何か
多くの人が ECC を入れる理由は「みんな入れているから」。より実用的な問い:Claude Code / Cursor に欠けているのは IQ か、プロセスか? 毎回プロジェクトを説明し直す、マージに自信がない、Hook がターミナルを遅くする——なら ECC に余地がある。たまに 2 行スクリプトを聞くだけなら、数本のプロジェクト Rules で十分。
affaan-m/ECC は agent harness performance optimization system——ハーネス(Claude Code プラグイン、Cursor Skills、Codex AGENTS.md)を対象にし、別のチャット API ではない。Affaan Mustafa 氏が Anthropic Hackathon 受賞後、約 10 か月の本番設定を MIT で公開。以下の数は clone 時の README 準拠:
- Skills(約 246):
SKILL.mdワークフロー単位。パッシブトリガーと Agent 再利用。新機能は Skills 優先; - Agents(約 61):レビュー・ビルド修復・多言語 Review など役割分担;
- Hooks:SessionStart/Stop スクリプトでセッション横断記憶、要約、ランタイムゲート;
- Rules:TS/Python/Go/Java 等、必要な言語だけ導入;
- MCP 設定、Commands(
legacy-command-shims/のレガシー slash)、AgentShield; - v2.0.0-rc.1:Hermes オペレータ叙事 +
ecc2/Rust 制御面(alpha、一般提供前)。
中国語の概要は README.zh-CN.md を読み、Agent を「なぜこう組むか」は作者の Shorthand Guide と Longform Guide(トークン最適化、並列 worktree、eval 検証ループ)で補完してください。
ライセンスと商用の境界:コアリポジトリは MIT で永久無料。ECC Pro(GitHub App、非公開リポジトリ監査などのホスト型サービス)や Sponsor は任意で、Pro がなくても OSS を先に試せます。
2. コアモジュール:Skills、Hooks、記憶、セキュリティ
2.1 Skills:ワークフローを第一級市民に
ECC は Skills を主工作面 に据え、Commands は保守・互換期に入り、旧 slash の shim は legacy-command-shims/ に置かれます。チーム規範を足すなら slash を増やすより skills/ を fork するのが正道です。
スキルの幅は広い:search-first(先に公式ドキュメント)、eval-harness(検証駆動)、Django/Spring Boot パターン、v2 のメディア・運用・予測市場リサーチパックなど。個人開発者ならスタックに合う 5–10 個の Skills が、--profile full の全量インストールより扱いやすいことが多いです。
2.2 Hooks と記憶:セッションが「忘れない」仕組み
Longform Guide が強調するのは、セッション終了時に要約し、SessionStart でコンテキストを復元する Hooks です。PRD の再貼り付けトークンを削減します。v1.8+ では ECC_HOOK_PROFILE=minimal|standard|strict と ECC_DISABLED_HOOKS により、ファイルを触らずにうるさい Hook だけ下げられます——「保存のたびにスクリプトが二重実行」する現場では必須です。
2.3 AgentShield と research-first の文化
セキュリティ向けに /security-scan と AgentShield(Security Guide、Agentic Security 短文)があり、サンドボックス、CVE、プロンプトインジェクションなどを扱います。文化として ECC は 実装前に調査 を推し、公式ドキュメントと検証を経て API を推測しません。 Mac レンタル・クラウド Mac 開通検収と同様、自動化の前に再現可能なビルドが前提です。
3. クロスハーネス:Claude Code、Cursor、Codex — 一つのパックか?
README は Claude Code、Codex、Cursor、OpenCode、Gemini CLI、Zed、GitHub Copilot などを列挙。ルートの .cursor/、.codex/、.claude/ は 同一 Skills/Rules のマルチ IDE マッピングであり、IDE ごとにバラバラなプロンプト置き場ではありません。
| 使うツール | ECC の置き場 | 実務ヒント |
|---|---|---|
| Claude Code | 公式 Plugin + install.sh | デフォルト経路;まず minimal か core profile |
| Cursor | .cursor/skills など | プロジェクト Rules と重複に注意;チームは AGENTS.md で揃える |
| OpenAI Codex CLI | AGENTS.md、.agents/skills/ | 既に Codex のリポ向け;/codex-setup を読む |
| Copilot のみ時々 | ドキュメント中心 | 全量 ECC の ROI は低め;無理に入れない |
v1.8 の /harness-audit、/quality-gate、/model-route は「ハーネスが健全か」をコマンド化したもの——導入 2 週間後に一度回し、初日から全開は避けてください。
4. インストールの落とし穴:「入れたら遅くなった」
Quick Start は太字で インストール経路は 1 つだけ——社交辞令ではありません。よくあるのは月曜にマーケットでワンクリック、水曜に同僚の「full が完全」で install.sh --profile full を再実行し、slash に /eval が二つ、保存のたび Hook が二重、コンテキストに謎の数千トークンが溜まるパターンです。遅いのは ECC ではなく二重インストールです。
Claude Code ユーザー向けの推奨手順:
- Plugin(marketplace)+ 必要な言語の rule ディレクトリだけコピー;または
- 手動:
./install.sh --profile minimal --target claude(Hook 不要なら minimal);ゲートが要れば--modules hooks-runtimeを追加。 - 迷ったら README どおり
npx ecc consult "security reviews" --target claudeでコンポーネントを先にプレビュー。
Windows は install.ps1。Hook は v1.7+ で Node.js スクリプトが多く、bash 限定失敗が減りました。壊れたら README の Reset/Uninstall から——コミュニティは GitHub Discussions、トラブルは TROUBLESHOOTING、貢献は CONTRIBUTING。
5. 入れる価値はあるか?まず自分に当てはめる
下の表は意思決定用の簡表です。5 分しかないなら表だけで十分。チームの PoC 案を書くなら第 6 節のクラウド Mac 分担まで読んでください。
| ロール / シナリオ | 判断 | 理由 |
|---|---|---|
| 個人フルスタック(Claude Code/Cursor 利用中) | 試す価値 | minimal + 10 前後の Skills で research-first と記憶 Hook を体感;MIT でロックインなし |
| 10 名以上のエンジニアチーム | PoC 後に慎重に全量 | インストール規約・Hook profile を統一し、個人の二重インストールを禁止;コードレビューと併用 |
| レガシー小スクリプトのみ | 任意 | 246 Skills のノイズが利益を上回りがち |
| iOS リリース + Xcode CI | 層分離 | ECC は macOS Runner の代替ではない;Agent 並列は クラウド Mac worktree ガイド |
| 厳格コンプライアンス(未知 Hook 禁止) | 先にセキュリティ審査 | SECURITY.md と AgentShield レポート;--without baseline:hooks も検討 |
ECC は Agent 工程化の土台として試す価値あり——README を読まず全量は非推奨。 Star は「極限まで Claude Code を使い込んだ設定が OSS 化された」承認であり、clone だけで 3 倍速にはならない。
6. クラウド Mac との関係:Agent はノート PC、ビルドはデータセンター
ECC は IDE/CLI 内の推論とプロセスを担い、xcodebuild、シミュレータ、公証、Keychain は macOS 実機に残ります。よくある組み合わせは次のとおりです。
- ローカルまたは Cursor で ECC がタスク分解・パッチ・PR を推進;
- クラウド Mac mini M4 で CI、並列 worktree、長時間
launchd(リモート Mac 定時 Agent FAQ); - リリース週は日払いで 16GB/24GB と Agent ピークを検証してから週/月契約へ。
ノート PC のフタを閉じても、クラウドの Hook が代わりに Xcode を回すわけではありません——だからハーネスとビルド機は分けるべきです。リース段階は クラウド Mac 調達ガイド を参照。共有 Mac VPS より M4 独占 ベアメタル が現実的です。
7. よくある質問
ECC と Cursor 標準 Rules は競合しますか? 重複し得ます。チームで「ECC 主」か「プロジェクト Rules 主」を決め、マージ前に /harness-audit か .cursor/ と ECC ディレクトリを diff してください。
ECC Pro の契約は必須ですか? 不要です。OSS は MIT;Pro は非公開リポ向け GitHub App などのホスト機能で、リポの Sponsor/Pro 説明を参照。
v2 の Hermes / ecc2 とは? rc.1 で Hermes オペレータ叙事と Rust の ecc2/ 制御面がツリーに入りました;本番は README 推奨の Plugin/手動インストールが基準で、ecc2 は alpha 扱いです。
更新はどう追いますか? GitHub Releases を Watch;大版本前はブランチで install-plan を試す(v1.9+ の選択的インストール)。
OpenClaw と同じですか? 違います。OpenClaw はゲートウェイ実行とプラグイン自動化寄り;ECC はコーディングハーネスの性能とエンジニアリング規範。併用は可能ですが層を分け、同一マシンでポート・MCP・Hook がリソースを奪い合わないようにしてください。
8. 参考・外部リンク
- リポジトリ:github.com/affaan-m/ECC
- 中文 README:README.zh-CN.md
- 貢献・セキュリティ:CONTRIBUTING · SECURITY · TROUBLESHOOTING
- コミュニティ:Discussions
- 作者ガイド(X): Shorthand · Longform
9. 結び
ECC (Everything Claude Code) は「Claude Code を使う」から「Agent ハーネスを統治する」へ進めます — Skills 化されたワークフロー、Hook による記憶、監査可能なインストールとセキュリティスキャン。個人は minimal + 厳選 Skills で research-first の習慣を;チームは Star 数での一括導入より 2 週間 PoC。iOS/macOS パイプラインなら、コーディングハーネスは IDE、ビルド環境はクラウド Mac — 日払いで xcodebuild を先に通し、その後に週/月契約で Agent 常駐を検討してください。
並列 Agent ビルド?クラウド Mac で Xcode を支える
kvmboot は M4 専用ベアメタルクラウド Macを SSH/VNC で提供 — worktree 農場、リモート Claude Code、リリース週のバーストに対応。Mac レンタルの日払いで RAM と並列度を先に検証し、問題なければ週/月へ。
プラン · worktree ガイド · ホーム