dodoxandClaude Sonnet 5
12d26c5d68
CLAUDE.md/docs/library.md updated to match the sell.py/parkcash.py/ scan.py changes in the preceding commits. docs/decisions.md gets the full reasoning trail: the Black-Scholes closed form marked superseded, the actual backtest entry (BHP/AL touch-probability table) that both sell.py and library.md already cited but was never written, the discretization-bias caveat on that backtest, the price-impact-cap and demolition-value decisions. docs/roadmap.md pruned back to open items only - finished work is discoverable from CLAUDE.md/library.md/ decisions.md instead of staying listed as a done backlog entry. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
PuGa
A recursively self-improving harness for Claude and humans for the game Prosperous Universe. You ask questions in plain language; Claude answers by running the tools in this repo against live market data and your own company data, instead of guessing - and when it catches itself doing the same ad-hoc work by hand more than once, it builds a tool for it instead, so the harness keeps getting sharper the more it's used.
what should I build next?
is a second smelter still worth it, or is the AL market full?
simulate adding a CHP to Deimos before I spend anything
how long until Nike runs out of RAT?
where do I post 40 BHP so it actually clears today?
Name origin: Plutonium–gallium alloy (Pu–Ga) is a specialized metallic blend of plutonium and gallium primarily used to stabilize the desirable delta (δ) phase of plutonium at room temperature.
What it can do
- Find what to build. Every recipe, but with market depth: how many buildings the market absorbs, what you'd really get for the output, and whether the margin has held for months or is a spike.
- Simulate before you spend. A replica of the PRUNplanner simulator, verified against the real thing. Marginal payback of one more building, and a warning if it overloads your housing.
- Watch your position. Cash, permits, buildings, storage and ships synced from FIO. Runway per material, cash-aware shopping lists, multi-base chains with real freight.
- Trade. Where to post an ask, how to split it, how long it takes to clear, where idle cash can sit meanwhile.
- Talk to PRUNplanner. Reads your plans, writes new ones, picks up edits you make in the web UI. Only touches plans it created.
Every number is an estimate from public and personal game data. Prices move; re-run before acting.
Quick start
git clone <repo-url> PuGa && cd PuGa
python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
cp .env.example .env # FIO and PRUNplanner keys, see docs/usage.md
claude # open Claude Code here and ask
Every tool is also a command: puga scan, puga simulate plan.yaml, puga sell BHP 40. Tool list, setup and layout: docs/usage.md. Verified game mechanics and the market model: docs/.
Your own empire (profile, state, plans, notes) lives in the gitignored empire/ folder, so the repo stays public.
Not affiliated with Prosperous Universe, FIO or PRUNplanner.