Add repo hygiene layout and research indexes

REPO_LAYOUT.md

@@ -0,0 +1,50 @@
+# Repository Layout
+
+This repository mixes product code, astrology research, oracle artifacts, and local experimentation. To keep the worktree usable, follow these layout rules.
+
+## Core Areas
+
+- `/Users/wuyongnaren/Documents/印度占星/mcp_server.py`
+  - adjudicator-facing MCP entrypoint
+- `/Users/wuyongnaren/Documents/印度占星/scripts/`
+  - reusable project code and maintained tooling
+- `/Users/wuyongnaren/Documents/印度占星/tests/`
+  - maintained regression and contract tests
+- `/Users/wuyongnaren/Documents/印度占星/references/`
+  - durable knowledge assets, oracle cases, and frozen methodology
+
+## Research
+
+- `/Users/wuyongnaren/Documents/印度占星/docs/research/`
+  - active research and current audits
+- `/Users/wuyongnaren/Documents/印度占星/docs/research/archive/`
+  - historical round notes and local draft research
+
+## Local Scratch
+
+- `/Users/wuyongnaren/Documents/印度占星/scratch/local/scripts/`
+  - one-off debugging scripts, temporary probes, ad hoc runners
+- `/Users/wuyongnaren/Documents/印度占星/scratch/local/outputs/`
+  - local generated JSON, text dumps, temporary reports
+
+These paths are local-only and ignored by git.
+
+## Local Runtime Noise
+
+The following should stay out of normal versioned work:
+
+- `/Users/wuyongnaren/Documents/印度占星/.agents/`
+- `/Users/wuyongnaren/Documents/印度占星/venv_vedastro/`
+- `/Users/wuyongnaren/Documents/印度占星/scratch/local/`
+
+## Practical Rule
+
+Before adding a new file, decide which lifecycle it belongs to:
+
+1. reusable project asset
+2. active research note
+3. archived research
+4. local scratch script
+5. local generated output
+
+If it is category 4 or 5, do not leave it in the repo root.