Jyotisha/REPO_LAYOUT.md

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.