@complexthings/superpowers-agent 9.2.0 → 10.0.0

package/.agents/superpowers-bootstrap.md

@@ -4,7 +4,7 @@
 You have superpowers. Superpowers teach you new skills and capabilities.
 
 **Tool for running skills:**
-- `superpowers-agent execute <skill-name>`
+- Use your platform's native skill tool, or read the skill's `SKILL.md` directly.
 
 **Platform-specific tool mappings:**
 Tool mappings for your detected platforms are automatically included in your platform-specific configuration files:
@@ -26,8 +26,8 @@ Project skills override Claude skills, which override personal skills, which ove
 
 **Critical Rules:**
 - Before ANY task, review the skills list (shown at bootstrap)
-- If a relevant skill exists, you MUST use `superpowers-agent execute` to load it and follow instructions.
-  - YOU MUST USE YOUR `Read` TOOL TO READ THE SKILL FILE FROM THE PATH SHOWN. YOU MUST NOT `cat` the file or `print` it to yourself.
+- If a relevant skill exists, you MUST load it with your platform's native skill tool and follow its instructions.
+  - YOU MUST USE YOUR `Read` TOOL TO READ THE SKILL FILE. YOU MUST NOT `cat` or print it to yourself.
 - Announce: "I've read the [Skill Name] skill and I'm using it to [purpose]"
 - Skills with checklists require `manage_todo_list` todos for each item (or manual tracking if unavailable)
 - NEVER skip mandatory workflows (brainstorming before coding, TDD, systematic debugging)

package/.agents/templates/AGENTS.md.template

@@ -1,50 +1,27 @@
 ## 🎯 SKILLS
 
-Skills extend your capabilities with proven workflows.
+[superpowers-agent Docs](.agents/docs/SUPERPOWERS.md)
 
-### Discover Skills First
-
-**Before starting any task**, check for relevant skills:
-1. Use your native skill tool to list available skills.
-2. Review skill descriptions/frontmatter to identify relevant ones.
-
-### 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.
-
-**Skill priority (highest to lowest):** Project → Personal
-
-### Using Tools with Skills
-
-1. **Native skill tool** — load skills via your platform's native skill tool.
-2. **Symlinked skills** — Superpowers skills are symlinked into your platform's skills directory.
-3. **Fallback** — if a skill isn't found via the native tool, run `superpowers-agent find-skills [PATTERN]`.
-4. **Tool equivalence** — when a skill references a tool you don't have, substitute your equivalent.
-
-### Why Skills Matter
-
-Skills encode proven techniques that prevent mistakes. Not using them means repeating solved problems and missing edge cases.
-
-**If a skill exists for your task, you MUST use it.**
+- Skills encode proven techniques that prevent mistakes.
+   - Not using them means repeating solved problems and missing edge cases.
+   - If a skill exists for your task, you MUST use it.
+- **Before starting any task**, check for relevant skills, use your native skill tool to do so.
+- Review skill descriptions/frontmatter to identify relevant ones.
+— when a skill references a tool you don't have, substitute your equivalent.
 
 ---
 
 ## Version Check
 
-Periodically, e.g. once per day check the version of superpowers-agent:
-1. **CURRENT_VERSION** — run a `superpowers-agent` command and extract `X.Y.Z` from the `^^SAV:X.Y.Z^^` string in its output.
+Once per day, check for updates:
+1. **CURRENT_VERSION** — run any `superpowers-agent` command, extract `X.Y.Z` from `^^SAV:X.Y.Z^^` in the 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:
+3. Compare by semver, not string order (`9.10.0` > `9.9.0`). If newer, tell the user — don't 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.
+   Match, or a lookup fails → stay silent.
 
 ---
-
-*Generated by Superpowers on {{DATE}}*

package/.agents/templates/SUPERPOWERS.md.template

