AIプログラミングを2年半練習してきたので、必ず必要なトップレベルのプロンプトを3つ共有します。どんな開発ツールでも手動で追加することをおすすめします！

在 AI を活用したプログラミングの 2 年半で、さまざまな AI コードアシスタント（Codex、Cursor、Windsurf など）を試し、「AI が適当にコードを書く」状態から「人と機械が効率的に協調する」までの過程を経験してきました。

実際の開発において、AI の最大の痛点はコードが書けないことではなく、**ドキュメントが散乱している、設計案がすぐに消えてしまう、コードの変更内容がまったく追跡できない**ことです。AI をしっかり従わせ、プロジェクトのルートディレクトリに非常に厳格なエンジニアリング構造を維持するために、**3 つの必須トップレベルプロンプト（System Prompt / Instructions）**をまとめました。

どの開発ツールを使う場合でも、これらを手動でユーザーレベルのカスタム指示に追加することをお勧めします。


### 1：通常ドキュメント

AI はよく、環境設定、デプロイ手順、API 呼び出しガイドなどの説明を要求に応じて生成します。制限をかけないと、そのままチャットボックスに出力されて見つけにくくなったり、プロジェクトのルートディレクトリに適当に置かれたりします。このプロンプトは、AI にすべての指示系ドキュメントを統一して整理させ、プロジェクトの包括的な `docs` アセットライブラリを構築します。

**英語プロンプト：**

> If I ask you to provide some instructions or guides, please save them to the "docs" folder in the root directory.

**日本語訳：**

> もし私が何らかの操作手順やガイドを提供するよう依頼した場合は、それらをルートディレクトリの "docs" フォルダに保存してください。


### 2：設計ドキュメント

コードを書く前に、優れた開発者はまずアーキテクチャ設計と設計レビューを行います。AI に設計提案（Design Proposal）を生成させる際には、それをドキュメントとして固定し、後での確認やチームコラボレーションに役立てる必要があります。このプロンプトは、すべてのコア設計思想、データベーススキーマ設計、インターフェース定義などが追跡可能であることを保証します。

**英語プロンプト：**

> If I ask you to provide some design proposal documents, please save them to the "design" folder in the root directory.

**日本語訳：**

> もし私が設計提案書を提供するよう依頼した場合は、それらをルートディレクトリの "design" フォルダに保存してください。


### 3：変更ログ

これは、私が AI プログラミングを頻繁に利用するようになってから最も恩恵を受けたものです！AI の変更速度は非常に速く、連続していくつかのファイルを変更した後、後で振り返ると自分でもどのロジックを変更したか忘れてしまうことがあります。この指示は、AI がコードを変更するたびに、`changelog` ディレクトリに時系列順で番号付きの変更記録（例：`001-fix-auth-bug.md`）を自動生成するよう要求します。これにより、プロジェクトの進化が一目瞭然になるだけでなく、AI がたまに「ミス」をした場合の完璧なレビューとロールバックの参考にもなります。

**英語プロンプト：**

> Each time code is modified, a new document is created to record the changes in chronological order. Filenames begin with a sort number for easy organization. These documents are saved to the `changelog` folder in the root directory.

**日本語訳：**

> コードが変更されるたびに、変更内容を時系列順に記録する新しいドキュメントを作成します。整理しやすいように、ファイル名はソート番号で始めます。これらのドキュメントはルートディレクトリの `changelog` フォルダに保存されます。


### 使用方法

**Cursor**：`Settings -> Features` に移動し、**`Rules for AI`** に直接入力します。

**Claude Code**：ユーザーホームディレクトリの **`~/.clauderc`** を編集するか（あるいは `claude config set` コマンドでグローバル指示を設定）、**`~/.claude/settings.json`**（`globalInstructions` フィールドに追加）、またはルートディレクトリに **`~/.claude/CLAUDE.md`** を作成します。

**Windsurf**：`Settings` に移動し、**`Global Rules for AI`** を検索して入力します。

**VS Code 汎用プラグイン（例：Continue）**：グローバルの `settings.json` を開き、該当プラグインの **`systemPrompt`** フィールドを修正します。

### 結び

2 年間の AI プログラミング経験から言えるのは、**AI をプログラマーとして扱うよりも、「厳格なルールで縛る必要のあるジュニア開発者」として扱うこと**です。優れたトップレベルプロンプトはプロジェクトの究極の規範となり、あなたが余計な説明をしなくても、プロジェクトのドキュメント、設計、ログ管理を自ら整然と行います。ぜひあなたの開発ツールに追加してください！