3
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Everything Claude Code(ECC)入門:ルール・スキル・フックで開発環境を整える

3
Posted at

はじめに

Claude Codeで開発を進めていると、プロジェクトの決まりを毎回伝える場面があります。

「既存の実装パターンを確認してから変更してほしい」
「不具合を直すときは、再現するテストも残してほしい」
「レビューでは、認証や権限制御も確認してほしい」

こうした指示を、日々の開発で参照できる形に整理する選択肢が、**Everything Claude Code(ECC)**です。

新しいメンバーに業務マニュアルを渡すように、開発のルールや作業手順を用意し、計画、実装、レビューなどの役割を分けられます。

この記事では、Claude Codeで使う場合を中心に、ECCの構成と導入方法、各機能の使い分けを紹介します。

本記事は、2026年11月16日に確認した公式リポジトリとClaude Code公式ドキュメントをもとにしています。掲載した設定・コードのうち「作例」と記載したものは、説明用に作成したものです。

Everything Claude Codeとは

Everything Claude Codeは、Affaan Mustafa氏が公開している、コーディングエージェント向けのOSSプロジェクトです。現在のリポジトリ名は ECC、Claude Code向けのプラグイン識別子は ecc@ecc です。12

公式リポジトリ:affaan-m/ECC

専門エージェント、作業手順としてのスキル、開発ルール、イベントに応じたフック、MCPの設定例などがまとまっています。

例えば、日々の開発で次のように使い分けられます。

  • 機能を追加する前に、計画を作る
  • 実装時に、既存の規約やテスト手順を参照する
  • 変更後に、別のエージェントへレビューを依頼する
  • ファイル編集後に、決めたチェックを実行する

用意された内容を読み、プロジェクトに必要なものを選んで取り入れるのが、使い始めるときの基本です。

全体の構成を把握する

最初に、主なディレクトリの役割を整理します。

ディレクトリ 主な役割
agents/ 計画、設計、レビューなどの専門エージェント
skills/ 作業手順や分野ごとの知識
commands/ 維持されているスラッシュコマンドの入口
legacy-command-shims/ 旧コマンド名向けの互換ファイル
rules/ コード規約、テスト、Git運用などの指針
hooks/ イベントに応じた自動処理の設定
contexts/ 開発・調査・レビュー向けのコンテキスト例
mcp-configs/ 外部ツールと連携するためのMCP設定例
examples/ CLAUDE.md などの設定例
.claude-plugin/ プラグインの配布用メタデータ

役割を覚えるときは、次のように考えると整理しやすくなります。

Rulesは「守ってほしい基準」、Skillsは「作業の進め方」、Agentsは「作業を任せる役割」、Hooksは「イベントに応じて実行する処理」です。

なお、現在のECCはSkillsを主要なワークフローの入口としています。古い紹介記事にあるコマンドが、そのまま標準で使えるとは限らないため、導入した環境の一覧も確認します。3

まずはプラグインを導入する

以下は、Claude Code、Git、Node.jsを利用できる環境を前提にしています。

1. Claude Codeの会話画面でインストールする

Claude Codeの会話画面で、次を実行します。

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

現在の公式READMEに記載されている、ネイティブプラグイン経由の導入方法です。2

プラグインの状態は、次のコマンドで確認できます。

/plugin list ecc@ecc

プラグイン経由で導入した場合は、同じClaude Code環境へフル手動インストールを重ねないようにします。 スキルやフックが重複する原因になるためです。2

2. 必要なRulesを追加する

公式READMEでは、Rulesはプラグインと別に配置する手順になっています。

以下は、macOS・Linux・WSLなどのBash環境で、共通ルールとTypeScript向けルールをユーザーレベルに配置する例です。

git clone https://github.com/affaan-m/ECC.git
cd ECC

mkdir -p "$HOME/.claude/rules/ecc"
cp -R rules/common "$HOME/.claude/rules/ecc/"
cp -R rules/typescript "$HOME/.claude/rules/ecc/"

