docs: organize root documentation

Author: MarkShawn2020

.gitignore

@@ -27,4 +27,5 @@ src-tauri/target/
 
 # Local workspace artifacts
 .claude/
+.codex/
 output/

README.md

@@ -26,6 +26,7 @@
   <a href="https://code.lovstudio.ai/">Website</a> •
   <a href="#overview">Overview</a> •
   <a href="#features">Features</a> •
+  <a href="#documentation">Docs</a> •
   <a href="#installation">Installation</a> •
   <a href="#usage">Usage</a> •
   <a href="#development">Development</a> •
@@ -90,6 +91,15 @@ The goal is simple: arrive at the right project, see the full context, and resum
 - In-app update checks, release history, auto-update controls, and direct release links.
 - Authenticated Lovstudio feedback tickets with tags, ticket IDs, and admin review tooling.
 
+## Documentation
+
+Project documentation that does not need to live in the repository root is kept under `docs/`.
+
+- [Proxy configuration](docs/proxy-configuration.md)
+- [Product requirements](docs/prd-parallel-vibe-coding.md)
+- [Warm Academic design guide](docs/design-guide.md)
+- [OpenCode research index](docs/research/RESEARCH_INDEX.md)
+
 ## oh-my-lovcode
 
 Community configuration framework for Lovcode, inspired by oh-my-zsh.

design-guide.md docs/design-guide.mddesign-guide.md renamed to docs/design-guide.md

@@ -10,16 +10,18 @@ Due to web access limitations, research focused on **deep analysis of Lovcode's
 
 ## Document Structure
 
-All research and specifications are organized in the repository root as Markdown files:
+All research and specifications are organized in `docs/research/`:
 
 ```
 lovcode/
-├── RESEARCH_INDEX.md                  ← YOU ARE HERE (navigation guide)
-├── OPENCODE_RESEARCH.md               ← Deep architecture analysis
-├── SKILLS_INSTALLATION_SPEC.md        ← Implementation spec for skills fix
-├── SESSION_TAGGING_SPEC.md            ← Complete tagging feature spec
-├── RESEARCH_SUMMARY.md                ← Executive summary & timeline
-└── QUICK_START_GUIDE.md               ← 5-minute quick reference
+└── docs/
+    └── research/
+        ├── RESEARCH_INDEX.md           ← YOU ARE HERE (navigation guide)
+        ├── OPENCODE_RESEARCH.md        ← Deep architecture analysis
+        ├── SKILLS_INSTALLATION_SPEC.md ← Implementation spec for skills fix
+        ├── SESSION_TAGGING_SPEC.md     ← Complete tagging feature spec
+        ├── RESEARCH_SUMMARY.md         ← Executive summary & timeline
+        └── QUICK_START_GUIDE.md        ← 5-minute quick reference
 ```
 
 ## Document Guide