By datit309
Enforces an evidence-based coding pipeline—from graph-informed planning and test-driven development to verification and review—using codebase analysis to ensure every change is safe, tested, and aligned with architecture. Supports multi-language, web, mobile, and database projects.
Specialized agent for executing implementation plans. Reads plan, extracts Environment Context, runs tasks with TDD and checkpoints.
Specialized agent for creating implementation plans. Scans codebase, uses graph analysis, creates plan file. Does NOT execute tasks.
Independent senior code reviewer. Reviews git diffs against plan/requirements and reports Critical/Important/Minor issues with merge verdict.
Independent implementation plan reviewer. Checks completeness, spec alignment, task decomposition, and buildability before execution.
Apply a formal state machine to issues — assign category (bug/enhancement/question/spike) and state (needs-triage → needs-info → ready-for-agent → ready-for-human → wontfix). Issues marked ready-for-agent become inputs to supergraph:plan. Use when processing a backlog, reviewing new issues, or preparing work for automation.
Fresh verification gate before claiming done, fixed, passing, ready, or before commit/PR. Evidence before claims, always.
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
Build throwaway code to validate an uncertain approach before committing to a plan. Two branches — Logic (terminal state machine) or UI (multiple designs on one route with URL-param switcher). No persistence, no tests, single-command start. Use between analyze and plan when the approach itself is uncertain.
Plan-aware graph-enhanced code review before merge. CRITICAL issues block merge. Use after fix/verify.
Executes bash commands
Hook triggers when Bash tool is used
Modifies files
Hook triggers on file write and edit operations
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.
Uses power tools
Uses Bash, Write, or Edit tools
Uses power tools
Uses Bash, Write, or Edit tools
Turn Claude Code from a code generator into an engineering workflow system.
SuperGraph doesn't make Claude Code smarter. It makes Claude Code behave like a disciplined engineer.
SuperGraph enforces planning, TDD, verification, review, and architecture-aware decision making through mandatory workflows, graph intelligence, and LSP-powered code analysis.
| Without Supergraph | With Supergraph |
|---|---|
| Claude guesses which files are affected | Graph shows exact blast radius before first keystroke |
| TDD is optional | RED test is mandatory — no production code without a failing test |
| "It works on my machine" | 6-phase diagnose loop with deterministic feedback |
| Review is an afterthought | Independent reviewer agent + graph cross-check before every merge |
| Context lost between sessions | Handoff skill compacts full session state in seconds |
| Refactors break hidden callers | Serena LSP finds every reference before rename runs |
| Dependency | Required | Install |
|---|---|---|
| Claude Code CLI | ✅ Yes | See Claude Code docs |
| Python 3.10+ | ✅ Yes | brew install python / apt install python3 |
| code-review-graph | ✅ Yes | pip install code-review-graph |
| Serena MCP | Optional | See Serena Setup |
| Git | ✅ Yes | Already installed on most systems |
# Add plugin marketplace from Git repo
/plugin marketplace add https://github.com/datit309/supergraph.git
# Install the plugin
/plugin install supergraph
# Update later
/plugin marketplace update supergraph
git clone https://github.com/datit309/supergraph.git
/plugin marketplace add ./supergraph
/plugin install supergraph
The codebase graph must be built once per project. It powers blast radius analysis, hub node detection, and community boundaries.
# Install the graph tool
pip install code-review-graph
# Register the MCP server in your project
code-review-graph install
# Build the initial graph index
code-review-graph build
Verify the graph is healthy:
code-review-graph status
The graph updates automatically after every file write (via PostToolUse hook). Rebuild manually after large merges:
code-review-graph build
Serena adds LSP-level intelligence: find all callers, safe cross-codebase rename, type diagnostics. Optional but recommended for complex refactors.
# Install Serena MCP server
pip install serena
# Add to your project's .mcp.json
serena install
Once installed, all supergraph skills automatically use Serena tools where available (find_referencing_symbols, get_diagnostics_for_file, rename_symbol, etc.).
# 1. Start a session — always run scan first
/supergraph:scan
# 2. Plan before any non-trivial change
/supergraph:plan
# 3. Implement with TDD
/supergraph:tdd
# 4. Auto-fix after coding
/supergraph:fix
# 5. Verify before claiming done
/supergraph:verify
# 6. Review before merge
/supergraph:review
Small change (1-2 files, <10 lines)? Skip plan → /supergraph:tdd → /supergraph:fix → /supergraph:review
SESSION START
→ /supergraph:scan
→ Load graph, detect language, save .supergraph-env
│
▼
PLANNING PHASE
→ /supergraph:analyze (ambiguous scope, hub/bridge nodes)
→ /supergraph:plan (blast radius, task breakdown, user approval)
→ Save to docs/supergraph/plans/YYYY-MM-DD-*.md
│
┌────┴────────────────────┐
▼ ▼
SMALL CHANGE LARGE CHANGE
1-2 files, <10 lines Multi-file, complex
/supergraph:tdd /supergraph:execute
│ │ (parallel tasks)
└────────┬────────────────┘
▼
Per task: RED → GREEN → REFACTOR → commit
│
▼
/supergraph:fix
Tests + lint + format + graph (max 3 iterations)
│
▼
/supergraph:integration (if e2e configured)
│
▼
/supergraph:verify (evidence gate)
│
▼
/supergraph:review (graph-aware, independent agent)
→ APPROVED / NEEDS_CHANGES / BLOCKED
All skills use the /supergraph: prefix to avoid conflicts with built-in commands.
npx claudepluginhub datit309/supergraph --plugin supergraphVerification-first engineering toolkit for Claude Code. 15 skills across a 5-phase spine (Investigate → Design → Implement → Verify → Ship), 8 specialist agents, an interactive setup wizard. Every skill has rationalizations + evidence requirements. Built for senior ICs and tech leads.
Superpowers Plus core skills library for Claude Code: planning, execution routing, TDD, debugging, and collaboration workflows
Code transformation: Dev SDLC orchestrator (code-shipping pipeline), plan, assert, audit, review, test, refactor, debug, for-sure. Hosts engineering agents.
Multi-agent orchestration for code that matters.
Corca Workflow Framework — consolidated hooks and skill orchestration for structured development sessions
Code intelligence powered by a knowledge graph. Provides execution flow tracing, blast radius analysis, and augmented search across your codebase.