gigaslop/CLAUDE.md

GigaSlop — project notes for Claude

What this is

Satirical AI-datacenter tycoon game. Web-first: TypeScript + Vite + PixiJS v8. Design doctrine: the sim stays engine-agnostic — src/sim/ must never import from src/render/ or src/ui/ (a future Godot/Steam port swaps the renderer only). Fixed 10 Hz tick, deterministic (seeded rng in state, no Date.now/Math.random inside sim).

Dev loop

• npm run dev on :5173 (.claude/launch.json has the preview config).
• The Browser-pane tab is usually visibility: hidden → RAF doesn't fire. The sim is pumped by setInterval on purpose; don't move it back into RAF.
• window.__giga = debug handle {state, scene, place(), wire()} for JS-driven playtesting. Keep it working — automation depends on it.
• All balance tunables live in src/sim/balance.ts. Tune there, nowhere else.

Art pipeline (MODELBEAST)

• python3 tools/mb_gen.py [--only room|objects|slop] regenerates art on the farm (queue http://100.89.131.57:8777, token from ~/Documents/backnforth/.env). Deterministic seeds from asset slug — same slug, same image.
• Object sprites: flux_local → bg_remove_local (background:"transparent") → autocropped in place (PIL alpha-bbox, 8px pad). If you regenerate, re-crop.
• Room/grid registration: src/render/iso.ts (TILE 82x41, ORIGIN 510,346) is hand-fitted to public/assets/gen/room.png. New room image = refit constants (toggle the Grid overlay to check).
• Slop thumbnails are intentionally AI slop; titles in src/data/sloptitles.json (Ollama on m4pro was down at bake time; hand-authored — regenerate via tailnet Ollama when it's back if more are needed).

Roadmap (agreed with John 2026-08-01)

✅ M1 art-forward Tier-1 slice (save/load, naming, SFX) ✅ M2 platform-decay treadmill: platformAdapt rises per publish, throttles all view rates (up to 85%), tier-up grants relief — verified loop: publish → squeeze → train → relief. Infra: 20A sub-panel (+1500W), fiber uplink (1Gbps/8 ports), Cash Furnace (burns $1.5/s for +40% views; John's idea, keep it — endgame R&D tree should have a literal cash-conveyor upgrade). ✅ M3: VC rounds (Seed→C) with views-delta mandates — fail = -25% cash and permanent equity dilution; rival CEO events (Doomsworth/Hypeman/Freeman Weights/Poogle) on a seeded timer with timed view/price effects and a 60/40 CLAP BACK gamble. Seed goal calibrated empirically: decisive play ≈48K views/8min, goal 40K, idle ≈12K. ✅ M4 skill trees (src/sim/research.ts is the single source of truth; sim reads one computeMods() bundle — add nodes there, never special-case sim): • Model Lab (L): gen ladder is now bought from the training bank; modality branch (voice→image→video→A/V, richer = more views but pricier videos); one exclusive spec per gen (engagement/stealth/efficient, cleared on gen-up); data source own/scraped/licensed — own rolls 35% MODEL COLLAPSE (half revenue + all-gibberish titles for that gen), scraped attracts lawsuits, licensed bills per token. • Corporate R&D (R): perk point per closed VC round + cash; Ops/Growth/ Legal branches; capstones Diesel Backup (grace+auto-reset, no checkpoint corruption), THE CONVEYOR (10% gross income burned, +50% views), Regulatory Capture (lawsuit immune, 2x adapt decay). • Sockets: click device → inspector panel (stats, on/off, sell, 2 upgrade slots: fans/undervolt/risers). → M5 candidates: hazards (thermal runaway fire), Tier 2 garage move (bigger room = new backdrop + grid refit), subscribers/SaaS second revenue stream with churn, endgame Conveyor visual (belt sprite). Design pillars (John-approved framing): Throughput, Allocation, Attention, Capital, Expansion. Macro layer (Tier 4-5) = strategic map, NOT city-builder. Cut until earned: Tiers 3–5, immersion cooling, offshore ships, lobbying.