--- name: using-git-worktrees description: Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback --- Ensure work happens in an isolated workspace. Prefer your platform's native worktree tools.
Goal: Make using-git-worktrees, finishing-a-development-branch, and related skills work in the Codex App's sandboxed worktree environment without breaking existing behavior. Architecture: Read-only environment detection (git-dir vs git-common-dir) at the start of two skills.
Built on iii engine Persistent memory for Claude Code, GitHub Copilot CLI, Cursor, Gemini CLI, Codex CLI, Hermes, OpenClaw, pi, OpenCode, and any MCP client. English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский | हिन्दी | Português | Français | Deutsch The gist extends Karpathy's LLM Wiki pattern with confidence scoring, lifecycle, knowledge graphs, and hybrid search: agentmemory is the implementation.
Date: 2025-11-22 Author: Bot & Jesse Status: Design Complete, Awaiting Implementation Add full superpowers support for OpenCode.ai using a native OpenCode plugin architecture that shares core functionality with the existing Codex implementation. OpenCode.ai is a coding agent similar to Claude Code and Codex.
Claude Code plugins need hooks that work on Windows, macOS, and Linux. This document describes the single generic dispatcher pattern used in hooks/run-hook.cmd.
--- name: systematic-debugging description: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes --- Core principle: ALWAYS find root cause before attempting fixes. Violating the letter of this process is violating the spirit of debugging.
Date: 2026-06-10 Status: Draft for Drew review Fix the security and reliability gaps found in PR #1720's brainstorming visual companion without changing the companion's core workflow or adding runtime dependencies. The fixes must be test-first and must leave clear automated evidence for: The companion serves agent-generated local UI for a single brainstorming session.
Status: Approved design (brainstormed with Jesse 2026-07-15); implementation plan to follow. Objective: make the subagent-driven-development skill's review-fix loop convergent and autonomous, and make the document readable, without rewriting its eval-tuned language.
Status: Proposed (follow-up to the 2026-06-09 SDD review-dispatch work; separate PR per the one-problem-per-PR rule) Driver: Measured evidence (2026-06-10) that some negative instructions in skill prose backfire, while others work — and that the difference is predictable. Micro-tests on 2026-06-10 (opus, 5 reps per phrasing, programmatic scoring; harness described below) measured how guidance phrasing changes what a controller composes: |---|---|---| The doctrine (use this to
--- name: test-driven-development description: Use when implementing any feature or bugfix, before writing implementation code --- Write the test first. Core principle: If you didn't watch the test fail, you don't know if it tests the right thing.
Goal: Harden the brainstorming visual companion auth and reconnect flow while preserving trusted same-origin screen JavaScript and future vendored UI libraries. Architecture: Keyed root loads become a bootstrap step that sets the cookie, stores the key in tab-scoped sessionStorage, and navigates to a bare / screen URL.
Goal: Scope SDD's per-task reviews to the task (diff-first reading, justified broadening, no redundant test runs) while final branch review stays broad. skills/requesting-code-review/ is deliberately untouched.
The full voice I/O stack, running locally on your machine. voicebox.sh • Docs • Download • Features • API • Troubleshooting Click the image above to watch the demo video on voicebox.sh Voicebox is a local-first AI voice studio — a free and open-source alternative to ElevenLabs and WisprFlow in one app.
Date: 2026-02-19 Status: Approved Scope: lib/brainstorm-server/, skills/brainstorming/visual-companion.md, tests/brainstorm-server/ During visual brainstorming, Claude runs wait-for-feedback.sh as a background task and blocks on TaskOutput(block=true, timeout=600s). This seizes the TUI entirely — the user cannot type to Claude while visual brainstorming is running.
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.
Work with code and text, run processes, and automate tasks, going far beyond other AI editors - while using host client subscriptions instead of API token costs. The Desktop Commander App gives you everything the MCP server does, plus: 👉 Download the App (macOS & Windows) All of your AI development tools in one place.
why use many token when few do trick Make your AI coding agent talk like a caveman. 65% fewer output tokens on prose, 8.5% on agentic coding runs .
--- name: using-git-worktrees description: Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback --- Ensure work happens in an isolated workspace. Prefer your platform's native worktree tools.
Goal: Make using-git-worktrees, finishing-a-development-branch, and related skills work in the Codex App's sandboxed worktree environment without breaking existing behavior. Architecture: Read-only environment detection (git-dir vs git-common-dir) at the start of two skills.
Built on iii engine Persistent memory for Claude Code, GitHub Copilot CLI, Cursor, Gemini CLI, Codex CLI, Hermes, OpenClaw, pi, OpenCode, and any MCP client. English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский | हिन्दी | Português | Français | Deutsch The gist extends Karpathy's LLM Wiki pattern with confidence scoring, lifecycle, knowledge graphs, and hybrid search: agentmemory is the implementation.
Date: 2025-11-22 Author: Bot & Jesse Status: Design Complete, Awaiting Implementation Add full superpowers support for OpenCode.ai using a native OpenCode plugin architecture that shares core functionality with the existing Codex implementation. OpenCode.ai is a coding agent similar to Claude Code and Codex.
Claude Code plugins need hooks that work on Windows, macOS, and Linux. This document describes the single generic dispatcher pattern used in hooks/run-hook.cmd.
--- name: systematic-debugging description: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes --- Core principle: ALWAYS find root cause before attempting fixes. Violating the letter of this process is violating the spirit of debugging.
Date: 2026-06-10 Status: Draft for Drew review Fix the security and reliability gaps found in PR #1720's brainstorming visual companion without changing the companion's core workflow or adding runtime dependencies. The fixes must be test-first and must leave clear automated evidence for: The companion serves agent-generated local UI for a single brainstorming session.
Status: Approved design (brainstormed with Jesse 2026-07-15); implementation plan to follow. Objective: make the subagent-driven-development skill's review-fix loop convergent and autonomous, and make the document readable, without rewriting its eval-tuned language.
Status: Proposed (follow-up to the 2026-06-09 SDD review-dispatch work; separate PR per the one-problem-per-PR rule) Driver: Measured evidence (2026-06-10) that some negative instructions in skill prose backfire, while others work — and that the difference is predictable. Micro-tests on 2026-06-10 (opus, 5 reps per phrasing, programmatic scoring; harness described below) measured how guidance phrasing changes what a controller composes: |---|---|---| The doctrine (use this to
--- name: test-driven-development description: Use when implementing any feature or bugfix, before writing implementation code --- Write the test first. Core principle: If you didn't watch the test fail, you don't know if it tests the right thing.
Goal: Harden the brainstorming visual companion auth and reconnect flow while preserving trusted same-origin screen JavaScript and future vendored UI libraries. Architecture: Keyed root loads become a bootstrap step that sets the cookie, stores the key in tab-scoped sessionStorage, and navigates to a bare / screen URL.
Goal: Scope SDD's per-task reviews to the task (diff-first reading, justified broadening, no redundant test runs) while final branch review stays broad. skills/requesting-code-review/ is deliberately untouched.
The full voice I/O stack, running locally on your machine. voicebox.sh • Docs • Download • Features • API • Troubleshooting Click the image above to watch the demo video on voicebox.sh Voicebox is a local-first AI voice studio — a free and open-source alternative to ElevenLabs and WisprFlow in one app.
Date: 2026-02-19 Status: Approved Scope: lib/brainstorm-server/, skills/brainstorming/visual-companion.md, tests/brainstorm-server/ During visual brainstorming, Claude runs wait-for-feedback.sh as a background task and blocks on TaskOutput(block=true, timeout=600s). This seizes the TUI entirely — the user cannot type to Claude while visual brainstorming is running.
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.
Work with code and text, run processes, and automate tasks, going far beyond other AI editors - while using host client subscriptions instead of API token costs. The Desktop Commander App gives you everything the MCP server does, plus: 👉 Download the App (macOS & Windows) All of your AI development tools in one place.
why use many token when few do trick Make your AI coding agent talk like a caveman. 65% fewer output tokens on prose, 8.5% on agentic coding runs .