Update README.md

README.md

@@ -1,12 +1,34 @@
+# 🔮 AI 만신전 (The AI Pantheon)
+
+> **"당신의 운명을 읽어주는 멀티 페르소나 AI 점집"**
+
+AI 만신전은 단순한 챗봇이 아닙니다. **Streamlit**과 **LLM(Large Language Model)** 기술을 결합하여, 상황에 따라 전혀 다른 인격(Persona)과 전문 지식을 가진 AI 상담사를 만날 수 있는 인터랙티브 운세 애플리케이션입니다.
+
+## 🌟 주요 기능 (Key Features)
+
+### 1. 3가지 멀티 페르소나 모드
+- **🃏 타로 마스터 (The Mystic)**: 서양의 신비로운 마법사 톤. 78장 타로 카드의 상징을 분석하여 과거/현재/미래를 해석합니다.
+- **🏡 풍수지리 대가 (The Master)**: 40년 경력의 깐깐한 노교수 톤. 공간의 구조와 기의 흐름을 분석하여 인테리어 조언을 제공합니다.
+- **👹 용한 신점쟁이 (The Shaman)**: **(킬링 포인트)** 예의 없는 반말과 호통을 치는 무당 컨셉. 사용자의 멘탈을 흔들며 핵심을 찌르는 조언을 합니다.
+
+### 2. 인터랙티브 타로 리딩
+- 단순히 텍스트만 입력하는 것이 아니라, 사용자가 **직접 카드를 뽑는 경험(UX)**을 제공합니다.
+- `Input` → `Picking` → `Reading` 3단계 상태 관리(State Management)를 통해 실제 상담과 유사한 몰입감을 줍니다.
+
+### 3. 확장 가능한 아키텍처
+- `utils/` 폴더를 통해 로직(Logic), 데이터(Data), 프롬프트(Prompt)를 분리하여 유지보수가 쉽습니다.
+- 현재는 시뮬레이션 모드(Mock Data)로 동작하지만, 추후 `Ollama` 또는 `OpenAI API`만 연결하면 즉시 실서비스가 가능합니다.
+
 ---
-title: Ai Pantheon
-emoji: 🌍
-colorFrom: indigo
-colorTo: indigo
-sdk: streamlit
-pinned: false
-license: mit
-sdk_version: 1.52.2
----
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## 📂 프로젝트 구조 (File Structure)
+
+```text
+ai-pantheon/
+├── main.py              # 🚀 앱 실행 진입점 (UI 및 라우팅)
+├── requirements.txt     # 📦 필요한 파이썬 라이브러리 목록
+├── README.md            # 📄 프로젝트 설명서
+└── utils/               # 🔧 핵심 기능 모듈
+    ├── tarot.py         # 🃏 타로 카드 데이터 및 덱 관리
+    ├── prompts.py       # 🎭 AI 페르소나(System Prompt) 정의
+    └── llm.py           # 🧠 AI 모델 연동 및 응답 생성 (현재: Simulation)