@event4u/agent Config

Agent Config — バッジ内の成果物数も含め、すべての主張を機械的に検証

_{集計方法 — 正規のカウンターは1つだけです。agent-config → update_counts --check がツリーから6項目すべてを再集計し、1つでも数が合わなければ CI を失敗させます。リンク先のディレクトリに表示されている数と異なる項目が2つあるため、推測に任せずここに明記します。Commands 211 はすべてのコマンドファイルを再帰的に数えたもので（リンク先のディレクトリ直下には62個あります）、Rules 122 はソースルールを数えたものです。一方、リンク先の投影には121個が含まれています。ルールのうち1つは休止状態で、投影されていません。Personas 29 にディレクトリの README は含まれません。数えているのはファイルとディレクトリであり、品質、有効化、採用状況を示すものではありません。}

30秒で試す — リポジトリ内の「完了」を、読み取り専用のサブエージェント1つで確認します。ほかにインストールするものはありません：この導入案内 ↓。カタログではなく、証拠から始めてください：event4u-app.github.io/agent-config/proof/。

この README に記載された公開情報はすべて機械的に検証されています — 自分で検証する。 根拠のない見出し数値が飛び交う市場において、この README は各主張を解決可能な証拠に結び付け、結び付けられなければビルド自体を失敗させます。

変更の影響範囲を確認する

agent-config code-graph map は、コード、データ、システム、インターフェース、ランタイム、デリバリー、履歴、ドメインのオフラインマップを agents/map/ に描画します。各情報には file:line が記録されているので、行動に移る前に読み直してください。ファイルを選ぶと、到達するすべての領域がハイライトされます。

その他のビュー

開発者・創業者・コンテンツ担当者・代理店・財務・運用担当者から、自分に合った使い方を選べます。パックを追加すれば、500個もの成果物をまとめて出すのではなく、目的に絞ったコマンドセットを利用できます。AI プロバイダーは自由に選べます。

スキル、コマンド、ガバナンスルールを網羅したライブラリに加え、意図に応じて適切なスキルを読み込む機能ルーターと、コンセンサスレビューを伴うマルチエージェントオーケストレーションを備えています。レイヤー全体は 20 種類のホストエージェントにコンパイルされます（検出された 23 種類のうち、3 種類はエクスポート専用です。Claude Code、Cursor、Augment、Cline、Windsurf、Copilot、Gemini CLI、Codex、Continue、Zed、JetBrains、Aider など）。常駐プロセスは、このリポジトリが 2026-08-27 に採用した監督ポリシーの下でのみ許可されます。これはルールであり、現在稼働中の何かを説明するものではありません。役割に応じた 6 つの導入経路を備え、単一のモデルやベンダーに縛られることなく、どのホストでも信頼できるチームメンバーとして利用できます。

30 秒で試す

# 1. Install — on a terminal with a display, the browser wizard launches
#    automatically; the same TypeScript installer runs the real install behind it.
npx -y @event4u/agent-config init

# 2. Pick your profile + tools in the wizard, click Finish.
#    (Writes ~/.event4u/agent-config/, ~/.claude/, ~/.cursor/, …)

# 3. First real task — agent refines, plans, verifies.
/work "your first real task"

または、まずサブエージェントを 1 つ、自分のリポジトリで試してみてください。

mkdir -p .claude/agents
curl -fsSL https://raw.githubusercontent.com/event4u-app/agent-config/main/docs/wedge/production-validator/production-validator.md \
  -o .claude/agents/production-validator.md
# then in Claude Code:  @production-validator check this branch is actually done

production-validator は読み取り専用です。リリース対象の経路上にあるモックやスタブを探し、実システムの証拠を求めます（機能の詳細）。 全機能を試すには、1 つのコマンドを実行するだけです — クイックスタート ↓。

---

何が違うのか

奥深さと規律を備え、自らが意図的に提供しないものについても率直に説明します。

• 奥深さを活かす自動ルーティング — 500 個もの成果物をコンテキストに詰め込むのではなく、意図に応じて適切なスキルを機能ルーターが読み込みます。
• あらゆるホストでのガバナンス — ルールを各ツールのネイティブ形式にコンパイルし、フックに対応したホストでは決定論的なランタイムフックを追加します。この設定領域における、ホストに依存しないガバナンスが強みです（ガバナンスの優位性 · ホストごとの適用）。
• 必要なものだけを削除 — 共有設定では専用キーのみを扱い、他のツールの設定には触れません。--purge を指定した場合も、アンカーではなく、自身が記録したファイルだけを削除します。
• パック単位のインストール — 有効なパックとその依存関係を書き込みます。それ以外のパックには到達可能性が求められます。

