Godstrument/CLAUDE.md
2026-07-13 12:15:38 +10:00

1.5 KiB

Godstrument — Claude context

Music-instrument web app; hosted at godstrument.pro on the botchat VPS (humanjing@100.71.119.27, exposed via Cloudflare Tunnel — NOT dealgod, despite earlier notes). App dir /home/humanjing/godstrument (not a git checkout). Deploy = rsync git-tracked files only, minus dev docs/scripts (--files-from=<(git ls-files | grep -vE '^(CLAUDE\.md|README\.md|.*_BRIEF\.md|GODSTRUMENT_MANUAL_SOURCE\.md|godstrument\.txt|build_manual\.py|test_.*\.py)$'), never --delete, never push godstrument_users.db/auth_secret/patches/) then sudo -n systemctl restart godstrument. The user manual ships as viz/manual.html (served at godstrument.pro/manual.html), generated from the in-app grimoire by python3 build_manual.py — re-run it after editing the grimoire. Working notes/planning docs stay OUT of the deploy. Origin is Gitea ssh://git@100.71.119.27:222/monster/Godstrument.git. See godstrument-pro-deploy.

  • Canon gotcha: the real spec prose lives in viz/index.html (grimoire text around line ~950); GODSTRUMENT_MANUAL_SOURCE.md claims to be exhaustive but has drifted before (Earth Echo / Schumann layer was missing). When they disagree, viz/index.html is truth — update the manual to match, not the other way.
  • Secrets (Cloudflare token etc.): read from .env/local files, never from chat. A CF token was pasted in chat once and rolled — don't repeat that.
  • First page load after a deploy is slow (cold start) — wait before declaring it broken.