By florian60430
Mandatory pre-implementation grounding for Claude Code — code-level (interrogate-codebase loads the full scope of files) + UI-level (Playwright MCP via the ui-validator sub-agent in exploration mode). Verifies in the real running UI before any code is written. Bundles Superpowers as a dependency so a single install brings the full skill set.
USE before touching existing code. Loads the full scope of relevant frontend AND backend files into the main agent's context — the way a developer refreshes their memory by opening every file involved before starting work.
USE after interrogate-codebase. Drives the real UI via Playwright MCP through the read-only ui-validator subagent to sample normal/edge/failed cases. Code reading, debug modals, log dumps are NEVER substitutes. If Playwright or the UI aren't reachable, the agent makes them so autonomously before escalating BLOCKED. Skip only for pure dev tooling and zero-behavior refactors.
Append a discovered-but-out-of-scope bug to .supersaiyan/discovered-bugs.md so it is never silently ignored. Use whenever investigation surfaces an issue unrelated to the current task — for example, a separate broken feature spotted during UI verification.
USE when entering a new project repo to scaffold project-specific MCP servers. Detects the tech stack (Postgres, Stripe, Prisma, Supabase, Symfony+Doctrine, Rails, Next.js, etc.) from manifest and config files, consults a catalog of recommended MCP servers per stack, and proposes a .mcp.json for the project. The user reviews before anything is written — never auto-installs an MCP without approval. Secrets always referenced as ${ENV_VAR}, never inlined. Triggers on "set up MCPs", "bootstrap MCPs", "initialize project MCPs", "what MCPs should this project have", "scaffold .mcp.json", "configure project MCPs", or first session on a new repo.
Detects whether Playwright MCP is configured for the current CLI and installs it if missing. Required dependency for investigate-ui-first. Handles Claude Code, Codex, and the missing-Node fallback gracefully. Invoke before any UI investigation if you are not sure Playwright MCP is available.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
A portable, installable plugin (Claude Code + Codex) that adds a mandatory pre-implementation UI investigation layer to any development workflow.
It does not replace Superpowers — it bundles it. Installing this plugin installs Superpowers as a declared dependency, so you get the full kit (brainstorming → planning → TDD → debugging → code review → finishing) plus a hard gate that runs before any of it: observe the real running UI before writing code.
When you ask the agent to fix a bug, add a feature, or change UI:
UserPromptSubmit hook nudges the agent to invoke
investigate-ui-first before touching code.ui-validator sub-agent.ui-validator drives the actual browser via Playwright MCP, takes
snapshots, inspects console errors, and returns one of four
verdicts: REPRODUCED, DIFFERS, NOT-REPRODUCED, BLOCKED. It
has no edit tools and cannot modify code by design..supersaiyan/discovered-bugs.md in the project root via the
log-unrelated-bug skill — never silently ignored.SessionStart hook installs a sentinel-wrapped CLAUDE.md overlay
that enforces these rules and tones down Superpowers' brainstorming
to favor assumption-with-disclosure over back-and-forth question
loops.All of this runs without you asking for it.
Shell one-liner (uses the claude CLI under the hood):
bash <(curl -fsSL https://raw.githubusercontent.com/florian60430/supersaiyan/main/scripts/install-claude.sh)
Or three slash commands inside a Claude Code session:
/plugin marketplace add obra/superpowers-marketplace
/plugin marketplace add florian60430/supersaiyan
/plugin install supersaiyan@supersaiyan
Either path installs both plugins (Superpowers is declared as a
cross-marketplace dependency in plugin.json, so Claude Code
auto-resolves it). User-level install — applies to every project on
the machine, no per-project setup. See INSTALL.md for
details and how the sentinel-managed CLAUDE.md injection works.
git clone https://github.com/florian60430/supersaiyan.git
cd supersaiyan
bash scripts/install-codex.sh
One command — the script also auto-clones obra/superpowers and
symlinks its skills into ~/.agents/skills/ alongside ours. To skip
Superpowers, set SUPERSAIYAN_SKIP_SUPERPOWERS=1. See
codex/INSTALL.md for details.
supersaiyan/
├── .claude-plugin/marketplace.json ← single-plugin marketplace catalog
├── plugin/ ← the Claude Code plugin
│ ├── .claude-plugin/plugin.json
│ ├── skills/
│ │ ├── investigate-ui-first/ ← mandatory pre-impl skill
│ │ ├── playwright-mcp-setup/ ← runtime detect/install
│ │ └── log-unrelated-bug/ ← project bug log
│ ├── agents/ui-validator.md ← read-only Playwright observer
│ ├── hooks/ ← SessionStart + UserPromptSubmit
│ └── templates/CLAUDE.md.snippet ← sentinel-wrapped overlay
├── codex/ ← Codex entry point
│ ├── AGENTS.md ← Codex standing instructions
│ ├── agents/ui-validator.toml ← Codex sub-agent definition
│ ├── skills/ ← symlinks → ../plugin/skills/
│ └── INSTALL.md
└── scripts/ ← install/uninstall + shared lib
├── install-codex.sh
├── uninstall-codex.sh
└── lib/inject-snippet.sh
The Claude Code plugin in plugin/ is the canonical source for
skill content. The Codex side uses symlinks (Codex officially
supports symlinked skill folders) so there's one source of truth.
npx claudepluginhub florian60430/supersaiyan --plugin supersaiyanUltra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Multi-model consensus engine integrating OpenAI Codex CLI, Gemini CLI, and Claude CLI for collaborative code review and problem-solving.
Curate auto-memory, promote learnings to CLAUDE.md and rules, extract proven patterns into reusable skills.
Memory compression system for Claude Code - persist context across sessions
Comprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.