jbarbier/CLAUDE.md

解決する問題

このプロジェクトは、Claude Code、Cursor、Gemini CLI などのコードエージェント向けの包括的で主観的な指示（「契約」）を提供します。エージェントが平凡な行動（テストをスキップしたり、ライブラリを勝手に作ったり、本来独立して処理すべきタスクについて許可を求めるなど）を取らないようにするため、エージェントがどのように考え、コードを書くか、どのようにコミュニケーションするかについて、常に適用されるルールセットを設けています。

動作方法

このプロジェクトは、1つのファイル CLAUDE.md で構成されており、各セッションの開始時にモデルのコンテキストに読み込まれます。このファイルは、エージェントのデフォルト動作を上書きするシステムプロンプトまたは継続的な契約として機能します。異なるツール間での互換性を確保するために、著者は CLAUDE.md を AGENTS.md や GEMINI.md などにシンボリックリンクで接続することで、複数のAIコードツールに対して一元的なソースを維持することを推奨しています。

対象ユーザー

AIコードエージェントを使用しており、厳格な運用ガイドラインを提供することで、より高品質で予測可能な出力を得たい開発者。

特徴

• ツール間互換性: 標準化された命名規則とシンボリックリンクにより、Claude Code、OpenAI Codex CLI、Cursor、Gemini CLI をサポート。
• コード化されたブランチルール: 複数のエージェントセッションが同じリポジトリ内で競合しないように、git worktrees を管理する検証済みのシェルコマンドを含む。
• マルチエージェントワークフロー: 高品質な出力を得るための「ファンアウト＋厳格な批判」ループと、反復的改善のための自己評価ルールを組み込み。
• モジュール構造: タスクサイズ、セキュリティ、完了状態などのセクションに分類された指示で、ユーザーはプロジェクトのニーズやスタックに応じて削除または保持が可能。
• 検証済みコマンド: リポジトリには、指示内に含まれるシェルコマンドが機能的に正しいことを保証するテストスイートが含まれている。