mirror of
https://github.com/obra/superpowers.git
synced 2026-09-01 03:19:24 +00:00
Compare commits
3 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 2783fb9145 | |||
| d3f0f13a87 | |||
| 96c005307e |
@@ -9,7 +9,7 @@
|
|||||||
{
|
{
|
||||||
"name": "superpowers",
|
"name": "superpowers",
|
||||||
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
|
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
|
||||||
"version": "6.3.0",
|
"version": "6.2.0",
|
||||||
"source": "./",
|
"source": "./",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Jesse Vincent",
|
"name": "Jesse Vincent",
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "superpowers",
|
"name": "superpowers",
|
||||||
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
|
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
|
||||||
"version": "6.3.0",
|
"version": "6.2.0",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Jesse Vincent",
|
"name": "Jesse Vincent",
|
||||||
"email": "jesse@fsck.com"
|
"email": "jesse@fsck.com"
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "superpowers",
|
"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.",
|
"description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Jesse Vincent",
|
"name": "Jesse Vincent",
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
"name": "superpowers",
|
"name": "superpowers",
|
||||||
"displayName": "Superpowers",
|
"displayName": "Superpowers",
|
||||||
"description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
|
"description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
|
||||||
"version": "6.3.0",
|
"version": "6.2.0",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Jesse Vincent",
|
"name": "Jesse Vincent",
|
||||||
"email": "jesse@fsck.com"
|
"email": "jesse@fsck.com"
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "superpowers",
|
"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.",
|
"description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Jesse Vincent",
|
"name": "Jesse Vincent",
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
name: superpowers
|
name: superpowers
|
||||||
version: 6.3.0
|
version: 6.2.0
|
||||||
description: Superpowers skills and workflow bootstrap for Hermes Agent
|
description: Superpowers skills and workflow bootstrap for Hermes Agent
|
||||||
author: obra
|
author: obra
|
||||||
provides_hooks:
|
provides_hooks:
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "superpowers",
|
"name": "superpowers",
|
||||||
"version": "6.3.0",
|
"version": "6.2.0",
|
||||||
"description": "An agentic skills framework and software development methodology.",
|
"description": "An agentic skills framework and software development methodology.",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Jesse Vincent",
|
"name": "Jesse Vincent",
|
||||||
|
|||||||
@@ -4,9 +4,10 @@ Superpowers is a complete software development methodology for your coding agent
|
|||||||
|
|
||||||
## Table of Contents
|
## Table of Contents
|
||||||
|
|
||||||
|
- [Quickstart](#quickstart)
|
||||||
- [How it works](#how-it-works)
|
- [How it works](#how-it-works)
|
||||||
- [Commercial Services](#commercial-services)
|
- [Commercial Services](#commercial-services)
|
||||||
- [Getting Started](#installation)
|
- [Installation](#installation)
|
||||||
- [Claude Code](#claude-code)
|
- [Claude Code](#claude-code)
|
||||||
- [Antigravity](#antigravity)
|
- [Antigravity](#antigravity)
|
||||||
- [Codex App](#codex-app)
|
- [Codex App](#codex-app)
|
||||||
@@ -17,10 +18,11 @@ Superpowers is a complete software development methodology for your coding agent
|
|||||||
- [Gemini CLI](#gemini-cli)
|
- [Gemini CLI](#gemini-cli)
|
||||||
- [GitHub Copilot CLI](#github-copilot-cli)
|
- [GitHub Copilot CLI](#github-copilot-cli)
|
||||||
- [Grok Build CLI](#grok-build-cli)
|
- [Grok Build CLI](#grok-build-cli)
|
||||||
|
- [Hermes Agent](#hermes-agent)
|
||||||
- [Kimi Code](#kimi-code)
|
- [Kimi Code](#kimi-code)
|
||||||
- [OpenCode](#opencode)
|
- [OpenCode](#opencode)
|
||||||
- [Pi](#pi)
|
- [Pi](#pi)
|
||||||
- [Hermes Agent](#hermes-agent)
|
- [Qwen Code](#qwen-code)
|
||||||
- [The Basic Workflow](#the-basic-workflow)
|
- [The Basic Workflow](#the-basic-workflow)
|
||||||
- [Community](#community)
|
- [Community](#community)
|
||||||
- [What's Inside](#whats-inside)
|
- [What's Inside](#whats-inside)
|
||||||
@@ -30,6 +32,10 @@ Superpowers is a complete software development methodology for your coding agent
|
|||||||
- [License](#license)
|
- [License](#license)
|
||||||
- [Visual companion telemetry](#visual-companion-telemetry)
|
- [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
|
## 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.
|
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
|
/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
|
### Kimi Code
|
||||||
|
|
||||||
Superpowers is available in Kimi Code's plugin marketplace.
|
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.
|
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
|
- Install the plugin from this repository, and pick `superpowers` when prompted:
|
||||||
hermes plugins install obra/superpowers --enable
|
|
||||||
```
|
|
||||||
|
|
||||||
Restart any active Hermes sessions after installing. Note: Hermes has no
|
```bash
|
||||||
post-compaction hook, so a very long session that compacts over its first
|
qwen extensions install obra/superpowers
|
||||||
turn loses the bootstrap — start a fresh session if skills stop triggering.
|
```
|
||||||
|
|
||||||
|
- Update later:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
qwen extensions update superpowers
|
||||||
|
```
|
||||||
|
|
||||||
## The Basic Workflow
|
## The Basic Workflow
|
||||||
|
|
||||||
|
|||||||
@@ -1,44 +1,5 @@
|
|||||||
# Superpowers Release Notes
|
# 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)
|
## v6.2.0 (2026-07-23)
|
||||||
|
|
||||||
### Subagent-Driven Development
|
### Subagent-Driven Development
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "superpowers",
|
"name": "superpowers",
|
||||||
"description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
|
"description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
|
||||||
"version": "6.3.0",
|
"version": "6.2.0",
|
||||||
"contextFileName": "GEMINI.md"
|
"contextFileName": "GEMINI.md"
|
||||||
}
|
}
|
||||||
|
|||||||
+1
-1
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "superpowers",
|
"name": "superpowers",
|
||||||
"version": "6.3.0",
|
"version": "6.2.0",
|
||||||
"description": "Superpowers skills and runtime bootstrap for coding agents",
|
"description": "Superpowers skills and runtime bootstrap for coding agents",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"main": ".opencode/plugins/superpowers.js",
|
"main": ".opencode/plugins/superpowers.js",
|
||||||
|
|||||||
@@ -25,7 +25,7 @@ Dispatch a code reviewer subagent to catch issues before they cascade. The revie
|
|||||||
|
|
||||||
**1. Get git SHAs:**
|
**1. Get git SHAs:**
|
||||||
```bash
|
```bash
|
||||||
BASE_SHA=$(git rev-parse HEAD~1) # or: git merge-base origin/main HEAD
|
BASE_SHA=$(git rev-parse HEAD~1) # or origin/main
|
||||||
HEAD_SHA=$(git rev-parse HEAD)
|
HEAD_SHA=$(git rev-parse HEAD)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user