Pythonを使う場合は、必要に応じて rules/python を選びます。

ルールはディレクトリごとコピーします。 共通ルールと言語別ルールには同名のファイルがあるため、ファイルを一つの場所へ平らに集めると、上書きや相対参照の問題が起こります。4

特定のプロジェクトだけに適用したい場合は、そのプロジェクトの .claude/rules/ecc/ に配置します。ユーザーレベルに置く内容と、プロジェクト固有の内容を分けておくと運用しやすくなります。

Agents:専門の役割に作業を任せる

エージェントは、特定の仕事に集中するための役割定義です。

ECCには、例えば次のようなエージェントがあります。

エージェント 主な役割
planner 要件や既存コードを確認し、実装計画を作る
architect システム構成や設計方針を検討する
tdd-guide テスト駆動開発の進め方を支援する
code-reviewer コード品質や変更の問題点を確認する
security-reviewer 認証、入力検証、秘密情報などを確認する
build-error-resolver ビルドエラーの原因を調べる
e2e-runner E2Eテストを扱う
refactor-cleaner 不要コードの整理やリファクタリングを支援する
doc-updater 実装に合わせてドキュメントを更新する

利用場面と対応する役割は、公式のコマンドリファレンスでも確認できます。3

Claude Codeのサブエージェントは、それぞれのコンテキストで作業できます。調査やレビューを分担すると、メインの会話で扱う情報を整理しやすくなります。5

エージェント定義の読み方

次は、読み取り中心のレビュー役を定義する作例です。

---
name: project-reviewer
description: 変更内容を確認し、根拠を添えて問題点を報告する
tools: Read, Grep, Glob
model: inherit
---

変更内容と関連する実装を確認してください。
指摘には対象箇所と理由を添えてください。

name は識別名、description は役割や使用場面の説明です。

tools では利用できるツールを絞り、model では使用するモデルを指定します。この例の inherit は、親の会話で使っているモデルを引き継ぐ指定です。5

役割を分ける際は、何を調べて、どのような結果を返してほしいかも具体的にしておくと、依頼の範囲が伝わりやすくなります。

SkillsとCommands:繰り返す作業を手順にする

Skillsには、特定の作業を進めるための手順や、参照する知識をまとめます。

Claude Codeでは、SKILL.md に概要と手順を書き、詳細な資料やスクリプトを別ファイルとして添えることもできます。通常のセッションではスキルの説明を参照し、使用時に本文を読み込む仕組みです。6

ECCには、テスト、フロントエンド、バックエンド、セキュリティなど、さまざまな分野のスキルがあります。

コマンド名は導入した版で確認する

プラグイン経由で実装計画を依頼する場合は、次のような名前空間付きの形式を使います。

/ecc:plan "在庫一覧に、商品名とJANコードによる検索を追加したい"

現在のコマンドリファレンスでは、旧 /tdd は tdd-workflow、旧 /e2e は e2e-testing などのスキルに対応付けられています。旧名を使うための互換ファイルは、必要な場合に選ぶ扱いです。3

記事や設定例を参考にするときは、実際にインストールされたスキルとコマンドも確認します。

TDDの手順を共有する

tdd-workflow では、次の流れを扱います。

  1. RED:期待する挙動をテストにし、失敗することを確認する
  2. GREEN:テストが通るように実装する
  3. REFACTOR:テストを維持しながら構造を改善する

ECCのスキルには、カバレッジ80%以上という目標や、失敗・成功を確認した証拠を残す手順も含まれています。7

この数値は、ECCで用意された開発方針の一つです。プロジェクトに導入するときは、採用するテスト基準を決め、テストランナーやCIにも反映します。

カバレッジの数値と合わせて、重要な業務条件や異常系が確認できているかも見ておきたいところです。

Rules:プロジェクトの基準を言語化する