意図的に提供しないもの — 中核はガバナンスレイヤーであり、個別にオプトインできる組み込みエンジン（コードインテリジェンス、制御された到達可能性、セットアップ GUI、ベンチラボ）を備えています（組み込みエンジンの原則）。必須または常時稼働するデーモン、独立した状態データベース、自ら書き換えるメモリ、自動ビルドパイプラインはありません。 エンジンが必須になることはなく、測定された効果が確認されない限り、デフォルトで有効になることもありません。また、エンジンは起動したコマンドの終了とともに停止します。ループを実行するのはホストエージェントです。学習による変更はすべて人間がレビューします。同じレイヤーをさまざまなツールで利用できます。面倒を見るプロセスを増やさずに、機能を活用できます。

このプロジェクトの背景（正確な由来）。 スキル、ルール、ペルソナは、 TypeScript と PHP の実際の本番コードベースでの作業からまとめたものです。 ガバナンスの仕組みは技術スタックに依存しませんが、ドメイン固有の ヒューリスティクスは、実際に磨かれた領域で最も充実しています。他のスタックでの 対応状況は有望ではありますが、実証済みとまでは言えません。不足している点があれば、 ぜひお知らせください。

ホストごとの対応状況を詳しく確認するか、1 分で試せることをご覧ください。

プロフィールを選択 — 6 つの利用開始パス

agent-config setup は .agent-settings.yml に profile.id を書き込み、選択したプロフィールの最初の画面に移動します。各エクスペリエンスページには、対象ユーザー、最初に使うコマンドとスキル、パックとフロー、そして意図的に読み込まれないものについて、詳細がすべて記載されています。

プロフィール	対象ユーザー	エクスペリエンスページ
👩‍💻 developer	IC エンジニア	ページ
✍️ content_creator	ライター、ゴーストライター、マーケター	ページ
🚀 founder	個人事業主／創業初期の創業者	ページ
🏛 agency	複数のクライアントにサービスを提供する事業者	ページ
💼 finance	CFO／非常勤ファイナンス担当／FP&A	ページ
🛡 ops	RevOps、サポート、SRE 関連業務	ページ

どれを選べばよいかわからない場合 ウィザードで 8 つの選択肢から役割を 1 つ選ぶと、最も近いプロフィールに割り当てられます。信頼できる情報源は src/agent-src/profiles/ · スキーマは docs/contracts/profile-system.md · ソフトウェア以外の分野については user-types/（造園 · 金属加工 · トラック運送 — ソフトウェア以外の分野を参照）。

生のコマンドではなく、ワークフロー

コマンドを暗記する必要はありません — 作業の流れに沿って進めます。開発者の作業を最初から最後までカバーする 4 つのフローがあります。

フロー	ここから開始	作業の流れ
🔍 探索	/feature:plan · /research	調査 → 計画 → 見積もり → 改善。実装に着手する前に行います
🔨 実装	/work · /implement-ticket	計画 → 実装 → 検証 → コミット
🔎 レビュー	/review-changes · /judge	セルフレビュー → 判定 → 品質改善 → 脅威モデリング
🚢 デリバリー	/commit · /pr:create	段階的にコミット → PR を作成 → レビューに回答

各フローで組み合わせるスキルと標準的な手順については、docs/flows.mdを参照してください。

変更履歴 · 14.x へのアップグレード · 破壊的変更 · 最新リリース · ディスカッション

