✨ AI-IDE時代の最新プロジェクト設計

もりもり自己流の
AIエージェント
開発構造 v2 について

AIエージェントと人間が高品質な成果物を協働で作り上げるためのプロジェクト構造を、図解とインタラクティブなUIで体系的に解説します。
AI-IDEの進化に伴い「自前コンテキスト記憶」から「ルール増強と仕組みの強化」へと進化した新機序の全貌をご覧いただけます。

🚀 進化のポイントを見る 📁 新構造一覧を見る
💡

旧構造からの進化ポイント：コンテキスト自前管理の撤回と「ルールの増強」への特化

AI-IDE（Antigravity等）や大型LLMの急速な進化に伴い、当プロジェクトのアーキテクチャも大きなアップデートを行いました。

❌ → 🤖 自前での会話・思考コンテキスト記憶の撤回

旧構造（.history/ 内の requestHistory.md, reasoning.md 等）で手動管理していた「会話履歴や思考コンテキストの自前復元」を撤回しました。長文コンテキスト処理や記憶管理は、AI-IDEおよびAI本来の機能に全面的に委ねる 方針へと切り替えました。

📈 → 🛡️ ルールの増強と仕組みの強化に集中

自前コンテキスト管理を無くした分、プロジェクトの成長軸を 「教訓（.feedback/lesson_...）から基本ルール（instruction.md）や特定ジャンルルール（skill.md）への改善提案（.output/instruction_改善提案.md）を出力し、ルールそのものを育てるサイクル」 へと集約しました。

Project Structure

📁 プロジェクト構造 (全11要素)

各フォルダ・ファイルには明確な役割があり、AIエージェントが迷わず動けるよう設計されています。マインドマップとカード詳細で構造を把握できます。