Rulesには、コードの書き方、エラー処理、テスト、Git運用などの指針をまとめます。

ECCでは、共通の rules/common/ と、TypeScriptやPythonなどの言語別ルールを組み合わせます。共通の基準に、言語ごとの慣習やツールを加える構成です。4

ここで押さえておきたいのは、文章で渡すルールと、機械的に判定する設定は役割が異なるという点です。

Claude Codeは CLAUDE.md などの指示をコンテキストとして読みます。確実な操作制限には権限設定、コードの判定にはLint・型チェック・テストなどを組み合わせます。8

例えば、「変更後はテストを実行する」と書く場合でも、何を実行するかまで具体化したほうが確認しやすくなります。

次は、Next.jsとTypeScriptを使うプロジェクト向けの CLAUDE.md の作例です。コマンドは、対象プロジェクトの package.json に合わせて調整します。

# プロジェクト概要

会員管理用のWebアプリケーション。
TypeScriptとNext.jsを使用する。

## 開発方針

- 変更前に、関連する既存の実装とテストを確認する。
- 認証と権限制御は、既存の共通処理を再利用する。
- 不具合修正では、再現条件と回帰テストを残す。
- APIキーなどの秘密情報をソースコードに含めない。

## 変更後の確認

- npm run lint
- npm run typecheck
- npm test

実行したコマンドと結果を報告する。
実行できなかった確認には、その理由を添える。

「きれいなコードを書く」といった抽象的な表現より、作業の内容や結果を確認できる指示にすると、レビューの基準もそろえやすくなります。

Hooks:イベントに応じた処理を実行する

Hooksは、Claude Codeで特定のイベントが発生したときに処理を実行する仕組みです。

代表的なイベントは次のとおりです。9

イベント 発生するタイミング
PreToolUse ツール実行前
PostToolUse ツールの正常実行後
SessionStart セッション開始時
PreCompact コンテキストの圧縮前
Stop Claudeが応答を終えようとするとき
SessionEnd セッション終了時

Stop と SessionEnd は別のイベントなので、どちらを使うかは処理の目的に合わせます。

プラグインが管理するECCのフックは、導入経路に従って読み込みます。プラグイン導入後に同じ hooks.json を設定へコピーすると、処理が重複する原因になります。2

作例:編集したファイルのconsole.logを確認する

現在の形式では、ツールを対象にする matcher に Edit|Write などを指定します。ファイルパスは、フックが受け取るJSONから取得できます。9

以下は、プロジェクト独自のフックを追加する作例です。

既存の .claude/settings.json がある場合は、その内容を保って hooks の設定を統合してください。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "node \"$CLAUDE_PROJECT_DIR/scripts/check-console.cjs\""
          }
        ]
      }
    ]
  }
}

次に、プロジェクト内へ scripts/check-console.cjs を用意します。この作例はNode.jsの標準モジュールだけを使います。

const fs = require("node:fs");

let input = "";

process.stdin.setEncoding("utf8");
process.stdin.on("data", (chunk) => {
  input += chunk;
});

process.stdin.on("end", () => {
  const event = JSON.parse(input);
  const filePath = event.tool_input?.file_path;

  if (!filePath || !/\.(js|jsx|ts|tsx)$/.test(filePath)) return;

  const source = fs.readFileSync(filePath, "utf8");

  if (source.includes("console.log")) {
    process.stdout.write(JSON.stringify({
      hookSpecificOutput: {
        hookEventName: "PostToolUse",
        additionalContext:
          "編集したファイルに console.log があります。用途を確認してください。",
      },
    }));
  }
});

対象ファイルに console.log があれば、Claudeへ確認用のコンテキストを返します。

文字列を検出する小さな作例なので、コメント内の記述も対象になります。実際のコード規約の判定には、プロジェクトで使っているLintなどを組み合わせるとよいでしょう。

MCP:必要な外部ツールとつなぐ

MCPは、Claude Codeから外部のツールやデータへ接続するための仕組みです。

