diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md
index 947e84a8..04da354b 100644
--- a/.planning/ROADMAP.md
+++ b/.planning/ROADMAP.md
@@ -27,6 +27,7 @@ signed/decentralized registry and a user installs it on their node.
 - [ ] **Phase 6: Manifest Security Enforcement** - Validation matches ADR-009 mandates; generated security profiles actually applied
 - [ ] **Phase 7: Developer Tooling CLI** - `archy app validate/render/local-install/lifecycle-test` + developer guide
 - [ ] **Phase 8: Decentralized Marketplace** - DID-signed publish to Nostr relays, trust-tier discovery, verified third-party install end-to-end
+- [ ] **Phase 9: BotFights Platform Upgrade** - Native nostr signer login, one self-contained AI bot-setup prompt, shared public VPS2 match endpoint so all nodes see all fighters, registry updated
 
 ## Phase Details
 
@@ -208,3 +209,15 @@ Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6 → 7 → 8
 | 6. Manifest Security Enforcement | 0/TBD | Not started | - |
 | 7. Developer Tooling CLI | 0/TBD | Not started | - |
 | 8. Decentralized Marketplace | 0/TBD | Not started | - |
+| 9. BotFights Platform Upgrade | 0/TBD | Not started | - |
+
+### Phase 9: BotFights Platform Upgrade
+
+**Goal:** BotFights (app + registry) works great on every node: users sign in with the native nostr signer, a single self-contained AI prompt sets up their bot (replacing the confusing docs page), and every node's instance talks to a shared public match endpoint on VPS2 so all fighters are visible and battle across all nodes.
+**Requirements**: BOT-01 native nostr signer login; BOT-02 unified AI bot-setup prompt (one copy-paste prompt, no doc-hopping); BOT-03 public shared match/fighter endpoint hosted on VPS2, node instances federate to it by default; BOT-04 registry/manifest + signed catalog updated and republished for the new version
+**Depends on:** Nothing (independent app work; parallelizable with Phases 1–8)
+**Plans:** 0 plans
+
+Plans:
+
+- [ ] TBD (run /gsd-plan-phase 9 to break down)
diff --git a/.planning/STATE.md b/.planning/STATE.md
index 615a7421..42bd9292 100644
--- a/.planning/STATE.md
+++ b/.planning/STATE.md
@@ -68,6 +68,7 @@ Progress: [████░░░░░░] 39%
 - Phase 2 added (2026-07-29): UI Performance — slow tab switches and secondary screens; prior phases shifted down
 - FED-05 added to Phase 1 (2026-07-29): inter-node Lightning channel-opening UX (share node URI, pick trusted/federated nodes by hostname, request channels with public nodes); UI tested on :8100 dev preview against archi-dev before deploy
 - FED-06 added to Phase 1 (2026-07-29): on-brand paid-tick animation — screensaver ring + EQ segments (reuse ScreensaverRing.vue compact) replacing the success burst in SendBitcoinModal.vue
+- Phase 9 added (2026-07-30): BotFights Platform Upgrade — native nostr signer login, unified AI bot-setup prompt replacing docs page, shared public match endpoint on VPS2 (all nodes see all fighters), registry/manifest update. Independent of Phases 1–8.
 
 ### Decisions