ponshu-room-lite/docs/architecture/README.md

2.2 KiB
Raw Blame History

📂 Posimai Architecture Documentation Guide

作成日: 2026-01-19 概要: プロジェクトの重要ドキュメントへの案内図です。


👑 3つの最重要ファイル迷ったらこれを見る

1. AI_HANDOFF_DOCUMENT.md (Project Bible)

  • これ何?: プロジェクトの全て(目的、現状、計画)が書かれた「聖書」。
  • いつ見る?: AIにプロジェクトを理解させたい時、全体の流れを確認したい時。
  • 誰に渡す?: 全てのAIClaude, 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/ フォルダには、検討過程で不要になったファイルが格納されています。
  • 基本的には見る必要はありません。