datit309/supergraph
supergraph
Engineering workflow system for AI coding agents — mandatory planning, TDD, verification, review, and intelligent codebase graph analysis.
Install
npx @deepseek-ai/dsh plugin --profile web add github:datit309/supergraphRestart `dsh web` after install. Bundle APIs can change during the developer preview.
README badge
[](https://dshhub.dev/plugins/supergraph)Paste this into your README. The star count updates with every catalog sync.
From the README
Excerpt from datit309/supergraph, cleaned of badges and images.
Supergraph for AI Coding Agents
Tiếng Việt · Installation Guide · Workflow Examples · Team Setup
Turn AI coding agents from code generators into disciplined engineering workflow systems.
Supergraph enforces planning, TDD, verification, review, and architecture-aware decision making through mandatory workflows, graph intelligence, and LSP-powered code analysis across Claude Code, OpenAI Codex CLI, Google Antigravity, OpenCode, and DeepSeek Harness (DSH).
What Supergraph Does
Every non-trivial change follows the strict engineering lifecycle:
scan → analyze → plan → TDD → execute → fix → verify → review
- Knowledge Graph & Code Intelligence: Powered by Codebase Memory MCP (
>= 0.10.8,<0.11.0). Indexes repository state locally into.codebase-memory/graph.db.zst(cache in~/.cache/codebase-memory-mcp) viaindex_repository, providing mathematical blast radius, call hierarchy, dependency cycles, and test gaps. Serena provides LSP-level symbol navigation and diagnostics. - 7-Subagent Specialized Architecture: Autonomous separation of concerns —
plan-writer(planning),plan-reviewer(spec checks),executor(TDD execution),qa-tester(E2E browser/API testing),security-auditor(OWASP/Vibesec AppSec),diagnostician(root-cause debugging), andcode-reviewer(independent merge verdict). - Autonomous Human Browser Agent & QA (
browser-agent): Native Rust CDP (agent-browser, zero Playwright). Uses compact accessibility tree snapshots (@ref), bypasses anti-bot walls via real user profiles, generates 5-dimension ISTQB test matrices (UI + API + DB fault injection), and exports structured bug reports. - Multi-Agent Orchestration (
supergraph-team): Wave DAG task scheduling with isolated Git worktrees and live dashboard (:3333).
Windows Hook Behavior
On Windows, hooks/run-hook.cmd dynamically resolves Git Bash across standard and user-level paths. If Git Bash is not found, hooks skipped with a warning, keeping platform execution non-blocking.
Supported Platforms
| Platform | Configuration | Instructions File |
|---|---|---|
| Claude Code | Marketplace / Plugin | CLAUDE.md |
| OpenAI Codex CLI | Marketplace / Local installer | AGENTS.md |
| Google Antigravity | Local installer | AGENTS.md |
| OpenCode | Local installer (/skills) | OPENCODE.md |
| DeepSeek Harness (DSH) | Native Cordis Bundle (cordis.patch.yml) | AGENTS.md |
Quick Install (One-Command)
macOS, Linux, or WSL (defaults to all platforms):
curl -fsSL https://raw.githubusercontent.com/datit309/supergraph/master/install.sh | sh
Windows PowerShell 5.1+:
irm https://raw.githubusercontent.com/datit309/supergraph/master/install.ps1 | iex
Security: Inspect installer scripts before piping remote code into a shell.
Install for a specific platform:
curl -fsSL https://raw.githubusercontent.com/datit309/supergraph/master/install.sh | sh -s -- --platform [claude|codex|antigravity|opencode|dsh|all]
…
