Agent Settings — Development skill for Claude Code

Claude CodeとCodexの個人設定集

軽い設定を勧めていた旧版は、タグ`v1`にあります。エージェントに任せる範囲が広がり、作業の重さの判断・hook・証拠・レビューで品質を担保する仕組みが必要になったため、方針を変えました。

Claude CodeとCodexで使う設定、ルール、hook、スキルをまとめています。`claude/`と`codex/`は同じ開発フローとスキルセットで揃えており、`codex/AGENTS.md`は`claude/CLAUDE.md`と同じ内容です。

開発フロー

1. 作業の前に重さ（E/0/1/2/R）を決めてharness-log triageで記録する。マイグレーション・認可・公開API・データ削除・課金・本番反映はレベル2以上。
2. 調査はimozuru・research、既存コードの理解はhow・why。
3. 動かさないと分からない実装はspike-rebuildで、試作して捨ててから作り直す。
4. 設計はspecで、受け入れ条件に[test]・[check]・[human]の印を付ける。レベル1・2はplaybookの手順書に沿う。
5. 実装は、Claude CodeからcodexスキルでCodex（Sol）に頼める（「solで実装して」のように頼んだときだけ使われる）。ゴール・完了条件・範囲・背景・出力・止まる条件をまとめた指示書はClaude Code（Opus）に書かせる。Solの報告だけで完了とせず、差分とテスト結果はClaude Codeが自分で確かめる。
6. 実装中はhookが危険な操作を止め、終わる前にmake checkと証拠（.tmp/evidence//evidence.md）を確かめる。
7. コード変更後はreviewerサブエージェントでレビューし、PRを作る。マージは人が行う。
8. 指摘はharness-log correctionで記録し、同じ間違いが続いたらcorrectで再発を防ぐ。記録はharness-reportで集計する。

詳細は[claude/CLAUDE.md](./claude/CLAUDE.md)を参照してください。

構成

.
├── README.md
├── LICENSE
├── MANIFEST.txt
├── claude/                 # ~/.claude/ に展開する
│   ├── CLAUDE.md
│   ├── settings.json       # hook・権限・環境変数
│   ├── agents/             # reviewer
│   ├── bin/                # harness-log, harness-report
│   ├── hooks/
│   ├── references/         # evidence.mdの形式など
│   ├── rules/
│   └── skills/
└── codex/                  # ~/.codex/ に展開する
    ├── AGENTS.md
    ├── config.toml
    ├── hooks.json
    ├── hooks/
    ├── rules/
    └── skills/

詳細なファイル一覧は[MANIFEST.txt](./MANIFEST.txt)を参照してください。

必要なツール

ツール	用途
uv	harness-reportの実行
python3	Python製hookの実行
jq	hookでのJSON処理
make	stop-check.shがmake checkを実行する
shasum	stop-check.sh・evidence-check.shの状態管理（Linuxではperlのshasumが必要な場合がある）
git、gh	ブランチ保護のhook、PR作成
codex	codexスキル（Claude CodeからCodexに作業を頼む）
op（1Password CLI）	シークレットの注入（rules/secrets-1password.md）
ctx7	Context7でライブラリの最新仕様を確かめる。npmパッケージ`c