Agent Config

agent-config

Claude CodeとCodex CLIの共通設定テンプレートを管理する。Qwen Codeは任意で追加できる。

概要

• 正本は templates/ 配下
• scripts/cli.py で ~/.claude/、~/.codex/、~/.agents/skills/ に反映 (Linux / macOS / Windows 対応)
• AI共通ガイドラインの正本はtemplates/CLAUDE.mdだけである。各ツールが要求するファイル名（~/.claude/CLAUDE.md、~/.codex/AGENTS.md、~/.qwen/QWEN.md）へ同じ内容を配布する
• Qwen Code（~/.qwen/）は任意で追加できる。--qwenを付けたときだけ配布対象に加わる
• --claude-dir で CLAUDE_CONFIG_DIR 用の別プロファイルにも配布できる
• Linux / macOS / Git Bashでは install.sh / clean.sh などのシェルラッパーから呼び出せる
• README.mdとdocs/は説明資料であり、実行時契約の正本はtemplates/に置く

正本

• templates/CLAUDE.md - Claude Code、Codex CLI、Qwen Codeに共通するAI共通ガイドライン（唯一の正本）
• templates/skills/ - Claude / Codex / Qwen Code 共用の skills
• templates/output-styles/ - Claude Code 向け custom output styles (モデル切替時の行動規範。fable-like 同梱)
• templates/config.toml - Codex CLI 用設定テンプレート
• templates/codex/*.config.toml - Codex CLI用のプロファイルテンプレート（~/.codex/.config.toml）
• templates/codex-rules/ - Codex CLI 用 exec policy rules
• templates/statusline.py - Claude Code 用 status line (リッチ 2 行レイアウト)
• templates/subagent-statusline.py - Claude Codeのsubagent status line
• templates/settings.json - Claude Code向けの推奨settings.json（既存ファイルへは浅くマージ）
• templates/qwen-settings.json - Qwen Code向けの推奨settings.json（--qwen指定時のみ利用。既存ファイルへは浅くマージ）

`docs/`は参考資料として残す。履歴メモや検討計画はGitで追跡し、作業中の計画メモが必要な場合はリポジトリ直下の`.plan/`に置く。

ディレクトリ構造

• templates/ - 配布対象テンプレート
• scripts/ - Python CLI 本体と補助スクリプト
• scripts/cli.py - インストーラ / クリーナ / 検証 / settings マージを束ねる Python CLI
• scripts/tests/ - scripts/cli.py の unittest
• evals/ - 挙動資産ごとの評価シナリオ集。配布せず、km-skill-evalの回帰評価で必要な項目だけ使う
• docs/ - 保守対象の参考ドキュメント
• .github/workflows/ - GitHub Actions CI 設定
• .claude/ - このリポジトリ自身の Claude Code 設定

セットアップ

正規の入口は`scripts/cli.py`である。Pythonコマンド名の違いはシェルラッパーが吸収し、OSごとの差はPython CLI内に閉じ込める。インストール処理本体はLinux、macOS、Windowsで共有し、Linux、macOS、Git Bashにはシェルラッパーも同梱する。

Linux / macOS:

./install.sh
# または同等