From d7f3c0b528746de4e6aeaee0bd2f22519da075ab Mon Sep 17 00:00:00 2001 From: Zitzak Date: Tue, 28 Apr 2026 16:15:01 +0200 Subject: [PATCH] Recommend Superpowers as first agent skill Adds AGENTS.md (cross-tool) + CLAUDE.md import shim + Inverter plugin marketplace so any approved AI agent that indexes this repo gets the recommendation auto-loaded into context. Establishes the delivery pipeline for future Inverter-approved skills. Co-Authored-By: Claude Opus 4.7 (1M context) --- .claude-plugin/marketplace.json | 22 ++++++++++ AGENTS.md | 26 +++++++++++ CLAUDE.md | 1 + ai/README.md | 3 ++ ai/skills/README.md | 10 +++++ ai/skills/workflows/README.md | 18 ++++++++ ai/skills/workflows/superpowers.md | 70 ++++++++++++++++++++++++++++++ 7 files changed, 150 insertions(+) create mode 100644 .claude-plugin/marketplace.json create mode 100644 AGENTS.md create mode 100644 CLAUDE.md create mode 100644 ai/skills/workflows/README.md create mode 100644 ai/skills/workflows/superpowers.md diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json new file mode 100644 index 0000000..48ba30c --- /dev/null +++ b/.claude-plugin/marketplace.json @@ -0,0 +1,22 @@ +{ + "name": "inverter-standard", + "owner": { + "name": "Inverter Network" + }, + "metadata": { + "description": "Inverter Network — curated AI agent skills and plugins for Claude Code", + "version": "0.1.0" + }, + "plugins": [ + { + "name": "superpowers", + "source": { + "source": "url", + "url": "https://github.com/obra/superpowers.git" + }, + "description": "Agentic skills framework — brainstorm → plan → TDD → review → finish. Recommended for all non-trivial Inverter dev work.", + "version": "5.0.7", + "strict": true + } + ] +} diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..da84df2 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,26 @@ +# Inverter AI Standard + +This repository is the Inverter Network AI Standard — the central reference for approved AI tools, reusable skills, and acceptable-use policies across the company. Start at [`ai/README.md`](./ai/README.md). + +## Recommended setup + +Inverter recommends installing [Superpowers](./ai/skills/workflows/superpowers.md) — an agentic skills framework that enforces a brainstorm → plan → TDD → review → finish workflow. The skills auto-trigger for non-trivial dev work; no manual invocation needed. License: MIT. + +### Install per agent + +| Agent | Command | +|---|---| +| **Claude Code** *(Inverter marketplace — recommended)* | `/plugin marketplace add InverterNetwork/standard` then `/plugin install superpowers@inverter-standard` | +| Claude Code *(upstream marketplace)* | `/plugin install superpowers@claude-plugins-official` | +| Codex CLI | `/plugins`, search `superpowers`, select **Install Plugin** | +| Codex App | Plugins sidebar → click `+` next to Superpowers | +| Cursor | `/add-plugin superpowers` (or search the plugin marketplace) | +| GitHub Copilot CLI | `copilot plugin marketplace add obra/superpowers-marketplace` then `copilot plugin install superpowers@superpowers-marketplace` | +| OpenCode | Tell it: `Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md` | +| Gemini CLI | `gemini extensions install https://github.com/obra/superpowers` | + +Restart your agent after installing. + +## Inverter plugin marketplace + +The repo also publishes a curated Claude Code plugin marketplace at [`.claude-plugin/marketplace.json`](./.claude-plugin/marketplace.json). It currently lists only Superpowers; future Inverter-approved skills will be added there. The marketplace is a Claude-Code-specific convenience — other agents install Superpowers directly via the table above. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..43c994c --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/ai/README.md b/ai/README.md index d19113f..2f0b4fc 100644 --- a/ai/README.md +++ b/ai/README.md @@ -29,11 +29,14 @@ Reusable prompt patterns and techniques organised by domain. Skills are concrete → **[Skills Overview](./skills/README.md)** +> **Using an AI agent?** See [`AGENTS.md`](../AGENTS.md) at the repo root for per-agent install commands for the recommended Inverter skill bundle (works with Claude Code, Cursor, Codex, OpenCode, Copilot, and Gemini). Claude Code users get an additional one-command shortcut via the curated [plugin marketplace](../.claude-plugin/marketplace.json). + | Domain | Skills | |--------|--------| | Solidity Development | [Testing](./skills/solidity-development/testing/README.md) (skeleton · modifiers · internal functions · external functions · fuzz · e2e · invariant) · [Commit Messages](./skills/solidity-development/commit-messages.md) | | QA Testing | [Guided User Testing](./skills/qa-testing/guided-user-testing.md) (base template) · [Floor Markets Phase 2](./skills/qa-testing/floor-markets-phase-2.md) | | Diagramming | [Excalidraw Diagram Creator](./skills/diagramming/excalidraw-diagram/SKILL.md) | +| Workflows | [Superpowers](./skills/workflows/superpowers.md) | | Contributing | [Adding Content](./skills/contributing/adding-content.md) | ## Rules diff --git a/ai/skills/README.md b/ai/skills/README.md index 7973e37..346717f 100644 --- a/ai/skills/README.md +++ b/ai/skills/README.md @@ -42,6 +42,16 @@ AI-assisted diagram creation — visual arguments, not just labelled boxes. → See the [Diagramming overview](./diagramming/README.md) for details. +### Workflows + +General agent workflows and methodologies that apply across domains. Distributed via the [Inverter Claude Code marketplace](../../.claude-plugin/marketplace.json). + +| Skill | Description | +|-------|-------------| +| [Superpowers](./workflows/superpowers.md) | Agentic skills framework — brainstorm → plan → TDD → review → finish | + +→ See the [Workflows overview](./workflows/README.md) for details. + ### Contributing How to add new content to the AI standard. diff --git a/ai/skills/workflows/README.md b/ai/skills/workflows/README.md new file mode 100644 index 0000000..261f642 --- /dev/null +++ b/ai/skills/workflows/README.md @@ -0,0 +1,18 @@ +# Workflow Skills + +Skills that shape *how* an AI agent works — methodologies and disciplined collaboration patterns that apply across domains. These pair with domain-specific skills (e.g. [Solidity Development](../solidity-development/README.md), [QA Testing](../qa-testing/README.md)) to handle process discipline alongside the actual work. + +Workflow skills in this section work across the AI agents listed in [Approved Tools](../../tools/README.md) — Claude Code, Cursor, Codex, etc. Each agent has its own install path; see the per-agent install table in [`AGENTS.md`](../../../AGENTS.md). Claude Code users get an additional one-command shortcut via the [Inverter plugin marketplace](../../../.claude-plugin/marketplace.json): + +``` +/plugin marketplace add InverterNetwork/standard +/plugin install superpowers@inverter-standard +``` + +## Skills + +| Skill | Description | +|-------|-------------| +| [Superpowers](./superpowers.md) | Agentic skills framework — brainstorm → plan → TDD → review → finish | + +→ See [Adding Content](../contributing/adding-content.md) for how to add a new workflow skill or extend the marketplace. diff --git a/ai/skills/workflows/superpowers.md b/ai/skills/workflows/superpowers.md new file mode 100644 index 0000000..18f8bae --- /dev/null +++ b/ai/skills/workflows/superpowers.md @@ -0,0 +1,70 @@ +# Superpowers + +[Superpowers](https://github.com/obra/superpowers) by Jesse Vincent — an agentic skills framework that ships installers for Claude Code, Codex (CLI + App), Cursor, OpenCode, GitHub Copilot, and Gemini (MIT license). It's the first skill listed in the Inverter recommended bundle. + +## Why it's in the Inverter bundle + +Inverter dev work involves smart contracts, security-sensitive logic, and long-form features that benefit from up-front design and rigorous testing. Superpowers enforces a workflow that matches how we want AI-assisted development to happen: + +1. **Brainstorm before code** — Socratic refinement, design doc, user sign-off +2. **Plan in small tasks** — exact file paths, expected diffs, verification steps +3. **TDD by default** — red → green → refactor; no implementation without a failing test first +4. **Review before merge** — checks against the plan, severity-ranked issues +5. **Clean finish** — tests pass, branch decision presented, worktree cleaned up + +The skills auto-trigger; the agent picks the right phase on its own. No manual invocation needed. + +## When to use + +- Non-trivial features, bugfixes, or refactors +- Anywhere consistent test-driven, plan-driven output across the team matters +- Long autonomous runs (the agent stays on-plan for an hour+ without deviating) + +## When to skip + +- One-line fixes or trivial edits where the workflow ceremony exceeds the value +- Throwaway exploratory work + +## Install + +For Claude Code (Inverter marketplace — recommended): + +``` +/plugin marketplace add InverterNetwork/standard +/plugin install superpowers@inverter-standard +``` + +For Codex, Cursor, OpenCode, Copilot, or Gemini, see the per-agent install table in [`AGENTS.md`](../../../AGENTS.md). Restart your agent after installing; verify the skills are loaded (e.g. `/plugin` in Claude Code). + +## What's inside + +The plugin ships ~14 skills. The core workflow: + +| Phase | Skill | +|-------|-------| +| 1 | `brainstorming` | +| 2 | `using-git-worktrees` | +| 3 | `writing-plans` | +| 4 | `subagent-driven-development` / `executing-plans` | +| 5 | `test-driven-development` | +| 6 | `requesting-code-review` | +| 7 | `finishing-a-development-branch` | + +Plus debugging (`systematic-debugging`, `verification-before-completion`), collaboration (`dispatching-parallel-agents`, `receiving-code-review`), and meta (`writing-skills`, `using-superpowers`) skills. + +## Combine with project skills + +Superpowers handles the *how* of working. Pair it with Inverter's domain skills for the *what*: + +- [Solidity Testing](../solidity-development/testing/README.md) — building complete test suites +- [QA Testing](../qa-testing/README.md) — guided product testing + +## Pin and audit + +The Inverter marketplace currently lists Superpowers at version `5.0.7` ([source repo](https://github.com/obra/superpowers)). When bumping the pinned version in [`.claude-plugin/marketplace.json`](../../../.claude-plugin/marketplace.json), apply the same audit discipline as for submodules — see [Importing Submodules](../contributing/adding-content.md#importing-submodules). Diff upstream `hooks/` and `scripts/` for anything that runs at install time. + +## References + +- Source: [obra/superpowers](https://github.com/obra/superpowers) (MIT) +- Release announcement: [blog.fsck.com/2025/10/09/superpowers/](https://blog.fsck.com/2025/10/09/superpowers/) +- Inverter marketplace: [`.claude-plugin/marketplace.json`](../../../.claude-plugin/marketplace.json)