AI News HubLIVE
站内改写

1つのMarkdownファイルでClaude、Codex、Cursor、Copilotをセットアップ

ai-project-setupというオープンソースプロジェクトは、約7600行のMarkdownブートストラップファイルを提供し、Claude Code、ChatGPT Codex CLI、Cursor、GitHub CopilotなどのAIコーディングアシスタントのルール、セーフティフック、セッション再開、メモリーシステム、バイリンガルGitHubファイルを自動生成します。ファイルをダウンロードしてAIに読み取り実行を指示するだけで、1〜3分で設定が完了し、すべてのツールファイルはgitignoreされ、プロジェクト履歴をクリーンに保ちます。

記事インテリジェンス

エンジニア中級

要点

  • 単一のMarkdownファイル（AI_PROJECT_SETUP.md）がClaude、Codex、Cursor、Copilotの複数AIツールに対応する唯一の情報源。
  • 13セクションのルール、5つのセーフティフック、3層のセッション保存、デュアルライトメモリー、英韓バイリンガルのGitHub標準ファイルを自動生成。
  • 冪等で自己修復可能：再実行で設定のずれを修復し、古いファイルをバックアップし、ユーザーコンテンツを保持。
  • シンボリックリンクによるマルチツールの一元管理、クロスAIコードリレー（例：Claudeが計画、Codexが実装）をサポート。

重要な理由

このニュースが重要なのは、単一のMarkdownファイル（AI_PROJECT_SETUP.md）がClaude、Codex、Cursor、Copilotの複数AIツールに対応する唯一の情報源ためです。

技術的影響

モデル選定、推論コスト、プロダクト能力、評価基準に影響する可能性があります。

プロジェクト背景

新しいプロジェクトを始めるたびに、開発者はAIコーディングアシスタントのルールや安全制限、ツール統合を繰り返し設定する必要があります。ai-project-setupプロジェクトは、AI_PROJECT_SETUP.mdという単一のMarkdownファイル（約7600行）でこの問題を一回で解決します。このファイルは唯一の情報源として機能し、Claude Code、ChatGPT Codex CLI、Cursor、GitHub Copilotなどの主要なAIコーディングツールに完全なプロジェクト設定を自動実行させます。

クイックスタート

任意のGitリポジトリで、以下のコマンドを実行してブートストラップファイルをダウンロードします：

curl -fsSL https://raw.githubusercontent.com/kernalix7/ai-project-setup/main/AI_PROJECT_SETUP.md > AI_PROJECT_SETUP.md

次に、AIツール（Claude、Codex、Cursor、VS CodeのCopilotなど）を開き、「AI_PROJECT_SETUP.mdを読み込んで実行して」と指示します。1〜3分待った後、検証スクリプトを実行します：

./tmp-igbkp/verify-setup.sh
# 期待される出力：Pass: 83 Fail: 0 Warn: 0

自動生成される内容

実行後、プロジェクトルートに以下の構造が生成されます：

  • シンボリックリンクファイル：CLAUDE.md、AGENTS.md、.cursorrules（すべて同じターゲットを指す）
  • .priv-storage/ ディレクトリ（gitignored）：13セクションのプロジェクトルール、ローカルオーバーライドルール、セッションログ、メモリーファイル、セーフティフック、デフォルトエージェント、スラッシュコマンドなど
  • tmp-igbkp/ ディレクトリ（gitignored）：検証、バックアップ、復元、秘密スキャンなどの9つのスクリプト
  • 標準GitHubファイル：README.md、SECURITY.md、CONTRIBUTING.md、CODE_OF_CONDUCT.md、CHANGELOG.mdとその韓国語翻訳版
  • .github/ ディレクトリ：IssueテンプレートとPull Requestテンプレート

主な機能

**セーフティフック**：Claude Code向けにPreToolUse、PostToolUse、SessionStart、PreCompact、Stopの5つのフックを実装。PreToolUseは危険なコマンド（rm -rf /、強制プッシュ、秘密情報の漏洩など）や大きなファイルの読み取り、AIツール名を含むコミットメッセージをブロックします。PostToolUseはセッションを自動記録します。

**セッション復元**：3層のログシステム（current.md：毎回の呼び出し、handoff-{date}.md：セッション終了時、recovery.md：圧縮前）により、クラッシュやレート制限が発生しても、次のセッションで自動的にコンテキストを復元します。

**メモリーのデュアルライト**：すべてのメモリーファイルが~/.claude/projects/に同期され、マシンを跨いでも即座にメモリーが復元されます。

**デフォルトエージェント**：テクニカルリード、エクスプローラー、コードレビュアー、ログアナライザーの4つのエージェントがプリインストールされ、しきい値（3ファイル、500行コード、またはモジュール間作業）を超えるとサブエージェントへの委任が強制され、コンテキストウィンドウを節約します。

**スラッシュコマンド**：/status、/health、/recover、/ship、/save、/cleanなど10以上のコマンドを提供し、日常操作を容易にします。

**クロスAIツールリレー**：v4.9以降、ClaudeとCodex CLI間でタスクを分担可能。Claudeが計画とレビュー、Codexが実装を担当し、/codex-brief、/codex-review、/codex-fixなどのコマンドで連携します。

**シークレットスキャン**：14の正規表現パターン（AWSキー、OpenAIキー、GitHubトークンなど）を内蔵し、git pre-commitフックに統合できます。

ライフサイクル

設定完了後、通常のセッションではAIはCLAUDE.md（約200行）とPOST_SETUP_INDEX.md（約50行）のみを読み取り、7000行の完全なブートストラップファイルを再読み込みしません。これにより、セッションあたり約25kトークンを節約します。更新が必要な場合は、「アップデート設定」と指示するだけで、GitHubから最新バージョンを取得し、すべてのスクリプトを自動置換します。

対応ツールとバージョン

| ツール | 最小バージョン | ルールファイル | フックサポート | |------|---------|---------|---------| | Claude Code | 2.0+ | CLAUDE.md | 完全（5フックイベント） | | ChatGPT Codex CLI | 0.10+ | AGENTS.md → CLAUDE.md | ポリシーのみ | | Cursor | 0.40+ | .cursorrules → CLAUDE.md | ポリシーのみ | | GitHub Copilot | 1.150+ | AGENTS.md | ポリシーのみ |

「ポリシーのみ」とは、ルールがプロンプト内容によって実施され、カーネルレベルのブロックはないことを意味します。

まとめ

ai-project-setupは、AIコーディングツールの標準化された設定を実現するエレガントな単一ファイルソリューションです。繰り返しの設定作業を大幅に削減するとともに、強力なセキュリティ機構とセッション管理により開発体験を向上させます。現在、GitHubでv5.2安定版としてリリースされており、充実したドキュメントとコミュニティ貢献ガイドを備えています。