From 8c247c7ea4f4a3f4d50b7774399b43c9732deefc Mon Sep 17 00:00:00 2001
From: Dominik Roth <mail@dominik-roth.eu>
Date: Thu, 8 Oct 2026 18:56:42 +0200
Subject: [PATCH] Rebrand as a self-improving harness; add the self-improve
 rule to CLAUDE.md

Slogan now frames PuGa as a harness that gets sharper through use, not
just a static set of tools - matches how route/whatif/chain-consumers/
planet.py actually got built this session (noticing repeated ad-hoc
work and promoting it into a tool). Codifies that loop as a standing
instruction so it keeps happening without being asked each time.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 CLAUDE.md | 3 +++
 README.md | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index e449d44..e1e3ab1 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -35,6 +35,9 @@ Agent-first toolkit for advising a Prosperous Universe player. The player asks q
 ## Library use (not just CLI)
 For anything the CLI tools don't expose (custom what-ifs, cost breakdowns with wages/capex, ad-hoc market checks) import `puga.*` directly in a short inline script instead of stretching a tool's flags. See `docs/library.md` for the module map and patterns; most non-trivial answers in this project came from a `python - <<EOF` block, not a CLI flag.
 
+## Self-improve the harness
+If you catch yourself writing similar ad-hoc `python - <<EOF` code for the same kind of workload more than once in a session (a reverse recipe lookup, a planet/resource search, a marginal-ROI diff, a jump-distance check), stop and abstract it into a `puga/` function plus a `tools/*.py` CLI instead of repeating it by hand again. This is exactly how `tools/route.py`, `tools/whatif.py`, `tools/chain.py --consumers` and `tools/planet.py` got built - noticing the repeated-by-hand pattern, then promoting it. Register the new tool in this file's Tools list and in `docs/roadmap.md`; add a matching entry to `docs/library.md` if it's a new `puga/` module. This is the harness improving itself through use, not a one-off - keep doing it.
+
 ## Tools
 Run as `puga <tool> ...` (e.g. `puga scan --min-n 3`, `puga plan pull <uuid>`); the `tools/x.py` paths below are the same programs.
 - `tools/state.py sync|show` refreshes `empire/state/company.yaml` from live FIO (cash, permits, buildings, real production efficiency, storage, ships).
diff --git a/README.md b/README.md
index 971ce54..bce305b 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
   <br><br>
 </h1>
 
-A set of tools and know-how for Claude (Claude Code) to assist in the game [Prosperous Universe](https://prosperousuniverse.com), usable by humans too. 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.
+A recursively self-improving harness for Claude and humans for the game [Prosperous Universe](https://prosperousuniverse.com). 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.
 
 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.