solargod/CLAUDE.md

SOLARGOD — Claude context

Standalone browser-based 3D solar system explorer (Three.js, no build step). The complete execution spec is SOLARGOD_BRIEF.md — read it in full before coding; it contains the authoritative JPL element tables, verification checkpoints with Horizons ground truth, the stage plan, and the known traps.

• Sibling project & architecture reference: /Users/m3ultra/Documents/GODSIGH (CesiumJS OSINT globe, port 8137) — read-only, never modify it. Port its idioms (layer contract, HUD, hash state, serve.py proxy), not its code verbatim.
• Run: python3 serve.py → http://127.0.0.1:8147 (stdlib only, no deps).
• Origin: Gitea ssh://git@100.71.119.27:222/monster/solargod.git, default branch main. Branch per stage (stage/N-name), merge on green gate, push. Commits: emoji prefix + short message + (opus) suffix.
• Verification gates in verify.html are mandatory per stage — measurement beats reasoning; never trust remembered constants over a fetched JPL value.
• cache/ is serve.py's disk cache — gitignored, never commit it.
• Keep committed assets lean (~25 MB texture budget) and attribute CC BY sources in assets/textures/CREDITS.md + the HUD footer.
• Local unlimited image generation: MODELBEAST at /Users/m3ultra/Documents/MODELBEAST (FLUX on-device via mb CLI) — see brief §7b. Credential is pre-provisioned: source ~/Documents/MODELBEAST/data/agent.env. Truth boundary: real worlds get real NASA textures; FLUX only paints the aesthetic layer (splash, grimoire cards, sprites).