Skip to content
Β 
Β 

Repository files navigation

πŸš€ superclaude

A Claude Code content framework β€” fork-origin, now its own project

Version Tests License PRs Welcome

Origin & relationship to upstream. superclaude started as a fork of SuperClaude_Framework (Kazuki Nakai, NomenAK, Mithun Gowda B). It has since diverged β€” different MCP set, insight pipeline, scope-explicit install, tightened workflow gates β€” and is no longer a downstream of upstream. The two projects share neither roadmap nor maintainers.


πŸ“Š At a glance

Commands Agents Modes MCP Servers
36 23 8 4
Slash Domain-expert Behavioral Integrations

36 slash commands cover the development lifecycle from brainstorming to deployment. 8 behavioral modes auto-load on matching flags and keywords.


🎯 Overview

superclaude is a content framework for Claude Code: a directory of markdown (commands, agents, modes, MCP docs, core rules) plus a small CLI / pytest plugin that installs that content into Claude Code's content directories β€” ~/.claude/ (user), ./.claude/ (project, committed), or ./.claude/ (local, personal β€” kept out of git through the clone's .git/info/exclude).

Claude Code reads those files at session start, which is how the framework changes its behavior. There is no runtime engine, no daemon, no proxy.

Disclaimer. This project is not affiliated with or endorsed by Anthropic, nor by the upstream SuperClaude Framework. Claude Code is built and maintained by Anthropic.


πŸ“– For developers & contributors

Essential reading when working in this repo:

File Purpose
CLAUDE.md Project-specific rules: env (UV), make targets, how to run the tests, git workflow
src/superclaude/ARCHITECTURE.md Content-framework taxonomy β€” directory roles, delivery pipelines, content types
src/superclaude/CLAUDE_SC.md The always-loaded import chain β†’ core/FLAGS.md, PRINCIPLES.md, RULES.md
.claude/rules/ Authoring specs for agents/commands/modes
.claude/rules/gotchas/ Project-specific traps (e.g. do not Read sub-agent *.output files)
SECURITY.md Security disclosure policy

Claude Code auto-loads CLAUDE.md and the core/ import chain at session start, so the rules apply to every interaction inside this repo.

⚑ Quick Installation

Current Stable Version (v4.10.0+ajitta)

superclaude ships markdown content (commands, agents, modes, MCP docs, core rules, hooks) plus a small CLI that copies it into Claude Code's content directories.

1. Install the CLI

git clone https://github.com/ajitta/superclaude.git
cd superclaude

# Editable uv tool install β€” `superclaude` becomes available globally.
make deploy
# Equivalent without make:
# uv tool install --force --editable .

2. Install framework content with superclaude install

superclaude install                    # default: --scope user (~/.claude/, global)
superclaude install --scope project    # team-shared, committed to ./.claude/
superclaude install --scope local      # personal-in-team-repo (./.claude/, kept out of git via
                                       #   .git/info/exclude; settings.local.json + CLAUDE.local.md)
superclaude install --force            # overwrite an existing install
superclaude install -i                 # interactive wizard (scope β†’ preview β†’ confirm)
superclaude install --list             # show available components, install nothing
superclaude install --list-all         # show every component + its install status

What gets installed (per scope):

<scope>/
β”œβ”€β”€ commands/sc/        # 36 slash commands (/sc:plan, /sc:implement, …)
β”œβ”€β”€ agents/             # 23 agent definitions
β”œβ”€β”€ superclaude/        # core rules, modes, mcp docs
β”œβ”€β”€ hooks/hooks.json    # SessionStart / PreCompact / SessionEnd / etc.
└── settings(.local).json  # framework hooks merged in (your existing hooks preserved)

Every hook command is superclaude hook <name> β€” no interpreter path, no script copy β€” so a project-scope settings.json is the same bytes on every machine and can be committed. A reinstall over an older release rewrites its <python> …/<script>.py registrations to that form. Runtime state (.claude/.superclaude_hooks/, pending insights) stays out of git through the clone's .git/info/exclude, never your .gitignore.

3. Install MCP servers (optional)

Serena prerequisite. Serena's CLI is not installed by superclaude β€” install it yourself first per upstream's installation guide (uvx/pipx). superclaude mcp only handles MCP registration + recommended hooks.

