このプロンプトを貼り付けて、AI IDEにあなたのシステムを理解させよう
Tech
AI
Developer Tools
Workflow
Prompting

このプロンプトを貼り付けて、AI IDEにあなたのシステムを理解させよう

私は、Codex、Claude Code、またはCursorがあなたのフルスタック向けに読み取り専用のコンテキストハブを構築するのを助けるシンプルなプロンプトとGitHubリポジトリを公開しました。

Uygar DuzgunUUygar Duzgun
Apr 2, 2026
Updated 2026年4月4日
3 min read

AIツールは、作業が1つのリポジトリ内に収まっているときにこそ素晴らしいです。

でも、それがほとんどの実際のシステムの形ではありません。

タスクが複数のリポジトリ、環境、社内ツール、外部サービスにまたがった瞬間、AIは重要なコンテキストを見落とし始めます。AIは開いたフォルダは分かります。ですが、その周りのシステムは分かりません。

そこで、私はとても単純な修正を作りました。

ローカルの検証済みファイルから、読み取り専用のコンテキストハブを構築するように、あなたのAI IDEに指示するコピペ用プロンプトを公開しました。

これは何を解決するか

ほとんどのAI IDEはリポジトリネイティブです。

1つのコードベースの中では役に立ちますが、作業が次のようにまたがると弱くなります:

複数のリポジトリ
ローカル環境と本番環境
社内ツール
外部連携
認証とシークレットの境界

それはたいてい、同じダメなループにつながります:

あなたがもう一度アーキテクチャを説明する
AIがスタックの一部を推測する
ローカルでは正しいが、全体としては間違った提案をする

私はもっとシンプルなものが欲しかった。

AIにこう伝えられるプロンプトが欲しかった:正しいファイルをスキャンして、システムをマッピングし、読み取り専用に保ち、シークレットには触れないでください、と。

このプロンプトがやること

このプロンプトは、Codex、Claude Code、またはCursorに対して、リポジトリの外側にあるより広いシステムを説明する小さなコンテキストハブを作らせます。

それは次を生成します:

`README.md`
`BOOTSTRAP.md`
`SYSTEM_MAP.md`
`system-index.yaml`
`ENVIRONMENTS.md`
`SECRETS_INDEX.md`
`PROJECTS/*.md`
`INTEGRATIONS/*.md`
`RUNBOOKS/*.md`

さらに、次のためのブリッジ用スニペットも生成できます:

`AGENTS.md`
`CLAUDE.md`
Cursorのメモリファイル

重要なのは、これは別の自動化システムではないということです。

これはAIのための読み取り専用のシステムマップです。

なぜこのバージョンはより安全か

ルールはかなり厳格に保ちました:

検証済みの事実のみ
平文のシークレットなし
コピーしたトークンなし
パスワードなし
アプリコードの変更なし
AIの指示ファイルをパッチする前に確認する

これは、目的がAIにより多くの権限を与えることではないからです。

目的は、AIにより良いコンテキストを与えることです。

使い方

Codex、Claude Code、またはCursorを、あなたのスタックに属する任意のリポジトリで開きます。
PROMPT.md からプロンプト全文をコピーします。
AIに、含めるべきリポジトリ、システム、外部サービスを伝えます。
ドキュメント、設定、ワークフローファイル、環境ファイル名、環境キー名をスキャンさせます。
「Where should the hub be saved?(ハブはどのフォルダに保存すべき?)」と聞かれたら、フォルダを選びます。
ブリッジのパッチを許可する前に、生成されたファイルを確認します。

以上です。

GitHubリポジトリ

リポジトリはこちらです:

ai-context-hub-prompt

コピペ用の正確なファイルだけ欲しい場合は、こちらを使ってください:

Copy the prompt

また、実行する前に期待される構造が分かるように、サンプルの出力ファイルも追加しました。

これは誰向けか

作業が複数のリポジトリにまたがり、あなたのAIに次を理解させたい場合に役立ちます:

システムがどこにあるか
それらがどうつながっているか
何が何に依存しているか
どの環境がどれか
認証がどこから来ているか

実際には、たいてい次のような人たちです:

ファウンダー
オペレーター
テクニカルなゼネラリスト
インディーハッカー
社内ツールと外部サービスを扱うチーム

最後に

あなたのAIは、毎回もっと大きなプロンプトを必要としていないかもしれません。

必要なのは、より良いマップかもしれません。

このプロンプトはそれのためのものです。

試してみたいなら、プロンプトをコピーして、あなたのリポジトリに向けて、コンテキストハブを作らせてください。