@@ -14,16 +14,16 @@ If `superpowers-agent` is not available, install it: `npm install -g @complexthi
 
 ## Version Check
 
-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.
+Once per day, check for updates:
+1. **CURRENT_VERSION** — run `superpowers-agent version`, extract `X.Y.Z` from the 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:
+3. Compare by semver, not string order (`9.10.0` > `9.9.0`). If newer, tell the user — don't 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.
+   Match, or a lookup fails → stay silent.
 
 ---
 

package/.github/copilot-instructions.md

@@ -1,3 +1,35 @@
 <!-- SUPERPOWERS_-_INSTRUCTIONS_START -->
-${content}
+# Superpowers Skills
+
+[superpowers-agent Docs](../.agents/docs/SUPERPOWERS.md)
+
+Use your platform's native skill tool to discover and load installed skills relevant to the task. If no native tool is available, inspect the configured skill directories and read the needed `SKILL.md` file.
 <!-- SUPERPOWERS_-_INSTRUCTIONS_END -->
+
+<!-- rtk-instructions v2 -->
+# RTK — Token-Optimized CLI
+
+**rtk** is a CLI proxy that filters and compresses command outputs, saving 60-90% tokens.
+
+## Rule
+
+Always prefix shell commands with `rtk`:
+
+```bash
+# Instead of:              Use:
+git status                 rtk git status
+git log -10                rtk git log -10
+cargo test                 rtk cargo test
+docker ps                  rtk docker ps
+kubectl get pods           rtk kubectl pods
+```
+
+## Meta commands (use directly)
+
+```bash
+rtk gain              # Token savings dashboard
+rtk gain --history    # Per-command savings history
+rtk discover          # Find missed rtk opportunities
+rtk proxy <cmd>       # Run raw (no filtering) but track usage
+```
+<!-- /rtk-instructions -->

package/.github/hooks/rtk-rewrite.json

@@ -0,0 +1,22 @@
+{
+  "version": 1,
+  "hooks": {
+    "PreToolUse": [
+      {
+        "type": "command",
+        "command": "rtk hook copilot",
+        "cwd": ".",
+        "timeout": 5
+      }
+    ],
+    "preToolUse": [
+      {
+        "type": "command",
+        "bash": "rtk hook copilot",
+        "powershell": "rtk hook copilot",
+        "cwd": ".",
+        "timeoutSec": 5
+      }
+    ]
+  }
+}

package/AGENTS.md

@@ -8,41 +8,24 @@ Skills extend your capabilities with proven workflows.
 ### Discover Skills First
 
 **Before starting any task**, check for relevant skills:
-1. Use your native skill tool to list available skills
-2. Review skill frontmatter/descriptions to identify relevant ones
-3. `superpowers-agent find-skills [PATTERN]` for superpowers skills
+1. Use your native skill tool to list available skills.
+2. Review skill descriptions/frontmatter to identify relevant ones.
 
-### Load Just-In-Time
+### Skill Loading Rules
 
-Only read the full skill content when you're ready to execute it:
-1. **Load fully** when about to use (not before)
-2. **Follow exactly** as written
-3. **Announce:** "Using Skill: {Name} to {Purpose}"
+- 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.
 
-### Using Tools with Skills
-
-**1. Native Skill Tool:** Use your platform's native skill tool for loading skills.
-
-**2. Symlinked Skills:** Superpowers skills are symlinked to your platform's skills directory.
-
-**3. Fallback:** If a skill isn't found via native tool, use `superpowers-agent find-skills [PATTERN]`
-
-**4. Tool Equivalence:** When skills reference tools you don't have, use your equivalent:
-   - File operations -> your Read/Write/Edit tools
-   - Terminal commands -> your Bash/Shell tool
-   - Search operations -> your Grep/Glob/Search tools
-   - Task management -> your TodoWrite/TodoRead tools
-   - Subagent dispatch -> your Task/Agent tool (or execute the work yourself)
-   - Web fetching -> your WebFetch/Fetch tool
-
-### Version Monitoring
+**Skill priority (highest to lowest):** Project → Personal
 
-**Bootstrapped:** ^^SAV:7.1.2^^
+### Using Tools with Skills
 
-If superpowers-agent commands show a different version, inform user:
-```
-superpowers-agent update && superpowers-agent bootstrap && superpowers-agent setup-skills
-```
+1. **Native skill tool** — load skills via your platform's native skill tool.
+2. **Symlinked skills** — Superpowers skills are symlinked into your platform's skills directory.
+3. **Fallback** — if a skill isn't found via the native tool, inspect the configured skill directories and read its `SKILL.md` directly.
+4. **Tool equivalence** — when a skill references a tool you don't have, substitute your equivalent.
 
 ### Why Skills Matter
 
@@ -52,10 +35,22 @@ Skills encode proven techniques that prevent mistakes. Not using them means repe
 
 ---
 
-**Detailed reference for `superpowers-agent` if needed by agents:** `.agents/docs/SUPERPOWERS.md`
+## Version Check
 
-*Generated by Superpowers on 2026-03-13*
+Periodically, e.g. once per day check the version of superpowers-agent:
+1. **CURRENT_VERSION** — run a `superpowers-agent` command and extract `X.Y.Z` from the `^^SAV: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.
 
+---
+
+*Generated by Superpowers on 2026-07-12*
 <!-- SUPERPOWERS_SKILLS_END -->
 
 ## What This Project Is
@@ -81,7 +76,7 @@ The CLI has **no runtime dependencies** (pure Node.js/Bun built-ins). The only d
 
 ## Testing
 
-There is **no automated test runner** and no `test` script. Verification is manual: run the CLI commands directly, or drive the saved prompt scenarios in `.agents/prompts/`. State this plainly rather than inventing a test command.
+Run the automated test suite from `.agents` with `bun test`. There is no root-level test script; run CLI commands directly for manual acceptance checks.
 
 ## Architecture
 
@@ -109,15 +104,14 @@ From `.agents/src/cli.js` dispatch table:
 
 - **Core:** `bootstrap [--no-update] [--force]`, `version`, `check-updates`, `update [--no-reinstall]`
 - **Config:** `config-get`, `config-set <key> <value>`
-- **Skills:** `setup-skills`, `find-skills [pattern]`, `use-skill <name>`, `execute <name>`, `dir <name>`, `path <name>`, `get-helpers <skill> <search-term>`
+- **Skills:** `setup-skills`, `session-context [--format=claude|copilot|raw]`
 - **Install/manage skills:** `add <url-or-path|@alias> [path]`, `add-repository <git-url> [--as=@alias]`, `list-repositories`, `pull <url-or-path|@alias>`, `rm <url-or-path|@alias>`
 - **Integrations:** `install-cursor-hooks`, `install-aliases`
 
 ### Key Flows
 
 - **`bootstrap`** → detects installed AI platforms → symlinks skills into each platform's skills dir → writes platform config files
-- **`find-skills [pattern]`** → searches all three skill tiers → returns name/path/description
-- **`execute <skill-name>`** → locates skill → outputs SKILL.md content for the agent to follow
+- **Native skill tools** → discover and load skills from their configured directories
 - **`add <url-or-path|@alias>`** → clones a git repo or copies a local path → installs skills into `~/.agents/superpowers/skills/`
 - **`update`** → checks the npm registry for a newer version → reports if an update is available
 
@@ -155,3 +149,5 @@ The five canonical triage roles use their default label strings (`needs-triage`,
 ### Domain docs
 
 Single-context layout — one `CONTEXT.md` + `docs/adr/` at the repo root (created lazily). See `docs/agents/domain.md`.
+
+@RTK.md