{
  "markdown": "<div align=\"center\">\n\n# 🚀 SuperClaude Framework\n\n[![Run in Smithery](https://smithery.ai/badge/skills/SuperClaude-Org)](https://smithery.ai/skills?ns=SuperClaude-Org&utm_source=github&utm_medium=badge)\n\n\n### **Transform Claude Code into a Structured Development Platform**\n\n<p align=\"center\">\n  <a href=\"https://github.com/hesreallyhim/awesome-claude-code/\">\n  <img src=\"https://awesome.re/mentioned-badge-flat.svg\" alt=\"Mentioned in Awesome Claude Code\">\n  </a>\n<a href=\"https://github.com/SuperClaude-Org/SuperGemini_Framework\" target=\"_blank\">\n  <img src=\"https://img.shields.io/badge/Try-SuperGemini_Framework-blue\" alt=\"Try SuperGemini Framework\"/>\n</a>\n<a href=\"https://github.com/SuperClaude-Org/SuperQwen_Framework\" target=\"_blank\">\n  <img src=\"https://img.shields.io/badge/Try-SuperQwen_Framework-orange\" alt=\"Try SuperQwen Framework\"/>\n</a>\n  <img src=\"https://img.shields.io/badge/version-4.3.0-blue\" alt=\"Version\">\n  <a href=\"https://github.com/SuperClaude-Org/SuperClaude_Framework/actions/workflows/test.yml\">\n    <img src=\"https://github.com/SuperClaude-Org/SuperClaude_Framework/actions/workflows/test.yml/badge.svg\" alt=\"Tests\">\n  </a>\n  <img src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License\">\n  <img src=\"https://img.shields.io/badge/PRs-welcome-brightgreen.svg\" alt=\"PRs Welcome\">\n</p>\n\n<p align=\"center\">\n  <a href=\"https://superclaude.netlify.app/\">\n    <img src=\"https://img.shields.io/badge/🌐_Visit_Website-blue\" alt=\"Website\">\n  </a>\n  <a href=\"https://pypi.org/project/superclaude/\">\n    <img src=\"https://img.shields.io/pypi/v/SuperClaude.svg?\" alt=\"PyPI\">\n  </a>\n  <a href=\"https://pepy.tech/projects/superclaude\">\n    <img src=\"https://static.pepy.tech/personalized-badge/superclaude?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads\" alt=\"PyPI sats\">\n  </a>\n  <a href=\"https://www.npmjs.com/package/@bifrost_inc/superclaude\">\n    <img src=\"https://img.shields.io/npm/v/@bifrost_inc/superclaude.svg\" alt=\"npm\">\n  </a>\n</p>\n\n<p align=\"center\">\n  <a href=\"README.md\">\n    <img src=\"https://img.shields.io/badge/🇺🇸_English-blue\" alt=\"English\">\n  </a>\n  <a href=\"README-zh.md\">\n    <img src=\"https://img.shields.io/badge/🇨🇳_中文-red\" alt=\"中文\">\n  </a>\n  <a href=\"README-ja.md\">\n    <img src=\"https://img.shields.io/badge/🇯🇵_日本語-green\" alt=\"日本語\">\n  </a>\n</p>\n\n<p align=\"center\">\n  <a href=\"#-quick-installation\">Quick Start</a> •\n  <a href=\"#-support-the-project\">Support</a> •\n  <a href=\"#-whats-new-in-v4\">Features</a> •\n  <a href=\"#-documentation\">Docs</a> •\n  <a href=\"#-contributing\">Contributing</a>\n</p>\n\n</div>\n\n---\n\n<div align=\"center\">\n\n## 📊 **Framework Statistics**\n\n| **Commands** | **Agents** | **Modes** | **MCP Servers** |\n|:------------:|:----------:|:---------:|:---------------:|\n| **30** | **20** | **7** | **8** |\n| Slash Commands | Specialized AI | Behavioral | Integrations |\n\n30 slash commands covering the complete development lifecycle from brainstorming to deployment.\n\n</div>\n\n---\n\n<div align=\"center\">\n\n## 🎯 **Overview**\n\nSuperClaude is a **meta-programming configuration framework** that transforms Claude Code into a structured development platform through behavioral instruction injection and component orchestration. It provides systematic workflow automation with powerful tools and intelligent agents.\n\n\n## Disclaimer\n\nThis project is not affiliated with or endorsed by Anthropic.\nClaude Code is a product built and maintained by [Anthropic](https://www.anthropic.com/).\n\n## 📖 **For Developers & Contributors**\n\n**Essential documentation for working with SuperClaude Framework:**\n\n| Document | Purpose | When to Read |\n|----------|---------|--------------|\n| **[PLANNING.md](PLANNING.md)** | Architecture, design principles, absolute rules | Session start, before implementation |\n| **[TASK.md](TASK.md)** | Current tasks, priorities, backlog | Daily, before starting work |\n| **[KNOWLEDGE.md](KNOWLEDGE.md)** | Accumulated insights, best practices, troubleshooting | When encountering issues, learning patterns |\n| **[CONTRIBUTING.md](CONTRIBUTING.md)** | Contribution guidelines, workflow | Before submitting PRs |\n| **[Commands Reference](docs/user-guide/commands.md)** | Complete reference for all 30 `/sc:*` commands with syntax, examples, workflows, and decision guides | Learning SuperClaude, choosing the right command |\n\n> **💡 Pro Tip**: Claude Code reads these files at session start to ensure consistent, high-quality development aligned with project standards.\n>\n> **📚 New to SuperClaude?** Start with [Commands Reference](docs/user-guide/commands.md) — it contains visual decision trees, detailed command comparisons, and workflow examples to help you understand which commands to use and when.\n\n## ⚡ **Quick Installation**\n\n> **IMPORTANT**: The TypeScript plugin system described in older documentation is\n> not yet available (planned for v5.0). For current installation\n> instructions, please follow the steps below for v4.x.\n\n### **Current Stable Version (v4.3.0)**\n\nSuperClaude currently uses slash commands.\n\n**Option 1: pipx (Recommended)**\n```bash\n# Install from PyPI\npipx install superclaude\n\n# Install commands (installs all 30 slash commands)\nsuperclaude install\n\n# Install MCP servers (optional, for enhanced capabilities)\nsuperclaude mcp --list         # List available MCP servers\nsuperclaude mcp                # Interactive installation\nsuperclaude mcp --servers tavily --servers context7  # Install specific servers\n\n# Verify installation\nsuperclaude install --list\nsuperclaude doctor\n```\n\nAfter installation, restart Claude Code to use 30 commands including:\n- `/sc:research` - Deep web research (enhanced with Tavily MCP)\n- `/sc:brainstorm` - Structured brainstorming\n- `/sc:implement` - Code implementation\n- `/sc:test` - Testing workflows\n- `/sc:pm` - Project management\n- `/sc` - Show all 30 available commands\n\n**Option 2: Direct Installation from Git**\n```bash\n# Clone the repository\ngit clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git\ncd SuperClaude_Framework\n\n# Run the installation script\n./install.sh\n```\n\n### **Coming in v5.0 (In Development)**\n\nWe are actively working on a new TypeScript plugin system (see issue [#419](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues/419) for details). When released, installation will be simplified to:\n\n```bash\n# This feature is not yet available\n/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace\n/plugin install superclaude\n```\n\n**Status**: In development. No ETA has been set.\n\n### **Enhanced Performance (Optional MCPs)**\n\nFor **2-3x faster** execution and **30-50% fewer tokens**, optionally install MCP servers:\n\n```bash\n# Optional MCP servers for enhanced performance (via airis-mcp-gateway):\n# - Serena: Code understanding (2-3x faster)\n# - Sequential: Token-efficient reasoning (30-50% fewer tokens)\n# - Tavily: Web search for Deep Research\n# - Context7: Official documentation lookup\n# - Mindbase: Semantic search across all conversations (optional enhancement)\n\n# Note: Error learning available via built-in ReflexionMemory (no installation required)\n# Mindbase provides semantic search enhancement (requires \"recommended\" profile)\n# Install MCP servers: https://github.com/agiletec-inc/airis-mcp-gateway\n# See docs/mcp/mcp-integration-policy.md for details\n```\n\n**Performance Comparison:**\n- **Without MCPs**: Fully functional, standard performance ✅\n- **With MCPs**: 2-3x faster, 30-50% fewer tokens ⚡\n\n</div>\n\n---\n\n<div align=\"center\">\n\n## 💖 **Support the Project**\n\n> Hey, let's be real - maintaining SuperClaude takes time and resources.\n> \n> *The Claude Max subscription alone runs $100/month for testing, and that's before counting the hours spent on documentation, bug fixes, and feature development.*\n> *If you're finding value in SuperClaude for your daily work, consider supporting the project.*\n> *Even a few dollars helps cover the basics and keeps development active.*\n> \n> Every contributor matters, whether through code, feedback, or support. Thanks for being part of this community! 🙏\n\n<table>\n<tr>\n<td align=\"center\" width=\"33%\">\n  \n### ☕ **Ko-fi**\n[![Ko-fi](https://img.shields.io/badge/Support_on-Ko--fi-ff5e5b?logo=ko-fi)](https://ko-fi.com/superclaude)\n\n*One-time contributions*\n\n</td>\n<td align=\"center\" width=\"33%\">\n\n### 🎯 **Patreon**\n[![Patreon](https://img.shields.io/badge/Become_a-Patron-f96854?logo=patreon)](https://patreon.com/superclaude)\n\n*Monthly support*\n\n</td>\n<td align=\"center\" width=\"33%\">\n\n### 💜 **GitHub**\n[![GitHub Sponsors](https://img.shields.io/badge/GitHub-Sponsor-30363D?logo=github-sponsors)](https://github.com/sponsors/SuperClaude-Org)\n\n*Flexible tiers*\n\n</td>\n</tr>\n</table>\n\n### **Your Support Enables:**\n\n| Item | Cost/Impact |\n|------|-------------|\n| 🔬 **Claude Max Testing** | $100/month for validation & testing |\n| ⚡ **Feature Development** | New capabilities & improvements |\n| 📚 **Documentation** | Comprehensive guides & examples |\n| 🤝 **Community Support** | Quick issue responses & help |\n| 🔧 **MCP Integration** | Testing new server connections |\n| 🌐 **Infrastructure** | Hosting & deployment costs |\n\n> **Note:** No pressure though - the framework stays open source regardless. Just knowing people use and appreciate it is motivating. Contributing code, documentation, or spreading the word helps too! 🙏\n\n</div>\n\n---\n\n<div align=\"center\">\n\n## 🎉 **What's New in v4.1**\n\n> *Version 4.1 focuses on stabilizing the slash command architecture, enhancing agent capabilities, and improving documentation.*\n\n<table>\n<tr>\n<td width=\"50%\">\n\n### 🤖 **Smarter Agent System**\n**20 specialized agents** with domain expertise:\n- PM Agent ensures continuous learning through systematic documentation\n- Deep Research agent for autonomous web research\n- Security engineer catches real vulnerabilities\n- Frontend architect understands UI patterns\n- Automatic coordination based on context\n- Domain-specific expertise on demand\n\n</td>\n<td width=\"50%\">\n\n### ⚡ **Optimized Performance**\n**Smaller framework, bigger projects:**\n- Reduced framework footprint\n- More context for your code\n- Longer conversations possible\n- Complex operations enabled\n\n</td>\n</tr>\n<tr>\n<td width=\"50%\">\n\n### 🔧 **MCP Server Integration**\n**8 powerful servers** with easy CLI installation:\n\n```bash\n# List available MCP servers\nsuperclaude mcp --list\n\n# Install specific servers\nsuperclaude mcp --servers tavily context7\n\n# Interactive installation\nsuperclaude mcp\n```\n\n**Available servers:**\n- **Tavily** → Primary web search (Deep Research)\n- **Context7** → Official documentation lookup\n- **Sequential-Thinking** → Multi-step reasoning\n- **Serena** → Session persistence & memory\n- **Playwright** → Cross-browser automation\n- **Magic** → UI component generation\n- **Morphllm-Fast-Apply** → Context-aware code modifications\n- **Chrome DevTools** → Performance analysis\n\n</td>\n<td width=\"50%\">\n\n### 🎯 **Behavioral Modes**\n**7 adaptive modes** for different contexts:\n- **Brainstorming** → Asks right questions\n- **Business Panel** → Multi-expert strategic analysis\n- **Deep Research** → Autonomous web research\n- **Orchestration** → Efficient tool coordination\n- **Token-Efficiency** → 30-50% context savings\n- **Task Management** → Systematic organization\n- **Introspection** → Meta-cognitive analysis\n\n</td>\n</tr>\n<tr>\n<td width=\"50%\">\n\n### 📚 **Documentation Overhaul**\n**Complete rewrite** for developers:\n- Real examples & use cases\n- Common pitfalls documented\n- Practical workflows included\n- Better navigation structure\n\n</td>\n<td width=\"50%\">\n\n### 🧪 **Enhanced Stability**\n**Focus on reliability:**\n- Bug fixes for core commands\n- Improved test coverage\n- More robust error handling\n- CI/CD pipeline improvements\n\n</td>\n</tr>\n</table>\n\n</div>\n\n---\n\n<div align=\"center\">\n\n## 🔬 **Deep Research Capabilities**\n\n### **Autonomous Web Research Aligned with DR Agent Architecture**\n\nSuperClaude v4.2 introduces comprehensive Deep Research capabilities, enabling autonomous, adaptive, and intelligent web research.\n\n<table>\n<tr>\n<td width=\"50%\">\n\n### 🎯 **Adaptive Planning**\n**Three intelligent strategies:**\n- **Planning-Only**: Direct execution for clear queries\n- **Intent-Planning**: Clarification for ambiguous requests\n- **Unified**: Collaborative plan refinement (default)\n\n</td>\n<td width=\"50%\">\n\n### 🔄 **Multi-Hop Reasoning**\n**Up to 5 iterative searches:**\n- Entity expansion (Paper → Authors → Works)\n- Concept deepening (Topic → Details → Examples)\n- Temporal progression (Current → Historical)\n- Causal chains (Effect → Cause → Prevention)\n\n</td>\n</tr>\n<tr>\n<td width=\"50%\">\n\n### 📊 **Quality Scoring**\n**Confidence-based validation:**\n- Source credibility assessment (0.0-1.0)\n- Coverage completeness tracking\n- Synthesis coherence evaluation\n- Minimum threshold: 0.6, Target: 0.8\n\n</td>\n<td width=\"50%\">\n\n### 🧠 **Case-Based Learning**\n**Cross-session intelligence:**\n- Pattern recognition and reuse\n- Strategy optimization over time\n- Successful query formulations saved\n- Performance improvement tracking\n\n</td>\n</tr>\n</table>\n\n### **Research Command Usage**\n\n```bash\n# Basic research with automatic depth\n/research \"latest AI developments 2024\"\n\n# Controlled research depth (via options in TypeScript)\n/research \"quantum computing breakthroughs\"  # depth: exhaustive\n\n# Specific strategy selection\n/research \"market analysis\"  # strategy: planning-only\n\n# Domain-filtered research (Tavily MCP integration)\n/research \"React patterns\"  # domains: reactjs.org,github.com\n```\n\n### **Research Depth Levels**\n\n| Depth | Sources | Hops | Time | Best For |\n|:-----:|:-------:|:----:|:----:|----------|\n| **Quick** | 5-10 | 1 | ~2min | Quick facts, simple queries |\n| **Standard** | 10-20 | 3 | ~5min | General research (default) |\n| **Deep** | 20-40 | 4 | ~8min | Comprehensive analysis |\n| **Exhaustive** | 40+ | 5 | ~10min | Academic-level research |\n\n### **Integrated Tool Orchestration**\n\nThe Deep Research system intelligently coordinates multiple tools:\n- **Tavily MCP**: Primary web search and discovery\n- **Playwright MCP**: Complex content extraction\n- **Sequential MCP**: Multi-step reasoning and synthesis\n- **Serena MCP**: Memory and learning persistence\n- **Context7 MCP**: Technical documentation lookup\n\n</div>\n\n---\n\n<div align=\"center\">\n\n## 📚 **Documentation**\n\n### **Complete Guide to SuperClaude**\n\n<table>\n<tr>\n<th align=\"center\">🚀 Getting Started</th>\n<th align=\"center\">📖 User Guides</th>\n<th align=\"center\">🛠️ Developer Resources</th>\n<th align=\"center\">📋 Reference</th>\n</tr>\n<tr>\n<td valign=\"top\">\n\n- 📝 [**Quick Start Guide**](docs/getting-started/quick-start.md)  \n  *Get up and running fast*\n\n- 💾 [**Installation Guide**](docs/getting-started/installation.md)  \n  *Detailed setup instructions*\n\n</td>\n<td valign=\"top\">\n\n- 🎯 [**Slash Commands**](docs/reference/commands-list.md)\n  *All 30 commands organized by category*\n\n- 🤖 [**Agents Guide**](docs/user-guide/agents.md)  \n  *20 specialized agents*\n\n- 🎨 [**Behavioral Modes**](docs/user-guide/modes.md)  \n  *7 adaptive modes*\n\n- 🚩 [**Flags Guide**](docs/user-guide/flags.md)  \n  *Control behaviors*\n\n- 🔧 [**MCP Servers**](docs/user-guide/mcp-servers.md)  \n  *8 server integrations*\n\n- 💼 [**Session Management**](docs/user-guide/session-management.md)  \n  *Save & restore state*\n\n</td>\n<td valign=\"top\">\n\n- 🏗️ [**Technical Architecture**](docs/developer-guide/technical-architecture.md)  \n  *System design details*\n\n- 💻 [**Contributing Code**](docs/developer-guide/contributing-code.md)  \n  *Development workflow*\n\n- 🧪 [**Testing & Debugging**](docs/developer-guide/testing-debugging.md)  \n  *Quality assurance*\n\n</td>\n<td valign=\"top\">\n- 📓 [**Examples Cookbook**](docs/reference/examples-cookbook.md)  \n  *Real-world recipes*\n\n- 🔍 [**Troubleshooting**](docs/reference/troubleshooting.md)  \n  *Common issues & fixes*\n\n</td>\n</tr>\n</table>\n\n</div>\n\n---\n\n<div align=\"center\">\n\n## 🤝 **Contributing**\n\n### **Join the SuperClaude Community**\n\nWe welcome contributions of all kinds! Here's how you can help:\n\n| Priority | Area | Description |\n|:--------:|------|-------------|\n| 📝 **High** | Documentation | Improve guides, add examples, fix typos |\n| 🔧 **High** | MCP Integration | Add server configs, test integrations |\n| 🎯 **Medium** | Workflows | Create command patterns & recipes |\n| 🧪 **Medium** | Testing | Add tests, validate features |\n| 🌐 **Low** | i18n | Translate docs to other languages |\n\n<p align=\"center\">\n  <a href=\"CONTRIBUTING.md\">\n    <img src=\"https://img.shields.io/badge/📖_Read-Contributing_Guide-blue\" alt=\"Contributing Guide\">\n  </a>\n  <a href=\"https://github.com/SuperClaude-Org/SuperClaude_Framework/graphs/contributors\">\n    <img src=\"https://img.shields.io/badge/👥_View-All_Contributors-green\" alt=\"Contributors\">\n  </a>\n</p>\n\n</div>\n\n---\n\n<div align=\"center\">\n\n## ⚖️ **License**\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n<p align=\"center\">\n  <img src=\"https://img.shields.io/badge/License-MIT-yellow.svg?\" alt=\"MIT License\">\n</p>\n\n</div>\n\n---\n\n<div align=\"center\">\n\n## ⭐ **Star History**\n\n<a href=\"https://star-history.dera.page/#SuperClaude-Org/SuperClaude_Framework&Timeline\">\n <picture>\n   <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://star-history.dera.page/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline&theme=dark\" />\n   <source media=\"(prefers-color-scheme: light)\" srcset=\"https://star-history.dera.page/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline\" />\n   <img alt=\"Star History Chart\" src=\"https://star-history.dera.page/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline\" />\n </picture>\n</a>\n\n\n</div>\n\n---\n\n<div align=\"center\">\n\n### **🚀 Built with passion by the SuperClaude community**\n\n<p align=\"center\">\n  <sub>Made with ❤️ for developers who push boundaries</sub>\n</p>\n\n<p align=\"center\">\n  <a href=\"#-superclaude-framework\">Back to Top ↑</a>\n</p>\n\n</div>\n\n---\n\n## 📋 **All 30 Commands**\n\n<details>\n<summary><b>Click to expand full command list</b></summary>\n\n### 🧠 Planning & Design (4)\n- `/brainstorm` - Structured brainstorming\n- `/design` - System architecture\n- `/estimate` - Time/effort estimation\n- `/spec-panel` - Specification analysis\n\n### 💻 Development (5)\n- `/implement` - Code implementation\n- `/build` - Build workflows\n- `/improve` - Code improvements\n- `/cleanup` - Refactoring\n- `/explain` - Code explanation\n\n### 🧪 Testing & Quality (4)\n- `/test` - Test generation\n- `/analyze` - Code analysis\n- `/troubleshoot` - Debugging\n- `/reflect` - Retrospectives\n\n### 📚 Documentation (2)\n- `/document` - Doc generation\n- `/help` - Command help\n\n### 🔧 Version Control (1)\n- `/git` - Git operations\n\n### 📊 Project Management (3)\n- `/pm` - Project management\n- `/task` - Task tracking\n- `/workflow` - Workflow automation\n\n### 🔍 Research & Analysis (2)\n- `/research` - Deep web research\n- `/business-panel` - Business analysis\n\n### 🎯 Utilities (9)\n- `/agent` - AI agents\n- `/index-repo` - Repository indexing\n- `/index` - Indexing alias\n- `/recommend` - Command recommendations\n- `/select-tool` - Tool selection\n- `/spawn` - Parallel tasks\n- `/load` - Load sessions\n- `/save` - Save sessions\n- `/sc` - Show all commands\n\n[**📖 View Detailed Command Reference →**](docs/reference/commands-list.md)\n\n</details>\n\n",
  "bytes": 19308,
  "sha": "f477b0310168ab45c9bc9aa507a570814813dcdf3a92ab4992810f9ba53cdc30",
  "repo_slug": "superclaude-org/superclaude_framework",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_superclaude_org_superclaude_framework_cl_ad8f8fc3/readme"
}