docs: drop Hermes post-compaction caveat from README install block

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
docs: add Hermes Agent to TOC and fix section order
2026-08-12 18:15:44 +00:00 · 2026-08-07 16:50:31 -07:00 · 2026-08-07 16:37:51 -07:00 · 2026-08-07 16:02:02 -07:00
11 changed files with 39 additions and 58 deletions
@@ -9,7 +9,7 @@
    {
      "name": "superpowers",
      "description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
-      "version": "6.3.0",
+      "version": "6.2.0",
      "source": "./",
      "author": {
        "name": "Jesse Vincent",
@@ -1,7 +1,7 @@
 {
  "name": "superpowers",
  "description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
-  "version": "6.3.0",
+  "version": "6.2.0",
  "author": {
    "name": "Jesse Vincent",
    "email": "jesse@fsck.com"
@@ -1,6 +1,6 @@
 {
  "name": "superpowers",
-  "version": "6.3.0",
+  "version": "6.2.0",
  "description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.",
  "author": {
    "name": "Jesse Vincent",
@@ -2,7 +2,7 @@
  "name": "superpowers",
  "displayName": "Superpowers",
  "description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
-  "version": "6.3.0",
+  "version": "6.2.0",
  "author": {
    "name": "Jesse Vincent",
    "email": "jesse@fsck.com"
@@ -1,6 +1,6 @@
 {
  "name": "superpowers",
-  "version": "6.3.0",
+  "version": "6.2.0",
  "description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.",
  "author": {
    "name": "Jesse Vincent",
@@ -1,5 +1,5 @@
 name: superpowers
-version: 6.3.0
+version: 6.2.0
 description: Superpowers skills and workflow bootstrap for Hermes Agent
 author: obra
 provides_hooks:
@@ -1,6 +1,6 @@
 {
  "name": "superpowers",
-  "version": "6.3.0",
+  "version": "6.2.0",
  "description": "An agentic skills framework and software development methodology.",
  "author": {
    "name": "Jesse Vincent",
@@ -4,9 +4,10 @@ Superpowers is a complete software development methodology for your coding agent

 ## Table of Contents

+- [Quickstart](#quickstart)
 - [How it works](#how-it-works)
 - [Commercial Services](#commercial-services)
- [Getting Started](#installation)
+- [Installation](#installation)
  - [Claude Code](#claude-code)
  - [Antigravity](#antigravity)
  - [Codex App](#codex-app)
@@ -17,10 +18,11 @@ Superpowers is a complete software development methodology for your coding agent
  - [Gemini CLI](#gemini-cli)
  - [GitHub Copilot CLI](#github-copilot-cli)
  - [Grok Build CLI](#grok-build-cli)
+  - [Hermes Agent](#hermes-agent)
  - [Kimi Code](#kimi-code)
  - [OpenCode](#opencode)
  - [Pi](#pi)
-  - [Hermes Agent](#hermes-agent)
+  - [Qwen Code](#qwen-code)
 - [The Basic Workflow](#the-basic-workflow)
 - [Community](#community)
 - [What's Inside](#whats-inside)
@@ -30,6 +32,10 @@ Superpowers is a complete software development methodology for your coding agent
 - [License](#license)
 - [Visual companion telemetry](#visual-companion-telemetry)

+## Quickstart
+
+Give your agent Superpowers: [Claude Code](#claude-code), [Antigravity](#antigravity), [Codex App](#codex-app), [Codex CLI](#codex-cli), [Cursor](#cursor), [Devin CLI](#devin-cli), [Factory Droid](#factory-droid), [Gemini CLI](#gemini-cli), [GitHub Copilot CLI](#github-copilot-cli), [Grok Build CLI](#grok-build-cli), [Hermes Agent](#hermes-agent), [Kimi Code](#kimi-code), [OpenCode](#opencode), [Pi](#pi), [Qwen Code](#qwen-code).
+
 ## How it works

 It starts from the moment you fire up your coding agent. As soon as it sees that you're building something, it *doesn't* just jump into trying to write code. Instead, it steps back and asks you what you're really trying to do. 
@@ -197,6 +203,16 @@ Superpowers is available via the [official Grok plugin marketplace](https://gith
  /marketplace
  ```

+### Hermes Agent
+
+Install Superpowers as a Hermes plugin from this repository:
+
+```bash
+hermes plugins install obra/superpowers --enable
+```
+
+Restart any active Hermes sessions after installing.
+
 ### Kimi Code

 Superpowers is available in Kimi Code's plugin marketplace.
@@ -246,17 +262,21 @@ pi -e /path/to/superpowers

 The Pi package loads the Superpowers skills and a small extension that injects the `using-superpowers` bootstrap at session startup and again after compaction. Pi has native skills, so no compatibility `Skill` tool is required. Subagent and task-list tools remain optional Pi companion packages.

-### Hermes Agent
+### Qwen Code

-Install Superpowers as a Hermes plugin from this repository:
+Qwen Code installs plugins from Claude Code marketplaces directly.

-```bash
-hermes plugins install obra/superpowers --enable
-```
+- Install the plugin from this repository, and pick `superpowers` when prompted:

-Restart any active Hermes sessions after installing. Note: Hermes has no
-post-compaction hook, so a very long session that compacts over its first
-turn loses the bootstrap — start a fresh session if skills stop triggering.
+  ```bash
+  qwen extensions install obra/superpowers
+  ```
+
+- Update later:
+
+  ```bash
+  qwen extensions update superpowers
+  ```

 ## The Basic Workflow

@@ -1,44 +1,5 @@
 # Superpowers Release Notes

-## v6.3.0 (2026-08-12)
-
-### Harness Support
-
- **Devin CLI**: `devin plugins install obra/superpowers` now works, and skills auto-trigger at session start. (#1995)
- **Hermes Agent**: install from a git clone; skills register with Hermes' native loader and the bootstrap loads on the first turn. (#1922, #2025)
- **Grok Build CLI** added to the install docs. (#1919)
-
-### Brainstorming
-
- **Ceremony now scales to the task.** Requests are classified as spike, bounded, or architectural; small tasks skip the two-document ritual. Every path still stops for your approval before implementation. (#2063)
-
-### Subagent-Driven Development
-
- **Controllers no longer stall on plan conflicts.** Non-catastrophic conflicts and ambiguities get a recorded ruling and work continues; only destructive or irreversible actions still stop for a human. One donated session had sat blocked for almost nine hours on a question the controller could have decided. (#2077)
- **The pre-dispatch conflict scan records its checks in the ledger** instead of just asserting the plan is clean. (#2080)
- **Small same-shape tasks batch into one dispatch**, cutting subagent cost sharply on micro-task plans; batch reviews verify every file in the brief made it into the diff. (#2078)
- **Implementers and reviewers may not spawn their own subagents**, which was producing duplicate reviews. (#2059)
- **Plans carry a `Spec:` pointer** and SDD reads the spec at setup, so plan conflicts get resolved against the design instead of guessed at. (#2086)
- Reviewers re-read evidence they find illegible instead of re-running the test suite (#2089), and circuit-breaker rulings now show up in the Finish report.
-
-### Codex
-
- Subagent waits are event-driven instead of poll-heavy, spawns pin model and reasoning effort explicitly, and the multi-agent reference is corrected against Codex source. (#2060, #2061, #2062)
-
-### Finishing a Development Branch
-
- **Worktree removal no longer destroys untracked files.** When `git worktree remove` refuses because the tree holds uncommitted work, the skill stops, names the files, and asks — instead of reaching for `--force`. (#2016, #1223, #2024)
-
-### Fixes
-
- `render-graphs.js` in writing-skills works on Windows.
- Corrected Copilot CLI backgrounding guidance for Windows. (#1929, #2006)
- `bump-version.sh` covers the Hermes manifest.
-
-### Documentation
-
- README: added a table of contents and reorganized Getting Started.
-
 ## v6.2.0 (2026-07-23)

 ### Subagent-Driven Development
@@ -1,6 +1,6 @@
 {
  "name": "superpowers",
  "description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
-  "version": "6.3.0",
+  "version": "6.2.0",
  "contextFileName": "GEMINI.md"
 }
@@ -1,6 +1,6 @@
 {
  "name": "superpowers",
-  "version": "6.3.0",
+  "version": "6.2.0",
  "description": "Superpowers skills and runtime bootstrap for coding agents",
  "type": "module",
  "main": ".opencode/plugins/superpowers.js",