tony363/superclaude
A configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.
npx skills add tony363/superclaudeREADME
SuperClaude Framework
A config-first meta-framework for Claude Code that provides 35 specialized agent personas (16 core + 12 traits + 7 extensions), 14 structured commands, 30 skills, and comprehensive MCP integration with quality-driven iterative workflows.
SuperClaude transforms Claude Code into a powerful development platform with specialized agent prompts, signal-based loop orchestration, and multi-model consensus capabilities. The core interface is markdown and YAML configuration files, with a Python orchestration layer for advanced workflows including quality gates, termination detection, and PAL MCP integration.
Table of Contents
- Overview
- Key Features
- Architecture
- Core Orchestration Layer
- Core API Reference
- Installation
- Quick Start
- Agent System
- Command System
- Loop Orchestration
- MCP Integrations
- Skills System
- Quality System
- Quality Gates
- Metrics System
- Type System
- Configuration
- Directory Structure
- Creating Custom Agents
- Contributing
Overview
SuperClaude is a meta-prompt framework that enhances Claude Code with:
- 35 Specialized Agents: 16 core + 12 composable traits + 7 domain extensions (tiered architecture)
- 30 Active Skills: 8 agent personas + 19 command workflows + 3 utility skills (plus 106 deprecated)
- 14 Structured Commands: analyze, implement, test, design, document, and more
- 6 Framework Modes: normal, brainstorming, introspection, task_management, token_efficiency, orchestration
- MCP Integration: PAL (11 tools), Rube (500+ apps via Composio, including web search)
- Quality Gates: KISS validator, Purity validator, and iterative quality loop
- Core Orchestration: ~3,200 lines Python for loop management, PAL integration, and skill learning
- Signal-Based Architecture: Structured communication between components
- Metrics System: Callback-based operational metrics with Prometheus/StatsD integration
Key Features
Config-First Hybrid Architecture
SuperClaude v7.0.0 is a config-first hybrid framework:
- Markdown Agent Personas: Each agent is a self-contained markdown file with YAML frontmatter
- YAML Configuration: 6 configuration files for agents, commands, quality, models, MCP, and framework settings
- Python Orchestration: Loop orchestrator, quality assessment, PAL integration, and skill learning
- Portable: Works with any Claude Code instance
- Extensible: Add agents by creating markdown files
Why Config-First Hybrid?
| Benefit | Description |
|---|---|
| Simplicity | Core interface is markdown/YAML files |
| Portability | Works with any Claude Code instance |
| Extensibility | Add agents by creating markdown files |
| Maintainability | Prompts are easy to refine and version |
| Version Control | Easy to diff and review prompt changes |
| Advanced Workflows | Python orchestration for quality gates and loop control |
| Safety | Hard limits on iterations, termination detection |
Tiered Agent Architecture
35 agents organized in a tiered system for composable expertise:
| Tier | Count | Purpose | Examples |
|---|---|---|---|
| Core | 16 | High-priority generalists | general-purpose, root-cause-analyst, refactoring-expert, security-engineer |
| Traits | 12 | Composable modifiers | security-first, performance-first, test-driven, minimal-changes, solid-aligned, crash-resilient, mcp-pal-enabled, mcp-rube-enabled |
| Extensions | 7 | Domain specialists | typescript-expert, golang-expert, rust-expert, react-specialist, kubernetes-specialist, data-engineer, ml-engineer |
Why Tiered? The v7 architecture provides a lean, composable system. Core agents handle most tasks, traits modify behavior (e.g., @security-engineer +security-first), and extensions provide deep domain expertise when needed.
Command System
14 structured commands with consistent patterns:
/sc:analyze - Static analysis, security review, performance bottlenecks
/sc:im
...
Publisher
tony363