SuperClaude — Workflow Framework for Claude Code

Introduction

SuperClaude is a configuration framework that bolts a complete development workflow onto Claude Code. One install drops 16+ slash commands, 9 cognitive personas, an MCP server bundle, and a smart-flag system into your ~/.claude/ directory — turning a stock Claude Code setup into a structured, opinionated dev environment in under a minute.

What SuperClaude Does

• Installs a curated set of slash commands like /build, /troubleshoot, /improve, /document, /explain, and /test.
• Provides 9 swappable personas (architect, frontend, backend, security, mentor, refactorer, and more) that change how Claude approaches your task.
• Adds a flag system (--think, --plan, --uc) so commands can be tuned without rewriting them.
• Wires up MCP servers that the framework expects — sequential thinking, context, search — out of the box.
• Ships with an updater so you can pull new commands and personas as the project iterates.

Architecture Overview

SuperClaude is a Python CLI distributed via pipx. The install command writes Markdown command definitions, persona files, and a CLAUDE.md profile into ~/.claude/. Commands and personas are plain text, so Claude Code reads them natively — there is no runtime daemon. Updates use a 3-way merge against your existing ~/.claude/ so local edits survive.

Self-Hosting & Configuration

• Single dependency: a working claude CLI. The framework itself adds no servers.
• SuperClaude install is idempotent — re-run it to refresh commands without nuking your customizations.
• Edit any installed command or persona in place; updates use a 3-way merge.
• Full uninstall: SuperClaude uninstall removes only the files it placed.
• All command and persona definitions are open Markdown — fork and re-publish your own flavor easily.

Key Features

• One-command install of an entire opinionated workflow.
• Cognitive personas — same model, dramatically different behaviors.
• 16+ workflow slash commands tuned for real engineering tasks, not toys.
• Flags layer that composes orthogonally with commands.
• Active community: the command library and persona pack are versioned and updated.

Comparison with Similar Tools

• Claude Code defaults — clean slate, no personas, no opinionated commands. SuperClaude fills that gap.
• Aider — opinionated CLI in its own right; SuperClaude lives inside Claude Code instead of replacing it.
• AutoGen / CrewAI — multi-agent frameworks; SuperClaude is a single-agent productivity layer.
• Cursor Rules — IDE-specific equivalent of personas; SuperClaude works at the CLI and skill layer.
• Vanilla ~/.claude/ tweaks — same surface, but SuperClaude curates and versions the content.

FAQ

Q: Will SuperClaude overwrite my existing slash commands? A: Only on conflicts. The installer warns and prompts for merges; clean directories install silently.

Q: Do I need a separate API key? A: No — it runs entirely through your existing Claude Code auth.

Q: Can I use only some of the personas? A: Yes. Each persona is a separate file in ~/.claude/personas/ — delete or edit any of them.

Q: Is this affiliated with Anthropic? A: No. It is a community framework built on top of Claude Code public extension surface.

Sources

• https://github.com/SuperClaude-Org/SuperClaude_Framework
• https://superclaude.dev