@complexthings/superpowers-agent 9.1.0 → 9.2.1

package/.agents/docs/SUPERPOWERS.md

@@ -1,42 +1,37 @@
 # SUPERPOWERS Reference Guide
 
-You are an autonomous agent with access to the `superpowers-agent` system. Reference documentation is in the `AGENTS.md` and the detailed reference guide below.
+You are an autonomous agent with access to the `superpowers-agent` system.
 
-> This is detailed reference documentation for the superpowers-agent system.
-> Load this file only when you need specific information not covered in AGENTS.md.
-
-**Bootstrapped Version:** `^^SAV:7.1.2^^`
+> Loaded at conversation start. `AGENTS.md` is the primary reference; this guide is the detailed supplement.
 
 ---
 
 ## Installation
 
-If `superpowers-agent` is not available, install it:
-
-```bash
-npm install -g @complexthings/superpowers-agent
-```
+If `superpowers-agent` is not available, install it: `npm install -g @complexthings/superpowers-agent`
 
 ---
 
 ## Version Check
 
-At conversation start:
-1. Run a superpowers-agent command and note the version string `^^SAV:X.Y.Z^^` in output
-2. Compare against bootstrapped version `^^SAV:7.1.2^^`
-3. If they differ, notify the user:
-   Your superpowers-agent may have updates. Run:
-   ```sh
-   superpowers-agent update && superpowers-agent bootstrap && superpowers-agent setup-skills
-   ```
+Periodically, e.g. once per day check the version of superpowers-agent:
+1. **CURRENT_VERSION** — run a `superpowers-agent version` command and extract `X.Y.Z` from the `X.Y.Z` string in its output.
+2. **NPM_LATEST_VERSION** — run `npm view @complexthings/superpowers-agent version`.
+3. Compare by **semver precedence, not string comparison** (e.g. `9.10.0` > `9.9.0`). If NPM_LATEST_VERSION is newer, tell the user — do not run these yourself:
+   > Your superpowers-agent has updates (`CURRENT_VERSION` → `NPM_LATEST_VERSION`). Run:
+   > ```sh
+   > npm install -g @complexthings/superpowers-agent
+   > superpowers-agent update && superpowers-agent bootstrap && superpowers-agent setup-skills
+   > ```
+   If versions match, or either lookup fails (e.g. no network), continue silently.
 
 ---
 
 ## Skill Loading Rules
 
-- Load skills **JIT only** — never preload to "understand" them
-- Follow skill instructions **exactly as written** — no skimming, no shortcuts
-- If a skill has a checklist, create a todo for **each item** — no mental tracking
-- Simple tasks benefit from skills as much as complex ones
+- Load skills **JIT only** — never preload to "understand" them.
+- Follow skill instructions **exactly as written** — no skimming, no shortcuts.
+- If a skill has a checklist, create a todo for **each item** — no mental tracking.
+- Simple tasks benefit from skills as much as complex ones.
 
-**Skill priority (highest to lowest):** Project → Personal → Superpowers
+**Skill priority (highest to lowest):** Project → Personal → Superpowers