_{配布方法：npm install @event4u/agent-config。メジャーバージョンの更新はセマンティックバージョニングに従います。各リリースには### Breakingの項目が含まれます — すべてのメジャーバージョンはBREAKING_CHANGES.mdにまとめられています。}

---

クリエイティブパック — 映画のような AI 動画。 台本 → キャラクターの一貫性を保った画像 → 動きと音声のプロンプト → プロバイダーによるレンダリング → クリップの結合。コストを抑えるため、デフォルトで AIV_DRYRUN=true が設定されています。コンテンツ／クリエイターエクスペリエンスの主要機能であり、パッケージの看板機能ではなくなりました。/video:from-scriptを参照してください。

リーガルパック — 法的助言ではありません。 EU／DE リーガルパック（契約書／NDA／DPA のレビュー、トリアージ）は、調査および文書作成の補助のみを目的としています — 法的助言を提供するものでも、資格を持つ弁護士に代わるものでもなく、具体的な案件について依拠してはなりません。提供するのは一般的な情報と汎用テンプレートであり、個別案件の審査は行いません。使用前にLEGAL_NOTICE.mdをお読みください。

全カタログ — すべてのスキル、ルール、コマンド、ガイドライン： docs/catalog.md。中心となるのはエクスペリエンス（プロフィール＋パック）と、その背後にある豊富な機能です。

プロジェクトで使う

利用するリポジトリから実行します。npx でセットアップし、エージェントが スタックを把握して、作業をエンドツーエンドで完了します。新規インストールの場合は、 クイックスタートから始めてください。インストール済みの場合は、 サポート対象ツールで連携済みの AI を確認できます。 docs/featured-commands.mdには、エンドツーエンドの ワークフロー（/implement-ticket、/work、/commit、/pr:create）が記載されています。 詳しい説明は2 分間のデモをご覧ください。

インストールのスコープ。 マシンごとにスコープを1 つ選んでください。プロジェクトローカル（デフォルト。アプリケーションのリポジトリに推奨）またはユーザーグローバル（ツール用リポジトリ／dotfiles に推奨）です。インストーラーは、scope_guard の事前チェックによって、競合する 2 つ目のスコープを拒否します。詳細はdocs/contracts/install-scopes.mdをご覧ください。必要に応じて、bash src/scripts/cleanup_other_scope.sh --confirmでクリーンアップしてください。

実証する

主張を鵜呑みにせず、検証してください。 docs/proof.mdはソースから生成されます。主張と根拠の対応表（公開されているすべての主張は解決可能な参照先に紐付けられ、そうでなければ CI が失敗します）、パッケージが何も変更しなかった実行も含む、誠実な null ベンチマーク、そして新規チェックアウトで実行できる「自分で検証する」ブロックを掲載しています。ソースとのずれがあれば CI は失敗します。再現性こそが証拠です。 event4u-app.github.io/agent-config/proof/でご覧ください。比較の枠組みについてはdocs/us-vs-the-category.mdをご覧ください。 最新の計測結果：修正後のある 1 回のセッションでは、アドバイザリーコンテキストの注入により、言語ミラー違反が 555 件から 19 件に減少し、2 つのブロッキングガードはそれぞれ 8 件から 0 件、1 件から 0 件になりました。つまり、アドバイザリーは大幅に減少し、ブロッキングのみが解消されました。1 回のセッションでの事後的な読み取りにすぎないため、法則ではなく記録された事前情報です。

独自のスキルカタログを保守していますか？ ここで検索置換によるリスキン PR をブロックするアンチリスキンゲートは、あなたのカタログでも動作します。docs/anti-reskin-gate.mdをご覧ください。

監査を徹底しています。意思決定キーはagents/runtime/state/に保存されます。リプレイジャーナルはオプトインです（hooks.runtime_journal.enabled）。 コア原則では、4 つの不変条件を説明しています。

コントリビュート

パッケージ自体に取り組んでいますか？ 開発ではtask ciパイプライン、要件ではツールチェーン、メンテナー向けテレメトリー（オプトイン、デフォルトで無効）ではオプトインの測定ループについて説明しています。ソース・オブ・トゥルースのツリーは src/（src/skills、src/rules、src/agent-src/）です。.augment/やdist/agent-src/は手作業で編集しないでください。

セキュリティ。 脆弱性の開示ポリシー：SECURITY.md。脅威モデル：docs/threat-model.md。

---

クイックスタート

コマンドは1つです。検出結果に基づいて、インストール済みのAIツールが見つかり、あらかじめ選択されます。［完了］をクリックするまで、何も書き込まれません。YAMLを手作業で書く必要はありません。

この4つは構造的なものであり、お使いのマシンではなく、コードパスの特性です。所要時間はそうではありません。ネットワークやレジストリの遅延に大きく左右されます。CIでは、すべての umbrella 実行でインストールから doctor までの実時間を測定し、条件とともに公開します。これは約束ではなく、証拠として提示するものです。

コマンドは上記 ↑にあります。

ヘッドレス／CI： CI、非TTY、ヘッドレスホスト、またはCLIモードフラグが指定されている場合、init はGUIをスキップし、代わりに非対話型インストーラーを実行します。GUIとCLIは同じインストーラー（src/scripts/install.ts）を共有するため、どちらも同じ結果になります。フラグ、オプトアウトの全一覧、--dry-runについては、docs/wizard.md · gui-wizard § GUIをスキップする場合を参照してください。

特定のAIを選ぶ： --tools=claude-code,cursor,augment,…（任意のサブセット）。--guiを指定すると、TTYおよびヘッドレスのチェックを越えて、ループバックにバインドされたCSRF保護付きのピッカーを強制的に表示します。CI、AGENT_CONFIG_NO_UI、CLIモードフラグは上書きしません。これらのいずれかと併用すると、CLIインストールを黙って実行するのではなく、ゼロ以外の終了コードで終了します。

フックの適用状況を確認： npx @event4u/agent-config hooks:status（CIでは--strict、ツール連携では--format jsonを指定します）。

対象範囲（v2.5以降）： initが書き込むのはグローバル設定のみです — ~/.event4u/agent-config/、~/.claude/、~/.cursor/、…。プロジェクトツリーにはagents/overrides/のみが追加されます。--projectは、AGENT_CONFIG_DEV_MODE=1で有効化するメンテナー専用機能です（ADR-020、開発モード）。

v1.xから移行しますか？npx @event4u/agent-config migrate — docs/migration/v1-to-v2.md。

---

agent-configとは — そして、そうではないもの

コンテンツレイヤーです — スキル、ルール、コマンド、ガイドライン、ペルソナをnpm経由で配布し、サポート対象の各AIツールのネイティブな設定形式に投影します。スキルでは、パッケージ固有のフロントマターキーを含むSKILL.mdを使用します。

エージェントのランタイムではありません。エージェントループ、LLMディスパッチャー、ツールのオーケストレーションは、ホストツール（Claude Code、Augment、Cursor、Cline、Windsurf、Gemini CLI、Copilot）が引き続き担います。各ツール向けのプレイブック兼スタイルガイドと考えてください。置き換えではありません。

対象範囲内	対象範囲外
スキル、ルール、コマンド、ガイドライン、ペルソナ	エージェントループ／LLMディスパッチャー
マルチツールへの投影と集約パイプライン	パッケージ内部の実行エンジン
メモリヘルパー（memory-add、memory-promote）	ツール横断型の可観測性ダッシュボード
リンター、CI、JSON-Schemaに対するフロントマター検証（コントラクト）	ランタイムGUI／Webダッシュボード（読み取り専用のホストステータス行は該当しません）
引用と決定論的ヘルパーによるスキルのオーケストレーション	意見を持つ自動スキルリゾルバー（ユーザーに代わって判断するML／関連性ランキング）
プロファイルとパックによる、ユーザー主導の投影時フィルタリング（ADR-040）	ランタイムリゾルバー／デーモン（セッション中の切り替え — 条件付きで、6.0.0以降）

エージェントへの指示内容

デフォルトの動作	agent-configを使用した場合
推測して、確認せずに編集する	変更前にコードを分析する
プロジェクトの規約から逸脱する	検出されたスタックの規約に従う
テストを省略する、またはでっち上げる	プロジェクトのフレームワークでテストを書く
汎用的なコミットメッセージ	スコープとチケットへのリンクを含むConventional Commits
品質チェックを省略する	プロジェクトの品質パイプラインを実行し、報告されたエラーを修正する
背景情報なしでPRを作成する	Jira／Linear／GitHubの情報から構造化されたPRの説明を作成する
根拠なく「完了」と断言する	完了を報告する前に、実際に実行して検証する

2 分でわかるデモ — /implement-ticket

主要なコマンドです。チケットを固定された直線的なフローで最初から最後まで処理し、推測せず、曖昧さがあれば停止します。

/implement-ticket PROJ-123

エージェントは次の手順を実行します。

refine → memory → analyze → plan → implement → test → verify → report

• 受け入れ条件が曖昧な場合は、チケットを洗練します。
• 過去の決定事項、不変条件、インシデントについて、メモリに問い合わせます。
• 変更を計画します。ファイルに触れる前に、あなたが確認します。
• minimal-safe-diff と scope-control に従って実装します。ついでの編集は行いません。
• テストします（まず対象を絞ったテストを実行し、成功したら全テストを実行します）。
• 7 人の判定役（バグ、セキュリティ、テスト、品質、アーキテクチャ、仕様、過剰実装）を通じて差分をレビューします。
• 変更内容、判定結果、フォローアップを報告してから停止します。/commit と /pr:create は提案のみで、自動実行されることはありません。

曖昧な点があれば、番号付きの選択肢を示してフローを停止します。黙って推測することはありません。ペルソナは .agent-settings.yml（roles.active_role）で設定します。senior-engineer（デフォルト）、qa、または advisory（計画のみ）を指定できます。

→ コマンドリファレンス · フローの仕様

関連コマンド — /work（自由形式のプロンプト）

同じエンジンを使いますが、チケットは必要ありません。

/work add a CSV export endpoint to the audit-log controller

最初の処理でプロンプトを 5 つの観点から採点し、その範囲に応じて振り分けます。

範囲	スコア	動作
高	≥ 0.8	そのまま実行します。AC と前提条件はレポートに記載します
中	0.5–0.79	前提条件のレポートを表示して停止します。確認するか、編集してください
低	< 0.5	最も弱い観点について、1 つだけ確認の質問をして停止します

範囲の判定後は、/implement-ticket と同じフローです。自由形式の目標には /work を、チケットの内容には /implement-ticket を使います。

→ コマンドリファレンス · refine-prompt スキル

実行後： agent-config explain last を使うと、処理の経過（ルート · メモリ · 評議会 · 停止箇所 · プロバイダー）を再構成できます。読み取り専用で、個人情報を除去し、オフラインで実行できます。ドキュメント

プロダクト UI の作業フロー

UI に関する作業は、3 つの指示セットのいずれかに振り分けられます。ui（完全な監査→デザイン→適用→レビュー→調整→レポート）、ui-trivial（ファイル数 ≤ 1、行数 ≤ 5：適用→テスト→レポート）、mixed（バックエンド + UI：契約→UI→統合）。既存 UI の監査は必須のゲートです（[ui-audit-gate](dist/agent-src/rules/ui-audit-gate.md）。仕上げは最大 2 ラウンドで、アクセシビリティを優先します。スタックの検出結果に応じて、blade-livewire-flux / react-shadcn / vue / plain を選びます。

→ メンタルモデル（1 ページ） · フローの仕様

---

カスタマイズ

プロファイル — 読み込むガバナンスの量

安全性の最低ライン（非破壊のデフォルト · 推測する前に確認 · ユーザーと同じ言語を使う）は、セキュリティ境界ではなくガードレールとして、すべてのプロファイルに含まれています。プロファイルによって、ガイダンスが追加されます。

プロファイル	含まれるもの	選択する場面
minimal	必須の安全性の最低ラインのみ。最も低コストで高速です。	簡単な質問 · 使い捨てスクリプト · CI · トークン予算が限られている場合
balanced（デフォルト）	安全性の最低ライン + 日常的なガイダンス（妥当なデフォルト、レビューの促し、よくある落とし穴）。	日常の作業
full	通常はメンテナーだけが必要とする、まれなケース向けのルールも含め、すべてを読み込みます。	agent-config 自体の作業 · 監査 · 高忠実度のデモ

内部的には、カーネルのみ · カーネル + ティア 1 · カーネル + ティア 1 + ティア 2 です。詳細：rule-router · kernel-membership · 設定方法 →。

安定性： 全体の一覧は STABILITY.md をご覧ください。Work Engine（/work + /implement-ticket）：ベータ版。Runtime Dispatcher：安定版。Tool Adapters：実験的（full プロファイルのみ）。

.agent-user.md と Ghostwriter — 音声プリミティブ

プリミティブ	音声	開示
personas/*.md	レビューレンズ（内部批評）	該当なし
.agent-user.md（プロジェクトルート、gitignore 対象）	メンテナー自身の声 — /post-as:me	なし（あなたが著者です）
agents/reference/ghostwriter/<slug>.md（gitignore 対象）	公開されている著名人 — /post-as:ghostwriter	必須、削除不可のフッター

ユーザーファイルは対話形式で作成します：/agents user init（スキーマ）。Ghostwriter クラスター：/ghostwriter:fetch <url-or-name> は認証ゲートを実行します。私人は拒否され、ペイウォール対象／漏えい／DM のコンテンツはスキーマレベルで禁止されます。

Cloudflare でセルフホスト可能な MCP — ローカルインストール不要

スキル、コマンド、ルール、ガイドラインは、独自の Cloudflare Worker から MCP エンドポイントとして配信でき、任意の MCP クライアントから HTTP 経由でアクセスできます。認証モードは 2 種類です：public（デフォルト）と bearer-auth（オペレーターが任意で有効化、MCP-Token Wrangler シークレット）。

task mcp:cloud:login         # one-time, opens browser
task mcp:cloud:setup         # check → r2-create → r2-verify → whoami
task mcp:cloud:secret-put    # opt in to bearer-auth (recommended for private deploys)

→ オペレーター向けガイド：mcp-cloud-setup · クライアントごとの設定：mcp-client-config · エンドポイント：mcp-cloud-endpoints。

対象範囲 — Lite、Full ではありません。 Worker は、読み取り専用のガバナンス（スキル · コマンド · ルール · ガイドライン · コンテキスト）を MCP プロンプトおよびリソースとして、さらに小規模な読み取り専用ツール（memory_lookup、chat_history_read、list_*）を提供します。リポジトリのローカルスクリプト（リンター、監査、task ci、work-engine フック）は実行しません。これらを利用するには、クイックスタートに従ってローカルインストールする必要があります。

組み込みのローカル stdio サーバーはGlama MCP レジストリに掲載されています。すぐに使えるインストールではなく、ローカルのチェックアウトが必要です（ADR-067）。

デプロイ方針

形態	状況	方法
シングルユーザーワークスペース	✅ 現在利用可能	npx @event4u/agent-config init — 単一マシン、単一ユーザー。リモート同期なし
小規模チーム（3～10 人）	✅ 現在利用可能	共有 agents/overrides/ Git リポジトリ ＋ ナレッジ用の共有 NAS — コード変更も新しいサーバーも不要。手順：docs/deploy/small-team-recipe.md
組織モード（SSO · 集中ポリシー · チームコンテキスト · 内部コネクター）	⏸ 未着手	各形態の着手には、顧客の獲得、資金が確保された監査、メンテナーによる ADR が必要です。方針の根拠：docs/deploy/team-deployment-posture.md

組織モードの機能（SSO、集中ポリシー、OAuth コネクター、チームコンテキスト）は、顧客を獲得し、資金が確保されたセキュリティ監査が実施されるまで、設計上キャンセルされたままです。それまでは小規模チーム向けの手順がサポート対象です。各項目は team-deployment-posture に、キャンセル状態が維持される項目として記載されています。

---

ハーネスに関する留意事項

パッケージのバグのように見えるインストール／実行時の挙動のうち、パッケージ側では制御できず、ホストハーネスに起因するものが 3 種類あります。兄弟プラグインの名前空間、ToolSearch 経由で表示される遅延ツール、スコープをまたいだスキルの不整合です。診断とパッケージ側の対応については、docs/contracts/harness-expectations.md を参照してください。スキルが重複して表示された場合は、まず task probe:skills を実行してください。

サポート対象のツール

プロジェクトにインストール（npx）

ツール	ルール	スキル	コマンド	動作
Claude Code	✅	✅	✅	.claude/ を読み込みます
Cursor	✅	—	☑️	.cursor/rules/ と、AGENTS.md 経由でコマンドを読み込みます
Cline	✅	—	☑️	.clinerules/ と、AGENTS.md 経由でコマンドを読み込みます
Windsurf	✅	—	☑️	.windsurfrules と、AGENTS.md 経由でコマンドを読み込みます
Gemini CLI	✅	—	☑️	GEMINI.md を読み込みます
GitHub Copilot	✅	—	☑️	.github/copilot-instructions.md を読み込みます
Roo Code	✅	—	☑️	.roo/rules/*.md と AGENTS.md を自動検出します
Codex CLI	✅	—	☑️	AGENTS.md を自動検出します
Continue.dev	✅	—	☑️	.continue/rules/*.md と AGENTS.md を自動検出します
Aider	📌	—	—	.aider.conf.yml の read: で手動指定します
Augment（VSCode/IntelliJ）	📌	—	—	グローバルのみ。プロジェクトにはマーカーを書き込みます
Claude Desktop	📌	—	—	グローバルのみ

✅ ネイティブ   ☑️ テキスト参照（AGENTS.md 内。ネイティブのスラッシュコマンドとしては呼び出せません）   📌 マーカーのみ   — 利用不可

チーム内での再現性： init したすべてのツールは agents/installed-tools.lock（コミット済み、マシンによる管理）に記録されます。新しいチームメンバーはクローン後に npx @event4u/agent-config sync を実行します。CI では agent-config validate によって差分を検出します。スキーマ：installed-tools-manifest。

プラグインでインストール（オプション、グローバル）

ツール	インストール
Augment CLI · Copilot CLI	インストール → — ルール、スキル、コマンドを提供。マーケットプレイス経由で更新されます

Claude Code：マーケットプレイスプラグインは非推奨です（単一サーフェスモデル）。npx/npm によるファイル投影で、コンテンツと決定論的なフックを利用できるようになりました（agent-config global / upgrade によって、管理対象の ~/.claude/settings.json ブロックに登録されます）。そのため、プラグインはスキル／コマンドの一覧を重複させるだけで、Git SHA のスナップショットは気づかれないまま古くなります。既存のインストールを削除するには、claude plugin uninstall agent-config@event4u-agent-config を実行してください。agent-config doctor は重複するサーフェスを検出します。

agent-config upgrade（最新版）または agent-config refresh --global（同じバージョンを再インストール）でグローバルインストールを最新に保てます。agent-config doctor は、PATH に見つからないバイナリや、壊れたフックの接続を検出します。getting-started § 最新状態を保つ · トラブルシューティングを参照してください。

コマンドの概要

コマンド	説明
agent-config init	一度でインストールします。ブラウザーウィザード（推奨パスまたはステップごとの手順）を開きます
agent-config init --project	プロジェクトを初期化します。最小限の agents/ ブリッジと、管理対象の .gitignore ブロックを作成します
agent-config config	設定 GUI を開きます。グローバル設定ハブです（シンプル／詳細の各ティア、検索、デフォルトへのリセット）
agent-config config --project	プロジェクトの設定画面を開きます
agent-config setup	ガイド付きオンボーディングウィザードを再実行します（現在の状態があらかじめ入力されます）
agent-config upgrade	グローバルインストールを最新リリースに更新し、設定を追加で同期します
agent-config doctor	読み取り専用の健全性／差分レポートを表示します

クラウド／ホスト型エージェント向けサーフェス

パッケージのスクリプトを実行できないプラットフォーム向けに、貼り付けまたはアップロード用の成果物を生成します。

• Linear AI（Codegen、Charlie、…）— dist/linear/{workspace,team,personal}.md
• Claude.ai Web Skills — dist/cloud/<skill>.zip

→ インストール →

---

agent-switch と連携

agent-switch は、1 台のマシンで複数のエージェントアカウントを実行するためのコンパニオン CLI です。各アカウントを独自のプロファイル（プロファイルごとの CLAUDE_CONFIG_DIR）に分離するため、アカウントを切り替える際にログアウトして再度ログインする必要はありません。2 つを組み合わせると、agent-switch がアカウントを分離し、agent-config が各アカウント内でエージェントが行うことを管理します。agent-config が agent-switch のプロファイル内で実行されると、設定ハブにその旨が表示され、共有ツリー（プロファイル間で共有されるツリー）に書き込む操作の前に警告が表示されます。また、ホストから指定された設定ルートを受け入れるため、agent-config 自身の設定もプロファイルごとに分離されます。

→ 2 つの連携方法 →

---

対象ユーザー

スタックに依存しないガバナンスコア（オーケストレーション · ロールモード · コマンドクラスター · 品質ゲート · 監査規律）に、スタック固有のスキルセットを組み合わせています。

スタック	対応範囲
Laravel · モダン PHP（最も充実）	Pest · PHPStan · Rector · ECS · Eloquent · Livewire/Flux · Horizon · Pulse · Reverb · Pennant
Symfony	symfony-workflow（DI · Doctrine · Messenger · voters · Twig）+ project-analysis
Next.js App Router	nextjs-patterns（RSC · Server Actions · キャッシュ · ルートハンドラー）+ UI react-shadcn
Zend / Laminas	project-analysis + 共通の PHP コーディング／品質スキル
React · Node / Express	project-analysis + UI react-shadcn
Vue · プレーン HTML	UI ディレクティブセット（vue / plain）
クロススタック	API 設計 · テスト · セキュリティ · データベース · Docker · Git · CI · レビュー · 脅威モデリング · オブザーバビリティ

ソフトウェア以外の分野

同じオーケストレーションコアを、user-types/ を通じてソフトウェア以外の職種でも利用できます。galabau-field-crew · metalworking-shop · truck-driver。独自のものもぜひ作成してください — 5 分で作成できるひな形。

---

データガバナンスとドメイン安全性

3 つのドメイン安全性ルール（domain-safety-pii、domain-safety-disclaimer、domain-safety-retention）が、約 12 の領域にわたってドメインごとの出力基準として機能します — PII のマスキング（サポート／財務／採用／マーケティング）、アドバイスに関する免責事項（法務／財務／医療／コンサルティング）、保持ガイダンス（財務／サポート）、運用上の基準（ロギング／エクスポート）。対象範囲 → ルール → 基準の全マトリクス： docs/safety.md。ベータ版の契約： memory-visibility-v1 · decision-trace-v1。

コードの来歴とライセンスガバナンス

すべての差分は、対象リポジトリで検出されたライセンスから導出されるライセンスポリシー（優先順位に従って適用し、情報源間で不一致があれば推測せずエスカレーション）と、借用台帳に対する厳格なリンター（provenance/borrows.jsonl → docs/THIRD-PARTY-NOTICES.md）によってチェックされます。禁止クラスまたは不明なライセンス、変換に関する注記の欠落、またはファイル名の変更しか記載していない注記がある場合、チェックは失敗します。これらのチェックは ci/ci-strict に組み込まれています。license-compliance-audit は、必要に応じて人間が実行する類似性スキャンであり、パイプラインから実行されることはありません。これは、監査可能な履歴を備えた、来歴に基づく借用規律であり、コピー検出ツールではありません。

対象範囲と制限

• 学習データからの無意識な再現は、このレイヤーでは検出できません。 ここにあるツールも、ほかのどこにあるツールも、モデルの学習データに何が含まれていたかを確認することはできません。このシステムが管理するのは、意識的に借用して記録する内容であり、モデルがひそかに想起する内容ではありません。
• 検出機能がある場合も、既知の OSS のナレッジベースのみが対象です — これまでに存在したすべてのコードの一部にすぎず、モデルの学習コーパスではありません。
• CI 向けの検出ゲートはありません。 決定論的スキャナー（オフラインの jscpd ＋オンラインの SCANOSS）を構築し、固定した合成コーパスに対して測定しましたが、事前登録したしきい値を満たせませんでした（測定値：再現率 12/16、誤検出 2/12、SCANOSS のみでのリネーム検出再現率 0/8）。詳しくは docs/CLAIMS.md を参照してください。CI には助言目的であっても一切の形で組み込まれておらず、上記のオンデマンドスキルとしてのみ提供されています。
• リネームのみのロンダリングは、提供しているツールでも評価したツールでも検出できません。 台帳の変換メモチェックでは、リネームのみと記述されたメモは拒否しますが、記録されていないリネームのみのコピーは検出できません。

リスクを低減し、記録しますが、決して排除はしません。

メンテナー向けテレメトリー（オプトイン、デフォルトで無効）

/implement-ticket / /work で参照したスキル、ルール、コマンドをローカルのみに記録します。telemetry.artifact_engagement.enabled: true で有効にできます。プロジェクト内に JSONL を保存し、アップロードは行いません。レポート：npx @event4u/agent-config telemetry:report。

コンテキストに応じたコマンドの提案

コマンドの目的に合致するプロンプト（「チケット ABC-123 を実装して」→ /implement-ticket）が、番号付きの選択肢として提示されます — 自動実行は一切されません。会話ごとに無効にするには：/command-suggestion-off。設定：.agent-settings.yml の commands.suggestion.{enabled,blocklist,confidence_floor}。

---

基本原則

• 実装前に分析する — 推測や盲目的な編集はしません
• 実際に実行して検証する — 「動くはず」で済ませません
• 改善のために問い直す — エージェントは思考のパートナーであり、何でも肯定する存在ではありません
• 設計上、厳格にする — 柔軟性より品質を重視します
• 管理されたランタイム — 常駐プロセスには、監督、範囲を限定した書き込み、停止制御が必要です

---

ドキュメント

ドキュメント	内容
はじめに	初回実行、3 テストの体験、プロファイル、次のステップ
インストール	すべてのインストール方法、Composer/npm、オーケストレーターの詳細
アーキテクチャ	システムのレイヤー、コンテンツパイプライン、ツールのサポートマトリクス
カスタマイズ	オーバーライド、AGENTS.md、エージェント設定、コストプロファイル
品質と CI	リント、CI パイプライン、圧縮システム
移行	バージョンごとのアップグレード手順
ショーケース	その他の例と期待される動作

コンテンツを見る：すべてのコマンド · スキルカタログ · 完全なカタログ · llms.txt。

---

トラブルシューティング

インストールに関する問題が発生した場合は、まず agent-config doctor を実行してください。PATH にないバイナリ、バイナリとプラグインのバージョン不整合、古くなった孤立ファイル、マニフェストの問題を検出し、それぞれに一行の修正ヒントを表示します。

「ルール／フック X が実行されなかったのはなぜか？」という疑問には、agent-config routing:doctor を実行してください。読み取り専用のライブ診断により、すべてのセッション開始ゲートが、該当する懸念事項の理由とともに ACTIVE/INACTIVE として報告されます（例：session-canary: ACTIVE for "Alex" と INACTIVE — no name on any settings layer）。プラットフォームの懸念事項チェーン、ホストのフック登録、ルーターとプロジェクションの最新状態も確認できます。より詳しいフック内部の情報（フェイルオープン／フェイルクローズの動作、懸念事項ごとの最新ディスパッチャーフィードバック）については、agent-config hooks:doctor を実行してください。

アップグレードや古さに関する症状 — アップグレード後にコマンドやスキルが見つからない、スキルが二重に表示される、アップグレードが中断された、command not found が表示される、プロジェクトファイルが古いままになっている場合：docs/troubleshooting.md § アップグレードと古さ。

---

開発

パッケージ自体を開発していますか？src/（信頼できる唯一の情報源である src/skills、src/rules、src/agent-src/）を編集し、ツリーを再生成してください。

task sync             # regenerate dist/agent-src/ and .augment/
task generate-tools   # regenerate .claude/, .cursor/, .clinerules/, .windsurfrules
task ci               # full pipeline — green before PR
task test             # unit + integration tests
task dev:setup        # boot the onboarding wizard against the working tree

ソースチェックアウトから CLI を実行する場合： ./agent-config <command>（リポジトリのルートにあるメンテナー用シム → scripts/agent-config → dist/cli/agent-config.js）。ソースリポジトリでは、事前に npm link を実行していないと npx @event4u/agent-config は解決されません。node_modules/.bin/agent-config のシンボリックリンクが存在しないためです。代わりに ./agent-config を使用してください。dist/cli/agent-config.js がない場合は、npm run build:cli で TS バイナリをビルドしてください。

→ プロジェクトの全体構成とコマンドについては、docs/development.md · CONTRIBUTING.md を参照してください。技術スタック：CLI、UI、ビルド／リンタースクリプトを含め、すべて TypeScript です。MCP レジストリのペイロードは dist/mcp/ に出力されます（提出チェックリスト）。

---

要件

• Node ≥ 22.6 — npx @event4u/agent-config init が標準的なインストール方法です。インストール手順に Python は一切含まれません（TypeScript への移行に伴い、Python インストーラーは廃止されました）。
• プラットフォーム： macOS 12.3 以降、Linux、WSL2。Git Bash でシンボリックリンクを使うには、開発者モードが必要です。.augment/ を再ビルドするコントリビューターは Task も必要です。

Windows

ネイティブの PowerShell／cmd はファイルのインストールには対応していません。インストール済みのツリー全体を使うには WSL2 を使用してください。ネイティブ Windows でサポートされるのはMCP stdio サーバーです。任意の MCP クライアントから次を指定してください。

npx -y @event4u/agent-config mcp-server

ガバナンスコンテンツ（プロンプト、リソース、ツール）は、ファイルをインストールしなくても利用できます。bash ディスパッチャーのネイティブ Windows への移植は、需要が条件です。WSL2 も MCP 経由の方法も使えないとする Windows の導入者が名乗り出た場合に、再検討します（agents/roadmaps/ の「信頼できるインストールへの道」フェーズ 3 を参照）。

資金援助

このパッケージは無料で、MIT ライセンスのままです。有料プランもデュアルライセンスもありません。時間の節約になり、支援したいと思われた場合は、リポジトリ上部にある GitHub Sponsor ボタンからご支援ください。そうでない場合も、どうぞそのままお使いください。ここにある機能は、支援の有無にかかわらずすべて利用できます。

ライセンス

MIT。

mcp-name: io.github.event4u-app/agent-config