claude-settings
Claude Code と Codex CLI をどちらもメインで使えるエージェント設定テンプレート。Claude Code プラグイン（my-marketplace / my-plugin）として配布し、任意のプロジェクトに /plugin install 一発で道具箱（コマンド・スキル・フック・MCP）を導入できる。ルール類は /setup-project で各プロジェクトに展開する。
このリポジトリは マーケットプレイスそのもの（.claude-plugin/marketplace.json + plugins/my-plugin/）。配布対象はすべて plugins/my-plugin/ 配下にあり、ルートに設定ファイルは置かない。
ECC (affaan-m/ECC) のアイデアを取り込みつつ、最小構成で運用可能にしている。
目次
Quick Start
推奨: プラグインとして導入（任意のプロジェクトの Claude Code セッション内で）
# 1. マーケットプレイスを登録（初回のみ）
/plugin marketplace add Akira-nkjm/claude-settings
# 2. プラグインを入れる（道具箱 + codegraph MCP が全プロジェクト共通で有効に）
/plugin install my-plugin@my-marketplace
# 3. このプロジェクトにルール一式・Codex 機械を展開
/setup-project
その後、プロジェクト固有の 3 ファイルを埋める（/setup-project が対話で促す）:
$EDITOR .claude/rules/project.md # 概要・スタック・規約
$EDITOR .claude/rules/architecture.md # データフロー・設計判断
$EDITOR .claude/rules/commands.md # セットアップ・テスト・ビルド
CodeGraph を使うなら初回だけ index を作る（任意）:
just -f .claude/justfile codegraph-init
主要コマンド早見表（プラグイン導入後）:
| やりたいこと | コマンド |
|---|
| ルール一式・Codex 機械を展開／更新 | /setup-project（--force で全上書き、--no-codex で Codex 省略） |
| 道具箱を最新化 | /plugin update（全プロジェクトに反映） |
| Codex タスクを作成 | just -f .claude/justfile codex-new-task <name> |
| Codex に実行を委譲 | just -f .claude/justfile codex-run <name> |
| 未処理タスク一覧 | just -f .claude/justfile codex-tasks |
| CodeGraph index を作成・再構築 | just -f .claude/justfile codegraph-init |
| CodeGraph 健康確認 | just -f .claude/justfile codegraph-status |
| Claude スキルを起動 | /skill-name（例: /tdd-workflow /markitdown） |
毎回 -f .claude/justfile を打つのが面倒なら alias jc='just -f .claude/justfile' を設定し、jc codex-run <name> のように使う。
設計思想（マルチハーネス）
| ファイル | 役割 | ハーネス |
|---|
AGENTS.md | 全エージェント共通の作業ルール | Codex / Cursor / OpenCode 等が自動読込 |
RULES.md | Must Always / Must Never の絶対ルール | 全エージェント |
SOUL.md | 設計哲学と判断基準 | 全エージェント |
CLAUDE.md | Claude Code 固有指示（AGENTS.md を @import） | Claude Code |
.claude/rules/ | 詳細ルール（共有資産） | 両ハーネス |
my-plugin（skills） | スキル（Claude Code は /skill-name、他ハーネスは plugins/my-plugin/skills/<name>/SKILL.md を直接参照） | 両ハーネス |
.claude/instincts/ | 再利用可能な経験則（YAML） | 両ハーネス |
.codex/ | Codex CLI 固有の運用メモ | Codex |
.tasks/<name>.md | Claude → Codex タスク受け渡し | ブリッジ |
プラグイン / マーケットプレイス構成
配布は 2 段構え:
- 道具箱はプラグインで配る — commands / skills / hooks / MCP を
/plugin install で全プロジェクトに。各プロジェクトにコピーされず、プラグインキャッシュ ~/.claude/plugins/cache/.../my-plugin/ から効く。
- ルールは
/setup-project で展開 — 常時コンテキストに載る CLAUDE.md・ルール類は各プロジェクトへ物理配置する（プラグインからは自動注入できないため）。
役割分担:
| 種類 | どこに住むか | どう配るか |
|---|
| 道具箱（commands / skills / hooks / codegraph MCP） | プラグインキャッシュ | /plugin install（全プロジェクト共通・自動） |
| 常時コンテキスト用のルール（CLAUDE.md / 汎用ルール / 哲学） | 各プロジェクトの .claude/ ・ルート | /setup-project で展開 |
| プロジェクト固有ルール（project / architecture / commands） | 各プロジェクトの .claude/rules/ | /setup-project 後に記入（再実行でも保護） |
なぜ分けるか: プラグインは「常時コンテキストに載る CLAUDE.md / ルール」を自動注入できない。だから道具箱はプラグイン、ルールは各プロジェクトへ物理配置、という分担になる。
マーケットプレイスのファイル構成
.claude-plugin/
└── marketplace.json # マーケットプレイス定義（name: my-marketplace）
plugins/
└── my-plugin/
├── .claude-plugin/plugin.json # プラグイン定義 + codegraph MCP
├── commands/ # /setup-project
├── skills/ # 13 スキル（markitdown 含む）
├── hooks/ # hooks.json + フック群（${CLAUDE_PLUGIN_ROOT} 参照）
└── templates/ # /setup-project が各プロジェクトに展開する雛形
├── CLAUDE.md / AGENTS.md / RULES.md / SOUL.md
├── rules/ # 汎用 + 固有プレースホルダ
└── codex/ # .claude/justfile / run.py / .codex/README.md
/setup-project が展開するもの
| 配置先 | 中身 | 再実行時 |
|---|
| ルート | CLAUDE.md / AGENTS.md / RULES.md / SOUL.md | 保護（既存は触らない） |
.claude/rules/ | git-workflow / security / codex-workflow / skills | 更新（プラグインが正典） |
.claude/rules/ | project / architecture / commands | 保護 |
.claude/justfile ほか | Codex 機械（--no-codex で省略） | 更新 |
--force を付けると保護対象も上書きする。justfile は衝突回避のためプロジェクト直下ではなく .claude/justfile に置かれる。
インストール済み Claude Code プラグイン
このリポジトリの設定とは別に、Claude Code 本体に ユーザースコープ (~/.claude/) で入れているプラグインの一覧。/plugin コマンドまたはマーケットプレイスから導入し、~/.claude/settings.json の enabledPlugins で有効化している。
