Goal: Finish PR #1720's final hardening fixup with test-first changes, clean rebase state, and reviewer-ready evidence. Spec: docs/superpowers/specs/2026-06-11-visual-companion-final-hardening-fixup-design.md Architecture: Keep the companion zero-dependency and local-first.
Browser-based visual brainstorming companion for showing mockups, diagrams, and options. The test: would the user understand this better by seeing it than reading it?
Make superpowers skills work in the Codex App's sandboxed worktree environment without breaking existing Claude Code or Codex CLI behavior. Ticket: PRI-823 The Codex App runs agents inside git worktrees it manages — detached HEAD, located under $CODEXHOME/worktrees/, with a Seatbelt sandbox that blocks git checkout -b, git push, and network access.
Date: 2026-06-11 Status: Draft for Drew review Finish the PR #1720 visual companion hardening pass so the branch is ready for Jesse review with clean security behavior, deterministic tests, and a PR diff that contains only the companion work. This is a fixup on top of the existing auth hardening design.
Status: Proposed experiment ladder (not implementation). Each rung ships only with its gate evidence; abort any rung whose gates fail.
with maintainer sign-off after the RED baseline did not reproduce blind stale-ledger adoption. 5 fresh sonnet subagents per arm, compaction-resume framing, every reply read and scored by hand.
Superpowers is a complete software development methodology for your coding agents, built on top of a set of composable skills and some initial instructions that make sure your agent uses them. Give your agent Superpowers: Claude Code, Antigravity, Codex App, Codex CLI, Cursor, Factory Droid, Gemini CLI, GitHub Copilot CLI, Kimi Code, OpenCode, Pi.
Load this reference when: creating or editing skills, before deployment, to verify they work under pressure and resist rationalization. Testing skills is just TDD applied to process documentation.
Goal: Add full superpowers support for OpenCode.ai with a native JavaScript plugin that shares core functionality with the existing Codex implementation. Architecture: Extract common skill discovery/parsing logic into lib/skills-core.js, refactor Codex to use it, then build OpenCode plugin using their native plugin API with custom tools and session hooks.
Goal: Make superpowers defer to native harness worktree systems when available, fall back to manual git worktrees when not, and fix three known finishing bugs. Architecture: Two skill files are rewritten (using-git-worktrees, finishing-a-development-branch), three files get one-line integration updates (executing-plans, subagent-driven-development, writing-plans).
Make subagent-driven-development's per-task reviews cheaper and faster without weakening them, by scoping per-task review prompts to the task and stopping redundant work — while final branch review stays broad. Per-task code quality reviewers in SDD routinely do branch-review-scale work on single-task diffs.
--- name: subagent-driven-development description: Use when executing implementation plans with independent tasks in the current session --- Execute plan by dispatching a fresh implementer subagent per task, a task review (spec compliance + code quality) after each, and a broad whole-branch review at the end. Why subagents: You delegate tasks to specialized agents with isolated context.
Date: 2026-04-06 Status: Draft Ticket: PRI-974 Subsumes: PRI-823 (Codex App compatibility) Superpowers is opinionated about worktree management — specific paths (.worktrees/ ), specific commands (git worktree add), specific cleanup (git worktree remove). Meanwhile, Claude Code, Codex App, Gemini CLI, and Cursor all provide native worktree support with their own paths, lifecycle management, and cleanup.
We are implementing these ourselves; the referenced community PRs are evidence and reference material, not code we intend to merge. A single place that captures every open issue and PR touching the visual brainstorming companion (the local server in skills/brainstorming/scripts/), distilled to the underlying problem and the change we'd make.
--- name: writing-skills description: Use when creating new skills, editing existing skills, or verifying skills work before deployment --- Writing skills IS Test-Driven Development applied to process documentation. Personal skills live in your runtime's skills directory (~/.claude/skills/ on Claude Code) — see codex-tools.md or gemini-tools.md for the path on those runtimes.
Goal: Move the standalone obra/drill skill-compliance benchmark into superpowers as a top-level evals/ directory, delete redundant bash tests under superpowers/tests/ after per-file subagent verification of drill scenario coverage, and update top-level docs so contributors land on the new structure. Architecture: Single PR against dev on a new branch f/evals-lift.
Goal: Make SDD's durable-progress workspace plan-scoped (.superpowers/sdd/ /) with a self-identifying ledger and end-of-plan cleanup, so a follow-up plan can never collide with a previous plan's artifacts and resumed controllers stop paying a forensic disambiguation tax. Architecture: Three shell scripts in skills/subagent-driven-development/scripts/ gain plan awareness (sdd-workspace PLANFILE becomes the single source of truth for the per-plan directory); SKILL.md's Durable
Goal: Make subagent-driven-development's review-fix loop convergent and autonomous (resume-the-implementer fix rounds, scoped re-reviews, five-round breaker, controller adjudication) and reorganize its SKILL.md by lifecycle — with quorum eval evidence. The superpowers repo (branch sdd-fix-loop-redesign, already created; spec committed) gets the skill restructure: one new prompt template, two template edits, one reference edit, and the SKILL.md rewrite whose full text is in Ta
This guide explains how to add support for a new harness — an IDE, CLI, or agent runner that isn't Claude Code — so that Superpowers skills auto-trigger there the same way they do natively. Part 1–3 explain how the system works and how to tell whether a harness can be supported at all; read these before you touch anything.
Goal: Finish PR #1720's final hardening fixup with test-first changes, clean rebase state, and reviewer-ready evidence. Spec: docs/superpowers/specs/2026-06-11-visual-companion-final-hardening-fixup-design.md Architecture: Keep the companion zero-dependency and local-first.
Browser-based visual brainstorming companion for showing mockups, diagrams, and options. The test: would the user understand this better by seeing it than reading it?
Make superpowers skills work in the Codex App's sandboxed worktree environment without breaking existing Claude Code or Codex CLI behavior. Ticket: PRI-823 The Codex App runs agents inside git worktrees it manages — detached HEAD, located under $CODEXHOME/worktrees/, with a Seatbelt sandbox that blocks git checkout -b, git push, and network access.
Date: 2026-06-11 Status: Draft for Drew review Finish the PR #1720 visual companion hardening pass so the branch is ready for Jesse review with clean security behavior, deterministic tests, and a PR diff that contains only the companion work. This is a fixup on top of the existing auth hardening design.
Status: Proposed experiment ladder (not implementation). Each rung ships only with its gate evidence; abort any rung whose gates fail.
with maintainer sign-off after the RED baseline did not reproduce blind stale-ledger adoption. 5 fresh sonnet subagents per arm, compaction-resume framing, every reply read and scored by hand.
Superpowers is a complete software development methodology for your coding agents, built on top of a set of composable skills and some initial instructions that make sure your agent uses them. Give your agent Superpowers: Claude Code, Antigravity, Codex App, Codex CLI, Cursor, Factory Droid, Gemini CLI, GitHub Copilot CLI, Kimi Code, OpenCode, Pi.
Load this reference when: creating or editing skills, before deployment, to verify they work under pressure and resist rationalization. Testing skills is just TDD applied to process documentation.
Goal: Add full superpowers support for OpenCode.ai with a native JavaScript plugin that shares core functionality with the existing Codex implementation. Architecture: Extract common skill discovery/parsing logic into lib/skills-core.js, refactor Codex to use it, then build OpenCode plugin using their native plugin API with custom tools and session hooks.
Goal: Make superpowers defer to native harness worktree systems when available, fall back to manual git worktrees when not, and fix three known finishing bugs. Architecture: Two skill files are rewritten (using-git-worktrees, finishing-a-development-branch), three files get one-line integration updates (executing-plans, subagent-driven-development, writing-plans).
Make subagent-driven-development's per-task reviews cheaper and faster without weakening them, by scoping per-task review prompts to the task and stopping redundant work — while final branch review stays broad. Per-task code quality reviewers in SDD routinely do branch-review-scale work on single-task diffs.
--- name: subagent-driven-development description: Use when executing implementation plans with independent tasks in the current session --- Execute plan by dispatching a fresh implementer subagent per task, a task review (spec compliance + code quality) after each, and a broad whole-branch review at the end. Why subagents: You delegate tasks to specialized agents with isolated context.
Date: 2026-04-06 Status: Draft Ticket: PRI-974 Subsumes: PRI-823 (Codex App compatibility) Superpowers is opinionated about worktree management — specific paths (.worktrees/ ), specific commands (git worktree add), specific cleanup (git worktree remove). Meanwhile, Claude Code, Codex App, Gemini CLI, and Cursor all provide native worktree support with their own paths, lifecycle management, and cleanup.
We are implementing these ourselves; the referenced community PRs are evidence and reference material, not code we intend to merge. A single place that captures every open issue and PR touching the visual brainstorming companion (the local server in skills/brainstorming/scripts/), distilled to the underlying problem and the change we'd make.
--- name: writing-skills description: Use when creating new skills, editing existing skills, or verifying skills work before deployment --- Writing skills IS Test-Driven Development applied to process documentation. Personal skills live in your runtime's skills directory (~/.claude/skills/ on Claude Code) — see codex-tools.md or gemini-tools.md for the path on those runtimes.
Goal: Move the standalone obra/drill skill-compliance benchmark into superpowers as a top-level evals/ directory, delete redundant bash tests under superpowers/tests/ after per-file subagent verification of drill scenario coverage, and update top-level docs so contributors land on the new structure. Architecture: Single PR against dev on a new branch f/evals-lift.
Goal: Make SDD's durable-progress workspace plan-scoped (.superpowers/sdd/ /) with a self-identifying ledger and end-of-plan cleanup, so a follow-up plan can never collide with a previous plan's artifacts and resumed controllers stop paying a forensic disambiguation tax. Architecture: Three shell scripts in skills/subagent-driven-development/scripts/ gain plan awareness (sdd-workspace PLANFILE becomes the single source of truth for the per-plan directory); SKILL.md's Durable
Goal: Make subagent-driven-development's review-fix loop convergent and autonomous (resume-the-implementer fix rounds, scoped re-reviews, five-round breaker, controller adjudication) and reorganize its SKILL.md by lifecycle — with quorum eval evidence. The superpowers repo (branch sdd-fix-loop-redesign, already created; spec committed) gets the skill restructure: one new prompt template, two template edits, one reference edit, and the SKILL.md rewrite whose full text is in Ta
This guide explains how to add support for a new harness — an IDE, CLI, or agent runner that isn't Claude Code — so that Superpowers skills auto-trigger there the same way they do natively. Part 1–3 explain how the system works and how to tell whether a harness can be supported at all; read these before you touch anything.