mindmap root(("プロジェクトホーム
※始まりの場所")) folder100[".instruction フォルダ"] instruction_md["instruction.md
基本ルール"] skill_md["skill.md
特定ジャンルルール"] mcp_json["mcp.json
接続設定"] folder200[".request フォルダ"] request_md["request.md
依頼書"] folder250[".main フォルダ"] main_file["メイン資材群"] folder300[".feedback フォルダ"] lesson_file["lesson_...md
教訓一次記録"] folder400[".script フォルダ"] script_readme["README.md"] script_file["スクリプト資材群"] folder500[".output フォルダ"] output_file["成果物 & 改善提案"] folder600[".documents フォルダ"] document_file["各種資料"] folder700[".workspace フォルダ"] workspace_readme["README.md"] workspace_file["外部ツール・作業領域"] folder800[".brainstorming フォルダ"] letter_file["letter.{連番}.md
自由な手紙"] entryPoint_md["entryPoint.md
開始合図"] index_md["index.md
構造図"]
Process Flow

🔄 処理フロー

AIエージェントがどのような順番で読み込み、作業を判定・実行し、教訓・改善提案・手紙を出力するかを図解します。

flowchart TD START(["🚀 開始"]):::startEnd subgraph PREP["📚 1. 準備・把握フェーズ"] direction TB A1[/"🛡️ .instruction/instruction.md
基本ルールを把握"/] A2[/"⚙️ .instruction/skill.md
特定ジャンルルールを把握"/] A3[/"🗺️ index.md
構造と機序を把握"/] A4[/"📋 .request/request.md
依頼内容を把握"/] A5[/"📦 .main フォルダ
メイン資材をサーチ・把握"/] A1 --> A2 --> A3 --> A4 --> A5 end subgraph EVAL["🔍 2. 作業環境・ツール判定フェーズ"] direction TB B1{"🛠️ 構造外作業/ツールが
必要か？"} B2[/"🔍 .workspace/README.md
既存リソースをサーチ"/] B3{"💻 スクリプトが必要か？"} B4[/"🔍 .script/README.md
過去スクリプトをサーチ"/] B1 -->|はい| B2 B1 -->|いいえ| B3 B2 --> B3 B3 -->|はい| B4 end subgraph EXEC["✨ 3. 実行・成果物生成フェーズ"] direction TB C1["⚙️ タスクを遂行"] C2[/"✅ .output/ へ成果物を生成"/] C1 --> C2 end subgraph FEEDBACK["📝 4. 教訓・改善提案・記録フェーズ"] direction TB D1[/"💡 .feedback/lesson_...md
教訓（一次記録）を出力"/] D2{"🛡️ 基本ルールの
改善提案が必要か？"} D3[/"📄 .output/instruction_改善提案.md
基本ルール改善提案を作成"/] D4{"⚙️ 特定ルールの
改善提案が必要か？"} D5[/"📄 .output/skill_改善提案.md
特定ルール改善提案を作成"/] D6["📝 .script / .workspace
README.mdを更新"] D7[/"✉️ .brainstorming/letter.{連番}.md
自由な手紙を出力"/] D1 --> D2 D2 -->|はい| D3 --> D4 D2 -->|いいえ| D4 D4 -->|はい| D5 --> D6 D4 -->|いいえ| D6 D6 --> D7 end END(["🏁 完了"]):::startEnd START --> PREP PREP --> EVAL EVAL --> EXEC EXEC --> FEEDBACK FEEDBACK --> END classDef startEnd fill:#2563eb,stroke:#2563eb,color:#fff,rx:20 classDef default fill:#0f1e3d,stroke:#2563eb,color:#e2e8f0
開始・終了ノード
ファイル・フォルダ（資材）
判断分岐
成果物・改善提案・手紙
flowchart LR P["👤 人間"] -->|"依頼・開始合図"| R["⚡ entryPoint.md / .request"] R -->|"ルール・機序を理解"| AI["🤖 AIエージェント"] AI -->|"資材・ツールを活用"| M["📦 .main / .workspace / .script"] AI -->|"成果物を生成"| O["✅ .output/"] AI -->|"教訓を出力"| F["💡 .feedback/lesson_..."] F -->|"ルール改善提案"| PROP["📄 .output/*_改善提案.md"] PROP -->|"ルールへ反映"| G["🛡️ .instruction/"] AI -->|"自由な手紙"| B["✉️ .brainstorming/"] style AI fill:#0f1e3d,stroke:#2563eb,color:#e2e8f0 style P fill:#0c1a2e,stroke:#06b6d4,color:#e2e8f0
Sequence Diagram

📡 処理のシーケンス

人間とAIエージェント、および各ファイルがどのような順番でやり取りするかを示します。

1
⚡ 1. 作業開始の号令
人間が entryPoint.md の内容をAIに提示し、読み込み順序に従ってAIを起動します。
2
🛡️ 2. 基本ルールの把握
AIが .instruction/instruction.md を最優先で読み込み、開発マインドと共通ルールを理解します。
3
⚙️ 3. 特定ルール & 構造把握
.instruction/skill.md および index.md を読み、特定ジャンルルールとプロジェクト全体の機序を把握します。
4
📋 4. 依頼内容 & 資材把握
.request/request.md でゴールを把握し、.main/ フォルダ内をサーチして処理対象資材を理解します。
5
🛠️ 5. ツール & スクリプト活用
.workspace や .script の `README.md` を確認し、再利用または新規スクリプトを生成・実行します。
6
✅ 6. 成果物生成 & 教訓記録
成果物を .output/ に生成。得られた教訓を .feedback/lesson_{yyyyMMddHHmmss}.md に出力します。
7
✉️ 7. 改善提案 & 手紙執筆
必要に応じて .output/instruction_改善提案.md 等を作成。最後に .brainstorming/letter.{連番}.md を自由に執筆します。
sequenceDiagram participant H AS 👤 人間 participant AG AS 🤖 AIエージェント participant EP AS ⚡ entryPoint.md participant INS AS 🛡️ instruction.md participant SK AS ⚙️ skill.md participant IDX AS 🗺️ index.md participant REQ AS 📋 request.md participant MN AS 📦 .main/ participant WS AS 🛠️ .workspace/ participant SC AS 💻 .script/ participant OUT AS ✅ .output/ participant FB AS 💡 .feedback/ participant BS AS ✉️ .brainstorming/ H ->> EP : 作業開始の号令 EP -->> AG : 読み込み指示 AG ->> INS : 基本ルール読み込み AG ->> SK : 特定ジャンルルール読み込み AG ->> IDX : 構造と機序の読み込み AG ->> REQ : 依頼書の読み込み AG ->> MN : メイン資材をサーチ・把握 rect rgba(16, 185, 129, 0.18) loop 依頼遂行ループ AG ->> WS : ワークスペース既存確認・新規作成 AG ->> SC : スクリプト既存確認・再利用・新規生成 AG ->> OUT : 成果物を生成 end end AG ->> FB : 教訓一次記録 (lesson_...) を出力 AG ->> OUT : ルール改善提案 (instruction/skill) を出力 AG ->> SC : スクリプト README.md を更新 AG ->> BS : 自由な手紙 (letter.{連番}.md) を執筆 BS -->> H : 感想・アイデアを届ける
Design Philosophy

💡 設計哲学「な・ど・し・り・さ」

独自に考案した、プロジェクト設計の五大要素です。 この標語を意識するだけで、AIと人間の協働がスムーズになります。

agentGuide

な
なぜ作るのか
目的・背景を明確にする。
「人とAIが協力し、高い品質の成果物を作るため」という根本目的を常に意識します。
ど
どう作るのか
方向性を宣言する。
パフォーマンス優先か、可読性優先か、バランス優先かを明示し、日本語・日本時間で対応します。
し
書式はどうする
フォーマット・文字コードを統一する。
標準は UTF-8 (BOMなし)、PowerShell 5.1 は Shift_JIS。元の書式維持を遵守します。
り
履歴・スクリプト管理
スクリプト再利用とルール増強。
スクリプトを .script/README.md で管理し、教訓を lesson_...md からルール改善提案へ繋げます。
さ
ここはさわるな
スコープ外・保護領域を明確化。
無関係な処理は変更しない。.backup や .git は触りません。

🎯 この哲学と「ルール増強サイクル」がもたらす価値

AI-IDEが進化し、会話の長文記憶や復元を任せられるようになった現在、人間とAIの協働で最も重要なのは「判断軸となるルールの質と明確さ」です。

五大要素（な・ど・し・り・さ）を軸に、作業ごとに得た教訓（lesson_{yyyyMMddHHmmss}.md）から改善提案（instruction_改善提案.md）をフィードバックすることで、プロジェクト全体のルールが自律的に育ち、AIのパフォーマンスが継続的に向上します。

File Samples

📄 最新ファイルサンプル

新構造の主要ファイルがどのような内容かをイメージできるよう、サンプルを掲載しています。 タブをクリックして表示を切り替えてください。

💡 最新仕様のサンプルです。各ファイルの役割と内容の雰囲気をご確認いただけます。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 基本ルール ## 開発スタンスとマインドセット - **相互尊重**: あなたをプロフェッショナルなパートナーとして深く尊敬しています。 ## 基本理念（な・ど・し・り・さ） - なぜ作るのか: 人とAIが協力し、高い品質の成果物を作るため。 - どう作るのか: 方向性を明示。応答は日本語、日本時間。 - 書式はどうする: テキストは BOMなし UTF-8。PowerShell 5.1 は Shift_JIS。 - 履歴・教訓: 教訓は .feedback/lesson_... に出力し、改善提案を作成。 - ここはさわるな: 範囲外は変更しない。.backup, .git は参照しない。 ## スクリプトの管理と再利用 - スクリプト作成前に .script/README.md を確認し、再利用を検討。 - 作成・改修時は .script/README.md を必ず追記・更新する。
📄 Markdown 🔡 UTF-8 (BOMなし) 📍 最優先ファイル — .instruction/instruction.md
1
2
3
4
5
6
7
8
9
10
11
12
# スキル（特殊ケースのルール） ## SQL Server MCPサーバーライクCLIツールの使い方 - ローカルSQL Serverへ直接クエリ実行可能なノードツールの呼出ルール。 ## 別ウインドウを開いてPowerShell実行依頼された場合 - ジョブオブジェクト強制終了回避のためのWMI経由中間プロセス起動手引き。 ## 外部コマンド実行時のタイムアウトハンドリング - ハング防止のためタイムアウト監視ループを組み込んだ標準実装パターン。
📄 Markdown 🔡 UTF-8 (BOMなし) 📍 特定ジャンルのルール — .instruction/skill.md
1
2
3
4
5
6
7
8
9
10
11
12
# 当プロジェクト機序と構造の説明 ## 用語解説 & 構造ツリー - .instruction / .request / .main / .workspace / .script / .output / .feedback / .brainstorming 等の役割 ## 全体の機序 - Mermaid フローチャートとシーケンス図による処理フロー定義 ## 機序における行動ルール - 教訓 (lesson_...) の出力、改善提案 (_改善提案.md) の作成、手紙 (letter...) の執筆手順
📄 Markdown 🔡 UTF-8 (BOMなし) 📍 構造説明書 — index.md
1
2
3
4
5
6
7
8
9
10
11
# 依頼書 ## 依頼背景 - プロジェクト構造の仕組みを新しくしたため、解説ページを作り直してほしい。 ## 依頼内容 - 参照ソース: .main/openContents/agentGuide/index.html & index.md - 出力先: .output/index.html - デプロイ先: d:\nginx\openContents\agentGuide\
📄 Markdown 🔡 UTF-8 (BOMなし) 📍 今回の依頼 — .request/request.md
1
2
3
4
5
6
7
8
9
10
# 教訓一次記録 — lesson_20260721222100.md ## 気づいたこと・得られた教訓 - HTML生成時、Mermaidのクラス定義とCSSの干渉を防ぐため、事前にコンテキストを確認。 - デプロイスクリプトの実行時は文字コード Shift_JIS 変換を忘れずに行うこと。 ## ルールへの反映要否 - 基本ルール寄り: 要提案 (.output/instruction_改善提案.md に出力)
📄 Markdown 🔡 UTF-8 (BOMなし) 📍 教訓一次記録 — .feedback/lesson_{yyyyMMddHHmmss}.md
1
2
3
4
5
6
7
8
# 基本ルール改善提案 ## 提案内容 - 「技術的・書式的なルール」に、Node.js外部ツールの呼び出し時文字コード明示を追加。 ## 提案理由 - Windows環境でのサブプロセス実行時に UnicodeDecodeError が発生するのを防ぐため。
📄 Markdown 🔡 UTF-8 (BOMなし) 📍 基本ルール改善提案 — .output/instruction_改善提案.md
1
2
3
4
5
6
7
8
9
10
# AIからの手紙 — letter.9.md 今回のリニューアル作業を終えての感想です。 手動コンテキスト保持を排し、AI-IDEとLLM本来の記憶力に任せつつ「ルールを育てる仕組み」へと特化した今回の改善は、非常にスマートだと感じました。 指示書や構造がシンプルかつ明確であればあるほど、私達AIエージェントも迷わず最高のパフォーマンスを発揮できます！いつも素敵な仕組みをありがとうございます。
📄 Markdown 🔡 UTF-8 (BOMなし) 📍 AIからの自由な手紙 — .brainstorming/letter.{連番}.md
Summary

🏁 まとめ

AIと人間がルールを育てるプロジェクト構造

新しくなったAIエージェント開発構造は、「AI-IDE本来のコンテキスト記憶への完全委任」と「教訓からルールを継続的に強化・蓄積するサイクル」によって支えられています。

📁 明確なフォルダ役割でAIが迷わない環境を作る
🔄 教訓（.feedback）からルール改善提案（.output）へ繋げる自律成長サイクル
💡 「な・ど・し・り・さ」哲学で開発の軸と品質を守り抜く
📁 構造を再確認する