refactor!: rename project to bot-bottle

Assisted-by: Codex

docs/research/polish-priorities.md

@@ -1,7 +1,7 @@
 # Closing the maturity gap: polish priorities
 
 Research into what would close the perceived maturity gap between
-claude-bottle and a "polished" comparable like claudebox. Motivated
+bot-bottle and a "polished" comparable like claudebox. Motivated
 by adopter feedback citing first-run friction, manifest authoring,
 and distribution as the dominant obstacles to recommending the tool
 to others.
@@ -33,11 +33,11 @@ on top of working onboarding.
 ### Onboarding friction
 
 A first-time user today goes through five steps: install Docker,
-install `uv`, set `CLAUDE_BOTTLE_OAUTH_TOKEN`, write
-`claude-bottle.json`, run `./cli.py start`. One of those is
+install `uv`, set `BOT_BOTTLE_OAUTH_TOKEN`, write
+`bot-bottle.json`, run `./cli.py start`. One of those is
 "author a JSON manifest." Polished tools in this category let
 users skip that step on day one. The fix is an `init` subcommand
-that drops a working `claude-bottle.json` with a default `coder`
+that drops a working `bot-bottle.json` with a default `coder`
 bottle/agent into the user's home directory and prints the next
 command to run.
 
@@ -45,14 +45,14 @@ command to run.
 
 Missing Docker, missing OAuth token, manifest typo, image build
 failure — each should print a one-line fix rather than a stack
-trace. claudebox handles this well; claude-bottle currently exits
+trace. claudebox handles this well; bot-bottle currently exits
 on `die()` calls that vary in helpfulness. A focused pass over
 every `die()` site, ensuring each message says what failed *and*
 what to do, is cheap and compounds across every user interaction.
 
 ### Distribution
 
-`brew install claude-bottle` or `curl | sh`, not "clone the repo,
+`brew install bot-bottle` or `curl | sh`, not "clone the repo,
 install Python deps, `chmod cli.py`." The single highest-leverage
 polish item, and the one that interacts with the language choice
 covered in `bash-vs-python-vs-go.md`. Staying on Python means a
@@ -69,7 +69,7 @@ small; the signal value is large.
 
 ### Schema
 
-A JSON schema for `claude-bottle.json` published with a `$schema`
+A JSON schema for `bot-bottle.json` published with a `$schema`
 URL gives VSCode and Cursor users autocomplete and inline
 validation. ~½ day to author the schema, plus a few hours to
 publish it where editors can fetch it.