Recommend Superpowers as first agent skill

.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
+    }
+  ]
+}

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.

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

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

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.

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.

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)