ECCの mcp-configs/ には、GitHubやデータベースなどとの連携に使う設定例があります。各サービスの認証や、必要なツールの有効化は、利用する環境に合わせて行います。10

導入するときは、作業に必要な接続から追加します。例えば、IssueやPRを扱うならGitHub、データを確認するなら対象データベース、という選び方です。

ツール定義によるコンテキストの使用量は、ツール数や定義の大きさ、Tool Searchなどの読み込み方法によって変わります。固定のサーバー数やトークン数だけで判断せず、/mcp などで利用状態を確認します。11

認証情報は環境変数などから読み込み、共有する設定と秘密情報を分けて管理します。

Contexts・Examples・継続学習の役割

ここまでの機能に加え、作業の進め方を調整するための設定やサンプルもあります。

contexts/ には、開発、調査、レビューといった目的別のコンテキスト例があります。必要な場面で指示として読み込ませ、調査では理解を深めること、レビューでは変更の問題点を確認することに焦点を合わせます。2

examples/ の CLAUDE.md などは、プロジェクトの説明や開発方針を整理するときの参考になります。

また、継続学習の仕組みでは、ユーザーからの修正、エラー解決、繰り返された作業などのパターンを記録して再利用します。continuous-learning-v2 では、小さな行動パターンを「instinct」として扱い、根拠や適用範囲を持たせています。12

プロジェクト特有の決まりは、そのプロジェクトに限定して残すなど、どこで再利用する知識なのかも意識しておくと整理しやすくなります。

実務では「計画・実装・確認」を一度つなげてみる

最初は、小さな機能を一つ選び、計画から確認まで進めてみると、各機能の役割を把握しやすくなります。

例えば、在庫一覧に検索を追加する場合を考えます。

1. 計画を作る

/ecc:plan "在庫一覧に、商品名の部分一致検索とJANコードの完全一致検索を追加したい"

計画を読むときは、空欄の場合の動作、0件の場合の表示、既存のページ分割との関係も確認します。

2. テストと実装を進める

次に、自然言語で作業手順と確認してほしい内容を指定します。

tdd-workflowを使って、確認した計画に沿って実装してください。

商品名の部分一致、JANコードの完全一致、検索結果が0件の場合を
テストで確認してください。

変更後は、プロジェクトで定義したLint・型チェック・テストを実行し、
実行した内容と結果を報告してください。

3. 変更内容をレビューする

/ecc:code-review

レビュー結果では、指摘の根拠に加え、計画した条件が実装とテストに反映されているかを見ます。

この一連の作業で、Rulesがどの基準を伝え、Skillsがどう手順を支え、Agentsがどの役割を担当したかを確認できます。

おわりに

Everything Claude Codeは、Claude Codeへ渡すルールや作業手順、役割分担、自動処理を整理するときに参考になるプロジェクトです。

使い始める際は、共通ルールと必要な言語のルールを読み、小さな機能で計画・実装・確認を進めてみてください。

その結果を見ながら、よく繰り返す指示をRulesやSkillsに整理し、毎回実行したい処理をHooksへ加えていくと、プロジェクトに合った開発環境へ調整しやすくなります。

参考資料

  1. ECC:プラグイン定義 ↩

  2. ECC:公式README ↩ ↩2 ↩3 ↩4 ↩5

  3. ECC:Commands Quick Reference ↩ ↩2 ↩3

  4. ECC:Rulesの構成と導入 ↩ ↩2

  5. Claude Code:Create custom subagents ↩ ↩2

  6. Claude Code:Extend Claude with skills ↩

  7. ECC:tdd-workflow ↩

  8. Claude Code:How Claude remembers your project ↩

  9. Claude Code:Hooks reference ↩ ↩2

  10. ECC:MCP設定例 ↩

  11. Claude Code:Connect Claude Code to tools via MCP ↩

  12. ECC:continuous-learning-v2 ↩

3
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
3
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?