Skip to content

An AI Dev Team Orchestrator for coding agents skills.

License

Notifications You must be signed in to change notification settings

mrsknetwork/supernova

Repository files navigation

Supernova

Unified Development Team Orchestration for Software Engineering.

License: MIT Platform: Claude Platform: Cursor Platform: Antigravity Platform: Codex Platform: OpenCode

Documentation | Security | Install Guide


Key Features

Team Lead Builder Security Maintenance
Orchestrator Builder Guard Modify
Socratic design refinement and intelligent routing. Red/Green TDD implementation with subagents. Real-time security scanning and LLM protections. Safe deletions, renames, and bulk updates.
  • Unified Command: Single entry point via /nova.
  • Cross-Platform: Native support for Claude Code, Cursor, Codex, and more.
  • TDD Enforcement: Mandatory verification gates for all code changes.
  • Subagent SDLC: Leverages agent-skills for complex multi-step delivery.

Compatibility Matrix

Supernova is designed to be platform-agnostic, providing optimized installation methods for leading AI interfaces.

Platform Support Level Primary Setup Config Format
Claude Code Full .claude-plugin/ plugin.json
Cursor Native .cursor-plugin/ plugin.json
Antigravity Beta .antigravity/ SKILL.md
Codex Managed .codex/ config.toml
OpenCode Flexible .opencode/ .opencode.json

Getting Started

Supernova is installed as a set of Agent Skills. Choose your platform for detailed autonomous installation steps:

  1. Claude Code Guide
  2. Cursor Setup Guide
  3. Antigravity Guide
  4. Codex Skill Setup
  5. OpenCode Local Setup

Quick Install (Manual)

git clone https://github.com/mrsknetwork/supernova.git
# Follow platform-specific README in dot-directories

Unified Commands

All capabilities are accessible via the /nova prefix.

Command Description
/nova Orchestrate: Auto-detects scope and routes to best workflow.
/nova build Build: Executes implementation with TDD and review.
/nova guard Guard: Security scan and LLM-injection check.
/nova modify Modify: Safe codebase restructuring with rollbacks.
/nova ship Ship: Finalize verification and commit work.
/nova debug Debug: Systematic 4-phase root cause analysis.
/nova review Review: Comprehensive code quality and security audit.

Core Skills

Skill Role
orchestrator Core logic for design and routing.
builder Test-driven implementation and verification.
guard Security scanning and validation.
ship Commits, pull requests, and workspace cleanup.
debugger Systematic root cause investigation.
modify Safe codebase restructuring with rollbacks.

SDLC Workflow Skills

These skills simulate real-world engineering roles to manage the entire Software Development Life Cycle:

Skill Role
plan Project Manager: Agile sprint planning, roadmap, and ticket breakdown.
system Architect: System design, ADRs, data modeling, API contracts.
context Staff Engineer: Codebase onboarding, dependency mapping, data flow analysis.
infra DevOps Engineer: Docker, CI/CD pipelines, Terraform, and deployments.

Additional specialists: docs, research, search, shadcn-ui.


Governance and Contributing

We follow industry standards for open-source health and development.


Philosophy

  1. Red/Green TDD: No code without a failing test first.
  2. Evidence over Claims: Verify results before declaring success.
  3. Socratic Design: Refine requirements before writing a single line.
  4. YAGNI & DRY: Keep the codebase lean and maintainable.

Copyright (c) 2026 Kamesh. MIT License.