superclaude mcp                        # interactive picker (default scope: user)
superclaude mcp --list                 # list available servers
superclaude mcp --servers tavily playwright
superclaude mcp --servers serena       # register Serena (CLI must already be installed)
superclaude mcp --scope project        # write to ./.mcp.json (team-shared)
superclaude mcp --scope local          # per-project block inside ~/.claude.json

Serena init/stale-entry issues? See docs/troubleshooting/serena-installation.md.

4. Verify

superclaude install --list-all          # component-by-component status
superclaude doctor                      # pytest plugin, hooks, CLAUDE_SC import, `superclaude` on PATH
superclaude verify-drift                # detect drift between source and installed copy
superclaude version

Restart Claude Code, then try a few:

  • /sc:brainstorm β€” Socratic discovery for vague requests
  • /sc:plan β€” Detailed TDD implementation plans
  • /sc:implement β€” Code implementation
  • /sc:review β€” Multi-dimensional review (code/plan/design)
  • /sc:research β€” Deep web research (Tavily-enhanced)
  • /sc:insight β€” Capture structured session insights to JSONL
  • /sc:help β€” List all 36 commands

Update

superclaude update                     # default: --scope user
superclaude update --scope project     # (update takes --scope only; use `install --force` to re-copy everything)

Uninstall

superclaude uninstall --dry-run        # preview, no changes
superclaude uninstall                  # default: --scope user, asks to confirm
superclaude uninstall -y               # skip confirmation
superclaude uninstall --scope project  # remove from ./.claude/
superclaude uninstall --scope local    # also removes CLAUDE.local.md + its .git/info/exclude block
superclaude uninstall --keep-settings  # leave settings.json hooks alone
superclaude uninstall --remove-mcp     # also unregister framework-installed MCP servers
                                       #   (default keeps them β€” they're shared with other tools)

The uninstall is marker-based: it removes only the hooks and the @superclaude/CLAUDE_SC.md import that the installer wrote. User-added hooks, MCP servers, and CLAUDE.md content are preserved unless you explicitly opt out.

CLI scope summary

Command Scopes Default
superclaude install / update / uninstall user, project, local user
superclaude mcp user, project, local user
Scope Path When to use
user ~/.claude/ Personal global install (default β€” daily use)
project ./.claude/ (committed) Team-shared, checked into git
local ./.claude/ (kept out of git via .git/info/exclude) Personal install inside a team repo (uses settings.local.json, CLAUDE.local.md)

For contributors/developers:

# Initial setup (editable mode for development)
uv pip install -e ".[dev]"

# Development cycle
uv run superclaude install --list-all  # Test changes immediately
uv run pytest tests/ -v                 # Run tests

# Deploy CLI as a global uv tool (editable). Content sync is a separate step.
make deploy

# Sync framework content to a scope (force-sync β€” for headless `claude -p`)
make sync-user      # β†’ ~/.claude/        (global, recommended for daily use)
make sync-project   # β†’ ./.claude/        (team-shared, committed)
make sync-local     # β†’ ./.claude/        (local-only, excluded from git per clone)

# Verify installation
uv tool list              # List installed tools
which superclaude         # Check install path (Linux/Mac)
where superclaude         # Check install path (Windows)
Stage Command Description
Dev/Test uv run superclaude ... Test in repo (editable)
Deploy CLI make deploy uv tool install --force --editable .
Sync content make sync-user / sync-project / sync-local Force-sync markdown/scripts to chosen scope
Use superclaude ... Run from anywhere
Uninstall make uninstall-user / uninstall-project / uninstall-local Scope-explicit removal

Optional MCP servers

The framework is fully functional without any MCP server. Each one adds a capability its flag switches on:

  • Serena β€” symbol-level code navigation and edits, plus cross-session project memory (--serena, /sc:load, /sc:save)
  • Tavily β€” web search / extract / crawl / research. Recommended as Agent Skills (npx skills add tavily-ai/skills); the MCP server is the optional in-conversation alternative (--tavily)
  • Context7 β€” official documentation lookup, enabled as a claude.ai connector rather than through superclaude mcp (--c7)
  • Playwright, Chrome DevTools β€” browser automation and performance audits (--play, --perf)

