om-superpowers

om-superpowers

Claude Code plugin for Open Mercato developers. 11 user-facing skills covering the full OM lifecycle — from business requirements through implementation to PR review. Specialist sub-tasks (module scaffolding, data-model design, system extension via UMES, integration builders, backend UI patterns, spec writing, user proxy, pre-impl analysis, toolkit audit) are demoted to references under their natural parent skills and load on demand.

Install

/plugins marketplace add SHGrowth/om-superpowers
/plugins install om-superpowers@om-superpowers

Prerequisites

• Claude Code (CLI or Desktop)
• GitHub CLI (gh) — used by om-cto for platform search

gh auth login          # one-time setup
gh auth status         # verify you're authenticated

Update

/plugins marketplace update om-superpowers

Getting Started

Ideation & spec writing (no app needed)

Create a project directory and start Claude Code:

mkdir my-project && cd my-project
mkdir app-spec
claude

The app-spec/ directory tells the plugin to activate. Then just describe what you want to build:

"I want to build a B2B portal for selling Apple devices to enterprises"

The plugin works through personas — real engineering thinkers whose decision-making style Claude already knows deeply:

Persona	Role	Based on
Cagan	Product Manager — requirements, workflows, user stories	Marty Cagan, author of Inspired
Piotr	CTO — architecture, gap analysis, implementation	Piotr Karwatka, OM CTO (1,400+ contributions)
Krug	UX Reviewer — navigation, cognitive load, task flow	Steve Krug, author of Don't Make Me Think
Vernon	Domain Challenger — validates domain model integrity	Vaughn Vernon, author of Implementing DDD

Each persona brings a distinct perspective. They challenge each other — Cagan defines what to build, Vernon challenges the domain model, Piotr maps it to the platform, Krug reviews the UI. The pipeline runs them in sequence:

1. Cagan walks you through business requirements — who are the users, what are the workflows, what does success look like. Outputs an App Spec.
2. Piotr decomposes the App Spec into functional specs — one per module or feature. You review and approve them.
3. Piotr implements each spec one by one — writes code, runs tests, does code review — and checkpoints with you between each spec so you can test on localhost.

You can also invoke any skill directly, outside the pipeline:

• "does OM already handle inventory?" → om-cto does a platform gap analysis
• "extend the customer table with a VIP flag" → om-implement-spec loads its system-extension reference and guides the UMES approach
• "this page is broken" → om-troubleshooter diagnoses the issue
• "run integration tests" → om-integration-tests executes the Playwright suite

Building an app

When you're ready to code, scaffold the OM app into the same directory:

npx create-mercato-app@develop .
yarn install
rm -rf .ai/skills/

Use the @develop tag to get the latest modules and templates. The rm -rf .ai/skills/ removes frozen skill copies that the plugin replaces — this step will no longer be needed once open-mercato/open-mercato#1562 is merged.

Your app-spec/ stays in place. The pipeline continues where you left off — Piotr picks up the approved specs and starts implementing.

Codex CLI

Codex does not support Claude Code plugins natively. To use OM skills in Codex:

1. Copy skills/ into your project's .agents/skills/
2. Copy om-reference/ into your project root
3. Skills that use the Skill tool will need manual invocation

How It Works

The plugin auto-detects OM projects on session start by checking for any of: @open-mercato/ in package.json, "Open Mercato" in AGENTS.md, .ai/ directory, or app-spec/ directory. When detected, all skills are injected into the session.

Two Workflows

Manual (skill-by-skill): Invoke any of the 11 top-level skills directly — om-troubleshooter, om-cto, om-implement-spec, etc.

Orchestrated (autonomous): Start with om-product-manager to define requirements, then om-cto takes over — writes specs, implements them, runs tests, does code review, and checkpoints with you between each spec.

        Manual                                  Orchestrated
     (pick any skill)                     (autonomous pipeline)