datit309

Supergraph — AI skill for Claude Code

AI community

Engineering workflow system for AI coding agents — mandatory planning, TDD, verification, review, and intelligent codebase graph analysis.

How to install Supergraph

This entry records only its repository, not the path inside it, so there is no exact command to give. Open datit309/supergraph and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Supergraph does

Engineering workflow system for AI coding agents — mandatory planning, TDD, verification, review, and intelligent codebase graph analysis.

Alternatives in AI

DeepVCode — DeepV Code - A highly customizable AI coding assistant compatible with all major AI models 406 ★
Graphmind — Local-first code intelligence for AI assistants 213 ★
Ring — 89 skills and 38 specialized agents that enforce proven engineering practices for AI-assisted development 176 ★

README

Supergraph for AI Coding Agents

[Tiếng Việt](./README-VI.md)

**Turn AI coding agents from code generators into engineering workflow systems.**

SuperGraph doesn't make your coding agent smarter. It makes your coding agent 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.

What the plugin does

Supergraph is a workflow system for AI coding agents, not just a collection of prompts. Every non-trivial change follows:

`scan → analyze → plan → TDD → execute → fix → verify → review`

The graph layer is powered by [Codebase Memory MCP](https://github.com/DeusData/codebase-memory-mcp) (`>= 0.9.0`). It indexes the repository locally under a stable project identity, then provides evidence for blast radius, callers/callees, architecture clusters, dependency cycles, test gaps, complexity hotspots, and changed symbols. [Serena](https://github.com/oraios/serena) is optional and adds LSP-level references and diagnostics.

The workflow is evidence-gated: no production change without a verified RED test, no plan execution without an approved plan, and no completion claim without fresh verification and independent review. Hooks provide session reminders, plan guards, failure hints, and asynchronous graph freshness through Codebase Memory auto-watch.

Windows hook behavior

On Windows, `hooks/run-hook.cmd` resolves Git Bash dynamically: `CLAUDE_CODE_GIT_BASH_PATH`, system Git, user-level Git, then `where git.exe`. This supports Git for Windows installed by winget without administrator rights. If Git Bash is unavailable, hooks print `supergraph: Git Bash not found — hooks skipped` and exit successfully because hooks are non-blocking; skills and MCP remain usable.

[![Version](https://img.shields.io/badge/version-2.2.4-blue)](./plugins/supergraph/CHANGELOG.md) [![License](https://img.shields.io/badge/license-M