Source of truth for each server's usage: src/superclaude/mcp/MCP_*.md and src/superclaude/mcp/README.md.

Token Optimization (Optional β€” RTK)

rtk-ai/rtk is a single Rust binary that transparently rewrites common Bash commands (git status, pnpm install, pytest, …) into compact, LLM-friendly output β€” typically 60–90% token reduction on routine ops. Independent project; not bundled with superclaude.

# Install (pick one)
brew install rtk                                                                    # macOS / Linux (Homebrew)
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh   # Linux / macOS
cargo install --git https://github.com/rtk-ai/rtk                                   # Cargo
# Windows: download from https://github.com/rtk-ai/rtk/releases (WSL recommended)

# Verify
rtk --version
rtk gain                       # token-savings stats

# Enable Claude Code auto-rewrite hook (transparent β€” no prompt changes needed)
rtk init -g                    # restart Claude Code after running this

Once the hook is active, Claude's git status calls run as rtk git status automatically. Without the hook, prefix manually (rtk <cmd>).

Persistent Cross-Session Memory (Optional β€” claude-mem)

thedotmack/claude-mem is a memory-compression layer for Claude Code that automatically captures and recalls context across sessions. Independent project; complements superclaude's /sc:load + insight pipeline by storing observations queryable via the mem-search skill. Requires Node.js β‰₯18.

# Install (pick one)
npx claude-mem install                                # standard CLI install
# Or via Claude Code plugin marketplace:
#   /plugin marketplace add thedotmack/claude-mem
#   /plugin install claude-mem

# After install: restart Claude Code
# Web viewer: http://localhost:37777
# Settings: ~/.claude-mem/settings.json (auto-created)

