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.
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.
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.
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.