50 lines
2.2 KiB
Markdown
50 lines
2.2 KiB
Markdown
# 📂 Posimai Architecture Documentation Guide
|
||
|
||
**作成日**: 2026-01-19
|
||
**概要**: プロジェクトの重要ドキュメントへの案内図です。
|
||
|
||
---
|
||
|
||
## 👑 **3つの最重要ファイル（迷ったらこれを見る）**
|
||
|
||
### **1. AI_HANDOFF_DOCUMENT.md (Project Bible)**
|
||
* **これ何？**: プロジェクトの全て（目的、現状、計画）が書かれた「聖書」。
|
||
* **いつ見る？**: AIにプロジェクトを理解させたい時、全体の流れを確認したい時。
|
||
* **誰に渡す？**: **全てのAI（Claude, Gemini, Antigravity）**
|
||
|
||
### **2. CURSOR_CHAT_MASTER_CONTEXT.md (The Brain)**
|
||
* **これ何？**: Cursorを「最強の技術顧問（Advisor Mode）」にするためのプロンプト。
|
||
* **いつ見る？**: Cursorで新しいチャットを始める時、必ず最初にコピペする。
|
||
* **誰に渡す？**: **Cursor (New Chat)**
|
||
|
||
### **3. CRITICAL_FINAL_ARCHITECTURE.md (The Law)**
|
||
* **これ何？**: インフラ（Synology VMM）の物理構成やメモリ配分の「最終決定事項」。
|
||
* **いつ見る？**: IPアドレスやポート番号、メモリ設定を忘れた時。
|
||
* **誰に渡す？**: インフラ設定をする時の自分、またはAI。
|
||
|
||
---
|
||
|
||
## 🛠️ **サポート資料（必要に応じて）**
|
||
|
||
### **VSCODE_SSH_SETUP_GUIDE.md**
|
||
* **用途**: 会社PCから自宅VMへのSSH接続手順（Tailscale設定など）。
|
||
* **対象**: PCをセットアップする時の自分。
|
||
|
||
### **NANO_BANANA_PROMPT_FINAL.md**
|
||
* **用途**: Gemini 2.5にアーキテクチャ図を描かせるための専用プロンプト。
|
||
* **対象**: 図解が必要になった時のGemini。
|
||
|
||
### **AI_COLLABORATION_PROTOCOL.md**
|
||
* **用途**: AI同士の連携（伝書鳩脱却）の将来計画。
|
||
* **対象**: Phase 2-B完了後に実装する時の参考。
|
||
|
||
### **AUTOMATION_SAFETY_PROTOCOL.md**
|
||
* **用途**: 自動デプロイ時の安全ルール（絶対にやってはいけないことリスト）。
|
||
* **対象**: Dokploy運用時の参照用。
|
||
|
||
---
|
||
|
||
## 🗑️ **Archive (過去の遺産)**
|
||
* `archive/` フォルダには、検討過程で不要になったファイルが格納されています。
|
||
* 基本的には見る必要はありません。
|