Past observations show up at session start (# $CMEM block). Query with the mem-search skill or get_observations([IDs]).


🧭 Workflows

The framework's value comes from chaining commands. Each chain has gates: a step's output must be committed (or explicitly approved) before the next step runs. Pick the chain that matches the task's blast radius β€” don't pay brainstorm-level overhead for a typo, and don't skip design for a system rewrite.

By task size

Tier Trigger Recommended chain
Trivial Typo Β· 1-line fix Β· rename Β· obvious bug with known fix Direct edit. No /sc:* needed.
Small Single file Β· ≀ 50 added lines Β· clear scope /sc:implement (or /sc:improve) --plan β†’ /sc:test
Medium 3–10 files Β· multi-purpose Β· clear requirements /sc:plan β†’ /sc:implement --plan β†’ /sc:test β†’ /sc:reflect
Large > 10 files Β· cross-cutting Β· ambiguous scope Β· new system /sc:brainstorm β†’ /sc:design β†’ /sc:review β†’ /sc:plan β†’ /sc:implement --plan β†’ /sc:test β†’ /sc:reflect

The full chain (large tasks)

/sc:brainstorm   β†’   /sc:design   β†’   /sc:review   β†’   /sc:plan   β†’   /sc:implement --plan   β†’   /sc:test   β†’   /sc:reflect
   discover           specify          gate              decompose       build (TDD)                 verify        learn
   (Socratic)         (architecture)   (multi-lens)      (phases)        (per task)                  (baseline)    (capture)
Step Output Hard gate before next step
/sc:brainstorm docs/features/<slug>/01-discovery.md (one-off: docs/specs/<slug>-discovery-<user>-<date>.md) User approves discovery spec
/sc:design docs/features/<slug>/04-design.md (one-off: docs/specs/…-design-…md) Design committed (components pass the [R18] necessity test)
/sc:review Multi-dimensional review of design/plan Required β€” /sc:brainstorm hard-blocks /sc:plan until this runs
/sc:plan docs/features/<slug>/05-plan.md (one-off: docs/plans/…md) β€” phased TDD tasks, file paths, verify cmds Plan committed
/sc:implement --plan Code + per-phase commits Implementation complete
/sc:test Test pass evidence (42/42 pass, baseline 40) Real output, not predictions
/sc:reflect Retrospective + insights captured to .claude/insights.jsonl β€”

Other common chains

Goal Chain
Investigate a bug /sc:troubleshoot β†’ /sc:analyze --focus <domain> β†’ /sc:implement --plan β†’ /sc:test
Performance work /sc:analyze --focus perf --scope module β†’ /sc:improve --loop --focus perf β†’ /sc:test
Security audit /sc:analyze --focus security β†’ /sc:review β†’ /sc:improve --focus security
Refactor /sc:analyze --focus quality β†’ /sc:plan β†’ /sc:improve --loop β†’ /sc:test
External research /sc:research --depth deep --tavily --c7 β†’ /sc:reflect
Codebase onboarding /sc:load β†’ /sc:index-repo β†’ /sc:explain
Strategy / market /sc:business-panel β†’ /sc:reflect
End of branch /sc:review β†’ /sc:test β†’ /sc:git (commit + PR)

Tips

  • Skip steps when the input already exists. If you already have a written spec, jump straight to /sc:plan. The gates exist to prevent skipping unfinished work, not to force ceremony.
  • --plan flag on /sc:implement makes it consume a committed plan document. Without --plan, it works from the latest message.
  • /sc:review scores two dimensions β€” fidelity to the spec and quality of the artifact β€” and groups findings as Critical / Important / Suggestion. Treat its output as a checklist, not a verdict. --audit-delegated re-examines only the decisions the model made on your behalf.
  • /sc:reflect writes insights to .claude/insights.jsonl which /sc:load later reads β€” over time the framework remembers what worked.

πŸ™ Acknowledgements

superclaude builds on the original SuperClaude_Framework by Kazuki Nakai, NomenAK, and Mithun Gowda B. To support that upstream project's authors directly, see their channels on the upstream repo β€” sponsorship goes to them, not to this fork.

This fork is a personal, opinionated reshape of the framework: different MCP set, insight pipeline, scope-explicit deploy, tightened workflow gates. It is not maintained by the upstream authors.


πŸŽ‰ What's new in this fork

An insight pipeline, scope-explicit deployment, and tightened brainstorm β†’ plan β†’ implement β†’ review workflow gates.

πŸ›‘οΈ Hook-Enforced Safety

Rules that must hold are enforced by hooks, not prose:

  • destructive_guard β†’ blocks force-push to main/master, asks on reset --hard / clean -f / branch -D
  • file_size_guard β†’ blocks unbounded Read on files >30KB
  • loop_guard β†’ circuit breaker on repeated failing edits

Every hook runs as superclaude hook <name> (a console entry, dispatched before the CLI loads), so hooks cost ~20 ms and settings.json carries no machine-specific bytes. Hooks merge into your settings.json β€” your existing hooks are preserved. See docs/adr/0001-hooks-are-the-enforcement-boundary.md.

πŸ€– Smarter Agent System

23 specialized agents with domain expertise:

  • New: insight-analyst, repo-index, self-review, simplicity-guide, technical-writer, project-initializer
  • Deep Research agent for autonomous web research
  • Security/performance/quality engineers catch real issues
  • Frontend / backend / system architect for design work
  • Single-trigger disambiguation matrix in core/rules/RULES_DELEGATION.md

πŸ”§ MCP Server Integration

Curated and lean by default (no token bloat):

# List available MCP servers
superclaude mcp --list

# Install specific servers
superclaude mcp --servers tavily playwright

# Interactive installation
superclaude mcp

Available servers:

  • Tavily β†’ Web search, extract, crawl, map, research (Deep Research). Recommended: Agent Skills via Tavily CLI + npx skills add tavily-ai/skills (tavily-ai/skills Β· agent-skills docs). The --tavily MCP server is an optional in-conversation alternative (search + extract only).
  • Context7 β†’ Official documentation lookup. Enabled as a claude.ai connector (claude.ai β†’ Settings β†’ Connectors), not via superclaude mcp β€” --c7 stays as an inline directive in core/FLAGS.md; no MCP doc ships for it.
  • Serena β†’ Session persistence & semantic code understanding
  • Playwright β†’ Cross-browser automation & E2E testing (Microsoft official). Repo: 'https://github.com/microsoft/playwright-cli'
  • Chrome DevTools β†’ Performance, Lighthouse, accessibility, and memory profiling (CLS, LCP). Installed as Claude plugin from ChromeDevTools/chrome-devtools-mcp

Removed in this fork: Morphllm, Mindbase, Airis-Agent, Magic, AST-Grep (native Grep/Edit cover it), Sequential-Thinking (Claude 5-family models reason natively between tool calls β€” see docs/codex/sequential-thinking-validity-2026-08-22/).

🎯 Behavioral Modes

8 adaptive modes for different contexts:

  • Brainstorming β†’ Socratic discovery for vague requests
  • Business Panel β†’ Multi-expert strategic analysis
  • Deep Research β†’ Autonomous web research
  • Orchestration β†’ Efficient tool coordination
  • Token-Efficiency β†’ selective omission under context pressure (--uc): drop what does not change the next action, never compress what stays
  • Task Management β†’ Systematic organization
  • Introspection β†’ Meta-cognitive analysis & error recovery
  • Verbalized Sampling β†’ Probability-weighted candidate distributions (--vs)

πŸ““ Insight Pipeline

/sc:insight + hook-driven harvest:

  • Per-project JSONL store at .claude/insights.jsonl
  • superclaude insight CLI (append/list/query/stats/review/promote/discard)
  • PreCompact / SessionEnd hooks auto-harvest pending insights
  • Empty/non-string entries rejected at the writer boundary
  • Searchable for human and tool analysis across sessions

🚦 Tightened Workflow Gates

Brainstorm β†’ Plan β†’ Implement β†’ Review:

  • /sc:brainstorm hard-blocks /sc:plan until /sc:review runs
  • /sc:review --audit-delegated re-examines the decisions the model made on your behalf
  • Plan default: phase framing; opt-in --pr-bundle for multi-PR
  • verified: convention + SessionStart memory-staleness warning

πŸ“¦ Scope-Explicit Deployment

Separate CLI deploy from content sync:

  • make deploy β€” installs the CLI only (uv tool install --force --editable .)
  • make sync-user / sync-project / sync-local β€” force-sync markdown content to chosen scope
  • make uninstall-user / uninstall-project / uninstall-local β€” mirror targets
  • superclaude install/uninstall/update --scope user|project|local β€” consistent flag across CLI

πŸͺ Hook Subsystem

Settings-merge install + targeted hooks:

  • install_settings.py preserves user hooks via marker-based identification and rewrites a previous release's <python> …/<script>.py registrations to superclaude hook <name>
  • superclaude doctor checks that the superclaude on PATH has the hook subcommand β€” the package whose hooks actually run
  • test_runner_hook runs uv run python -m pytest (avoids the Windows uv canonicalize bug)
  • SessionStart: git status + memory staleness warning
  • PreCompact / SessionEnd: insight harvest
  • Hooks are additive β€” your existing config survives reinstall

πŸ”¬ Deep Research

Autonomous web research aligned with the DR agent architecture β€” adaptive planning, multi-hop reasoning, confidence-scored synthesis.

🎯 Adaptive Planning

Three intelligent strategies:

  • Planning-Only: Direct execution for clear queries
  • Intent-Planning: Clarification for ambiguous requests
  • Unified: Collaborative plan refinement (default)

πŸ”„ Multi-Hop Reasoning

Up to 5 iterative searches:

  • Entity expansion (Paper β†’ Authors β†’ Works)
  • Concept deepening (Topic β†’ Details β†’ Examples)
  • Temporal progression (Current β†’ Historical)
  • Causal chains (Effect β†’ Cause β†’ Prevention)

πŸ“Š Quality Scoring

Confidence-based validation:

  • Source credibility assessment (0.0-1.0)
  • Coverage completeness tracking
  • Synthesis coherence evaluation
  • Minimum threshold: 0.6, Target: 0.8

🧠 Cross-Session Memory

Research memory through Serena:

  • Findings and query formulations saved with /sc:save
  • Recalled by /sc:load at the next session start
  • Reflection after every hop: assess quality, find gaps, replan
  • Serena optional β€” without it, research is single-session

Research Command Usage

# Basic research with automatic depth
/sc:research "latest AI developments 2026"

# Controlled depth β€” pass flags after the query
/sc:research "quantum computing breakthroughs" --depth exhaustive

# Strategy selection: planning | intent | unified (default)
/sc:research "market analysis" --strategy planning

# Pick the sources explicitly
/sc:research "React patterns" --tavily --c7

Research Depth Levels

Depth Sources Hops Time Confidence target Best For
Quick 10 1 ~2min 0.6 Quick facts, simple queries
Standard 20 3 ~5min 0.7 General research (default)
Deep 40 4 ~8min 0.8 Comprehensive analysis
Exhaustive 50+ 5 ~10min 0.9 Academic-level research

Profiles are defined in modes/RESEARCH_CONFIG.md.

Integrated Tool Orchestration

The Deep Research system intelligently coordinates multiple tools:

  • Tavily (Agent Skills; MCP optional): Primary web search and discovery
  • Playwright MCP: Complex content extraction
  • Serena MCP: Memory and learning persistence
  • Context7 (claude.ai connector): Technical documentation lookup

πŸ“š References

docs/archive/ holds the upstream-derived legacy tree and is not maintained. The rest of docs/ β€” features/, adr/, research/, agents/ β€” is this project's own. The table below names the source of truth per topic.

Topic Source of truth
Architecture & directory roles src/superclaude/ARCHITECTURE.md
Project rules, build & test loop CLAUDE.md
Project-specific gotchas .claude/rules/gotchas/
Serena MCP troubleshooting docs/troubleshooting/serena-installation.md
Slash commands (36) src/superclaude/commands/ Β· superclaude install --list-all
Agents (23) src/superclaude/agents/
Modes (8) src/superclaude/modes/
MCP servers (4) src/superclaude/mcp/
Hooks (registry + scripts) src/superclaude/cli/hook_dispatch.py Β· src/superclaude/hooks/hooks.json Β· src/superclaude/scripts/
Architecture decisions docs/adr/
Feature work (discovery β†’ plan β†’ retrospective) docs/features/
Agent conventions (issue tracker, triage labels, domain docs) docs/agents/
Core rules (always-loaded) FLAGS.md Β· PRINCIPLES.md Β· RULES.md
Authoring specs for new content .claude/rules/
Health & drift checks superclaude doctor Β· superclaude verify-drift Β· superclaude audit Β· superclaude context explain / reset

🚩 Flags

Flags are behavioral hints that any /sc:* prompt accepts. The model reads them inline β€” no setup, no separate config. SSOT: src/superclaude/core/FLAGS.md.

Modes β€” switch the conversational stance

Flag When to use Effect
--brainstorm Vague request, "maybe", unclear scope Collaborative discovery, probing questions before code
--research Need evidence, citations, external knowledge Systematic investigation, evidence-based reasoning
--business-panel Strategy/market/competitive analysis Multi-expert business analysis & synthesis
--introspect Stuck, error recovery, "why is it doing X?" Surfaces decision logic, assumptions and alternatives (πŸŽ―βš‘πŸ“ŠπŸ’‘ markers)
--task-manage >3 steps Β· >2 dirs Β· >3 files Hierarchical task organization + persistent memory checkpoints
--orchestrate Multi-tool, parallel, perf-sensitive Tool-matrix optimization
--token-efficient / --uc Context β‰₯ 60 % or large ops (auto with --safe-mode) Selective omission β€” drop what does not change the next action; never compress what stays
--vs [standard|cot|multi] "Multiple perspectives", brainstorm options Verbalized sampling β€” probability-weighted candidates. Sub-params: [k:3-7] [tau:0.01-0.20] [turns:2-5] [no-synthesis]

MCP servers β€” opt in or out per turn

Flag Server Use for
--c7 / --context7 Context7 Imports, frameworks, official docs
--serena Serena Symbol ops, project memory, semantic exploration
--play / --playwright Playwright Browser testing, E2E, visual diffs
--perf / --devtools Chrome DevTools Perf audit, CLS, LCP, metrics
--tavily Tavily Web search, real-time info, parallel queries
--frontend-verify Combined Playwright + DevTools + Serena (UI debug)
--all-mcp / --no-mcp β€” Enable all / disable all (perf priority)

Execution β€” control how work is done

Flag Effect
--delegate [auto|files|folders] Sub-agent parallel delegation. Decision matrix: RULES_DELEGATION.md <sub_agent_decision>
--concurrency [n] Batch independent tool calls (1–15) into a single message
--loop Iterative improvement β€” repeat until no meaningful improvement found
--iterations [n] Fixed iteration count β€” exactly N cycles, with per-iteration delta report
--plan 5-line plan (goal Β· approach Β· files Β· risks Β· verification) before execution
--validate Pre-execution risk assessment (risk > 0.7, prod)
--safe-mode Max validation, conservative behavior, auto --uc
--verbose-context Force full .md injection (bypass short-instruction map)

Scope & focus

Flag Values
--scope file Β· module Β· project Β· system
--focus perf Β· security Β· quality Β· arch Β· a11y Β· testing

Priority when flags conflict: --safe-mode > --validate > optimization Β· explicit user flags > auto-detection Β· --no-mcp overrides individual MCP flags.

Retired flags (--think*, --parallel, --seq / --sequential) get a redirect notice rather than a rewrite. An unrecognized flag is matched by difflib similarity β€” not edit distance β€” first against retired names (cutoff 0.8), then against valid ones (cutoff 0.6), and the closest become a suggestion comment. Nothing is silently rewritten: context_loader.py ships an empty alias table.

Examples

/sc:research "Rust async runtime tradeoffs" --depth deep --tavily --c7
/sc:implement "user export endpoint" --plan --validate --delegate auto
/sc:analyze src/auth/ --focus security --scope module
/sc:improve src/api/handlers.py --loop --iterations 3 --serena
/sc:brainstorm "should we migrate to gRPC?" --vs multi

βš–οΈ License

MIT β€” see LICENSE.


πŸ“‹ All Commands

Click to expand full command list

🧠 Planning & Design

  • /sc:brainstorm β€” Structured brainstorming through Socratic dialogue
  • /sc:design β€” System architecture, APIs, component interfaces
  • /sc:plan β€” Detailed implementation plans with TDD tasks
  • /sc:estimate β€” Time/effort estimation
  • /sc:spec-panel β€” Multi-expert specification review
  • /sc:roadmap β€” Phased implementation workflow from a PRD or feature doc

πŸ’» Development

  • /sc:implement β€” Code implementation
  • /sc:build β€” Build workflows
  • /sc:improve β€” Code improvements
  • /sc:cleanup β€” Refactoring & dead-code removal
  • /sc:explain β€” Code explanation

πŸ§ͺ Testing & Quality

  • /sc:test β€” Run tests with coverage and quality reporting
  • /sc:analyze β€” Code analysis (quality, security, perf, arch)
  • /sc:troubleshoot β€” Diagnose & resolve issues
  • /sc:reflect β€” Task retrospectives
  • /sc:review β€” Multi-dimensional review of work products

πŸ“š Documentation

  • /sc:document β€” Doc generation
  • /sc:promote-feature β€” Consolidate standalone docs into a feature folder
  • /sc:help β€” Command help

πŸ”§ Version Control

  • /sc:git β€” Git operations with intelligent commits

πŸ“Š Project Management

  • /sc:pm β€” Project management & sub-agent orchestration
  • /sc:task β€” Task tracking
  • /sc:auto-improve β€” Autonomous metric-driven improvement loop

πŸ” Research & Analysis

  • /sc:research β€” Deep web research
  • /sc:business-panel β€” Multi-expert business analysis

πŸ—‚οΈ Session & Memory

  • /sc:load β€” Load session context (Serena + auto memory)
  • /sc:save β€” Save session context
  • /sc:insight β€” Capture structured insights to JSONL

🎯 Utilities

  • /sc:agent β€” Session controller: investigate β†’ implement β†’ review orchestration
  • /sc:init β€” Interactive project environment setup
  • /sc:index / /sc:index-repo β€” Repository indexing (94% token reduction)
  • /sc:recommend β€” Command recommendation engine
  • /sc:prompt β€” Rewrite a prompt for Claude Opus 5 / Fable 5.1
  • /sc:select-tool β€” Intelligent MCP tool selection
  • /sc:sc β€” Command dispatcher (routes to the other /sc:* commands)

Source files: src/superclaude/commands/ β€” each command is a single markdown file with frontmatter. After install, run superclaude install --list-all for a full inventory.

About

A Claude Code content framework: 36 slash commands, 23 agents, 8 behavioral modes, and hook-enforced rules, installed by a scope-explicit CLI (user/project/local).

Topics

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Contributors

Languages