# 📂 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/` フォルダには、検討過程で不要になったファイルが格納されています。
*   基本的には見る必要はありません。