mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
050d5ea2ab
* fix(orchestration): add WebFetch auto-trigger for infrastructure configuration Problem: Infrastructure configuration changes (e.g., Traefik port settings) were being made based on assumptions without consulting official documentation, violating the 'Evidence > assumptions' principle in PRINCIPLES.md. Solution: - Added Infrastructure Configuration Validation section to MODE_Orchestration.md - Auto-triggers WebFetch for infrastructure tools (Traefik, nginx, Docker, etc.) - Enforces MODE_DeepResearch activation for investigation - BLOCKS assumption-based configuration changes Testing: Verified WebFetch successfully retrieves Traefik official docs (port 80 default) This prevents production outages from infrastructure misconfiguration by ensuring all technical recommendations are backed by official documentation. * feat: Add PM Agent (Project Manager Agent) for seamless orchestration Introduces PM Agent as the default orchestration layer that coordinates all sub-agents and manages workflows automatically. Key Features: - Default orchestration: All user interactions handled by PM Agent - Auto-delegation: Intelligent sub-agent selection based on task analysis - Docker Gateway integration: Zero-token baseline with dynamic MCP loading - Self-improvement loop: Automatic documentation of patterns and mistakes - Optional override: Users can specify sub-agents explicitly if desired Architecture: - Agent spec: SuperClaude/Agents/pm-agent.md - Command: SuperClaude/Commands/pm.md - Updated docs: README.md (15→16 agents), agents.md (new Orchestration category) User Experience: - Default: PM Agent handles everything (seamless, no manual routing) - Optional: Explicit --agent flag for direct sub-agent access - Both modes available simultaneously (no user downside) Implementation Status: - ✅ Specification complete - ✅ Documentation complete - ⏳ Prototype implementation needed - ⏳ Docker Gateway integration needed - ⏳ Testing and validation needed Refs: kazukinakai/docker-mcp-gateway (IRIS MCP Gateway integration) * feat: Add Agent Orchestration rules for PM Agent default activation Implements PM Agent as the default orchestration layer in RULES.md. Key Changes: - New 'Agent Orchestration' section (CRITICAL priority) - PM Agent receives ALL user requests by default - Manual override with @agent-[name] bypasses PM Agent - Agent Selection Priority clearly defined: 1. Manual override → Direct routing 2. Default → PM Agent → Auto-delegation 3. Delegation based on keywords, file types, complexity, context User Experience: - Default: PM Agent handles everything (seamless) - Override: @agent-[name] for direct specialist access - Transparent: PM Agent reports delegation decisions This establishes PM Agent as the orchestration layer while respecting existing auto-activation patterns and manual overrides. Next Steps: - Local testing in agiletec project - Iteration based on actual behavior - Documentation updates as needed * refactor(pm-agent): redesign as self-improvement meta-layer Problem Resolution: PM Agent's initial design competed with existing auto-activation for task routing, creating confusion about orchestration responsibilities and adding unnecessary complexity. Design Change: Redefined PM Agent as a meta-layer agent that operates AFTER specialist agents complete tasks, focusing on: - Post-implementation documentation and pattern recording - Immediate mistake analysis with prevention checklists - Monthly documentation maintenance and noise reduction - Pattern extraction and knowledge synthesis Two-Layer Orchestration System: 1. Task Execution Layer: Existing auto-activation handles task routing (unchanged) 2. Self-Improvement Layer: PM Agent meta-layer handles documentation (new) Files Modified: - SuperClaude/Agents/pm-agent.md: Complete rewrite with meta-layer design - Category: orchestration → meta - Triggers: All user interactions → Post-implementation, mistakes, monthly - Behavioral Mindset: Continuous learning system - Self-Improvement Workflow: BEFORE/DURING/AFTER/MISTAKE RECOVERY/MAINTENANCE - SuperClaude/Core/RULES.md: Agent Orchestration section updated - Split into Task Execution Layer + Self-Improvement Layer - Added orchestration flow diagram - Clarified PM Agent activates AFTER task completion - README.md: Updated PM Agent description - "orchestrates all interactions" → "ensures continuous learning" - Docs/User-Guide/agents.md: PM Agent section rewritten - Section: Orchestration Agent → Meta-Layer Agent - Expertise: Project orchestration → Self-improvement workflow executor - Examples: Task coordination → Post-implementation documentation - PR_DOCUMENTATION.md: Comprehensive PR documentation added - Summary, motivation, changes, testing, breaking changes - Two-layer orchestration system diagram - Verification checklist Integration Validated: Tested with agiletec project's self-improvement-workflow.md: ✅ PM Agent aligns with existing BEFORE/DURING/AFTER/MISTAKE RECOVERY phases ✅ Complements (not competes with) existing workflow ✅ agiletec workflow defines WHAT, PM Agent defines WHO executes it Breaking Changes: None - Existing auto-activation continues unchanged - Specialist agents unaffected - User workflows remain the same - New capability: Automatic documentation and knowledge maintenance Value Proposition: Transforms SuperClaude into a continuously learning system that accumulates knowledge, prevents recurring mistakes, and maintains fresh documentation without manual intervention. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * docs: add Claude Code conversation history management research Research covering .jsonl file structure, performance impact, and retention policies. Content: - Claude Code .jsonl file format and message types - Performance issues from GitHub (memory leaks, conversation compaction) - Retention policies (consumer vs enterprise) - Rotation recommendations based on actual data - File history snapshot tracking mechanics Source: Moved from agiletec project (research applicable to all Claude Code projects) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat: add Development documentation structure Phase 1: Documentation Structure complete - Add Docs/Development/ directory for development documentation - Add ARCHITECTURE.md - System architecture with PM Agent meta-layer - Add ROADMAP.md - 5-phase development plan with checkboxes - Add TASKS.md - Daily task tracking with progress indicators - Add PROJECT_STATUS.md - Current status dashboard and metrics - Add pm-agent-integration.md - Implementation guide for PM Agent mode This establishes comprehensive documentation foundation for: - System architecture understanding - Development planning and tracking - Implementation guidance - Progress visibility Related: #pm-agent-mode #documentation #phase-1 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat: PM Agent session lifecycle and PDCA implementation Phase 2: PM Agent Mode Integration (Design Phase) Commands/pm.md updates: - Add "Always-Active Foundation Layer" concept - Add Session Lifecycle (Session Start/During Work/Session End) - Add PDCA Cycle (Plan/Do/Check/Act) automation - Add Serena MCP Memory Integration (list/read/write_memory) - Document auto-activation triggers Agents/pm-agent.md updates: - Add Session Start Protocol (MANDATORY auto-activation) - Add During Work PDCA Cycle with example workflows - Add Session End Protocol with state preservation - Add PDCA Self-Evaluation Pattern - Add Documentation Strategy (temp → patterns/mistakes) - Add Memory Operations Reference Key Features: - Session start auto-activation for context restoration - 30-minute checkpoint saves during work - Self-evaluation with think_about_* operations - Systematic documentation lifecycle - Knowledge evolution to CLAUDE.md Implementation Status: - ✅ Design complete (Commands/pm.md, Agents/pm-agent.md) - ⏳ Implementation pending (Core components) - ⏳ Serena MCP integration pending Salvaged from mistaken development in ~/.claude directory Related: #pm-agent-mode #session-lifecycle #pdca-cycle #phase-2 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: disable Serena MCP auto-browser launch Disable web dashboard and GUI log window auto-launch in Serena MCP server to prevent intrusive browser popups on startup. Users can still manually access the dashboard at http://localhost:24282/dashboard/ if needed. Changes: - Add CLI flags to Serena run command: - --enable-web-dashboard false - --enable-gui-log-window false - Ensures Git-tracked configuration (no reliance on ~/.serena/serena_config.yml) - Aligns with AIRIS MCP Gateway integration approach 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * refactor: rename directories to lowercase for PEP8 compliance - Rename superclaude/Agents -> superclaude/agents - Rename superclaude/Commands -> superclaude/commands - Rename superclaude/Core -> superclaude/core - Rename superclaude/Examples -> superclaude/examples - Rename superclaude/MCP -> superclaude/mcp - Rename superclaude/Modes -> superclaude/modes This change follows Python PEP8 naming conventions for package directories. * style: fix PEP8 violations and update package name to lowercase Changes: - Format all Python files with black (43 files reformatted) - Update package name from 'SuperClaude' to 'superclaude' in pyproject.toml - Fix import statements to use lowercase package name - Add missing imports (timedelta, __version__) - Remove old SuperClaude.egg-info directory PEP8 violations reduced from 2672 to 701 (mostly E501 line length due to black's 88 char vs flake8's 79 char limit). * docs: add PM Agent development documentation Add comprehensive PM Agent development documentation: - PM Agent ideal workflow (7-phase autonomous cycle) - Project structure understanding (Git vs installed environment) - Installation flow understanding (CommandsComponent behavior) - Task management system (current-tasks.md) Purpose: Eliminate repeated explanations and enable autonomous PDCA cycles 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat(pm-agent): add self-correcting execution and warning investigation culture ## Changes ### superclaude/commands/pm.md - Add "Self-Correcting Execution" section with root cause analysis protocol - Add "Warning/Error Investigation Culture" section enforcing zero-tolerance for dismissal - Define error detection protocol: STOP → Investigate → Hypothesis → Different Solution → Execute - Document anti-patterns (retry without understanding) and correct patterns (research-first) ### docs/Development/hypothesis-pm-autonomous-enhancement-2025-10-14.md - Add PDCA workflow hypothesis document for PM Agent autonomous enhancement ## Rationale PM Agent must never retry failed operations without understanding root causes. All warnings and errors require investigation via context7/WebFetch/documentation to ensure production-quality code and prevent technical debt accumulation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat(installer): add airis-mcp-gateway MCP server option ## Changes - Add airis-mcp-gateway to MCP server options in installer - Configuration: GitHub-based installation via uvx - Repository: https://github.com/oraios/airis-mcp-gateway - Purpose: Dynamic MCP Gateway for zero-token baseline and on-demand tool loading ## Implementation Added to setup/components/mcp.py self.mcp_servers dictionary with: - install_method: github - install_command: uvx test installation - run_command: uvx runtime execution - required: False (optional server) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: kazuki <kazuki@kazukinoMacBook-Air.local> Co-authored-by: Claude <noreply@anthropic.com>
523 lines
15 KiB
Markdown
523 lines
15 KiB
Markdown
<div align="center">
|
|
|
|
# 🚀 SuperClaude Framework
|
|
|
|
### **Transform Claude Code into a Structured Development Platform**
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/hesreallyhim/awesome-claude-code/">
|
|
<img src="https://awesome.re/mentioned-badge-flat.svg" alt="Mentioned in Awesome Claude Code">
|
|
</a>
|
|
<a href="https://github.com/SuperClaude-Org/SuperGemini_Framework" target="_blank">
|
|
<img src="https://img.shields.io/badge/Try-SuperGemini_Framework-blue" alt="Try SuperGemini Framework"/>
|
|
</a>
|
|
<a href="https://github.com/SuperClaude-Org/SuperQwen_Framework" target="_blank">
|
|
<img src="https://img.shields.io/badge/Try-SuperQwen_Framework-orange" alt="Try SuperQwen Framework"/>
|
|
</a>
|
|
<img src="https://img.shields.io/badge/version-4.2.0-blue" alt="Version">
|
|
<img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License">
|
|
<img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome">
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://superclaude.netlify.app/">
|
|
<img src="https://img.shields.io/badge/🌐_Visit_Website-blue" alt="Website">
|
|
</a>
|
|
<a href="https://pypi.org/project/superclaude/">
|
|
<img src="https://img.shields.io/pypi/v/SuperClaude.svg?" alt="PyPI">
|
|
</a>
|
|
<a href="https://pepy.tech/projects/superclaude">
|
|
<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">
|
|
</a>
|
|
<a href="https://www.npmjs.com/package/@bifrost_inc/superclaude">
|
|
<img src="https://img.shields.io/npm/v/@bifrost_inc/superclaude.svg" alt="npm">
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="README.md">
|
|
<img src="https://img.shields.io/badge/🇺🇸_English-blue" alt="English">
|
|
</a>
|
|
<a href="README-zh.md">
|
|
<img src="https://img.shields.io/badge/🇨🇳_中文-red" alt="中文">
|
|
</a>
|
|
<a href="README-ja.md">
|
|
<img src="https://img.shields.io/badge/🇯🇵_日本語-green" alt="日本語">
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="#-quick-installation">Quick Start</a> •
|
|
<a href="#-support-the-project">Support</a> •
|
|
<a href="#-whats-new-in-v4">Features</a> •
|
|
<a href="#-documentation">Docs</a> •
|
|
<a href="#-contributing">Contributing</a>
|
|
</p>
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
## 📊 **Framework Statistics**
|
|
|
|
| **Commands** | **Agents** | **Modes** | **MCP Servers** |
|
|
|:------------:|:----------:|:---------:|:---------------:|
|
|
| **26** | **16** | **7** | **8** |
|
|
| Slash Commands | Specialized AI | Behavioral | Integrations |
|
|
|
|
Use the new `/sc:help` command to see a full list of all available commands.
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
## 🎯 **Overview**
|
|
|
|
SuperClaude 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.
|
|
|
|
|
|
## Disclaimer
|
|
|
|
This project is not affiliated with or endorsed by Anthropic.
|
|
Claude Code is a product built and maintained by [Anthropic](https://www.anthropic.com/).
|
|
|
|
## ⚡ **Quick Installation**
|
|
|
|
### **Choose Your Installation Method**
|
|
|
|
| Method | Command | Best For |
|
|
|:------:|---------|----------|
|
|
| **🐍 pipx** | `pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install` | **✅ Recommended** - Linux/macOS |
|
|
| **📦 pip** | `pip install SuperClaude && pip upgrade SuperClaude && SuperClaude install` | Traditional Python environments |
|
|
| **🌐 npm** | `npm install -g @bifrost_inc/superclaude && superclaude install` | Cross-platform, Node.js users |
|
|
|
|
</div>
|
|
|
|
<details>
|
|
<summary><b>⚠️ IMPORTANT: Upgrading from SuperClaude V3</b></summary>
|
|
|
|
**If you have SuperClaude V3 installed, you SHOULD uninstall it before installing V4:**
|
|
|
|
```bash
|
|
# Uninstall V3 first
|
|
Remove all related files and directories :
|
|
*.md *.json and commands/
|
|
|
|
# Then install V4
|
|
pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install
|
|
```
|
|
|
|
**✅ What gets preserved during upgrade:**
|
|
- ✓ Your custom slash commands (outside `commands/sc/`)
|
|
- ✓ Your custom content in `CLAUDE.md`
|
|
- ✓ Claude Code's `.claude.json`, `.credentials.json`, `settings.json` and `settings.local.json`
|
|
- ✓ Any custom agents and files you've added
|
|
|
|
**⚠️ Note:** Other SuperClaude-related `.json` files from V3 may cause conflicts and should be removed.
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary><b>💡 Troubleshooting PEP 668 Errors</b></summary>
|
|
|
|
```bash
|
|
# Option 1: Use pipx (Recommended)
|
|
pipx install SuperClaude
|
|
|
|
# Option 2: User installation
|
|
pip install --user SuperClaude
|
|
|
|
# Option 3: Force installation (use with caution)
|
|
pip install --break-system-packages SuperClaude
|
|
```
|
|
</details>
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
## 💖 **Support the Project**
|
|
|
|
> Hey, let's be real - maintaining SuperClaude takes time and resources.
|
|
>
|
|
> *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.*
|
|
> *If you're finding value in SuperClaude for your daily work, consider supporting the project.*
|
|
> *Even a few dollars helps cover the basics and keeps development active.*
|
|
>
|
|
> Every contributor matters, whether through code, feedback, or support. Thanks for being part of this community! 🙏
|
|
|
|
<table>
|
|
<tr>
|
|
<td align="center" width="33%">
|
|
|
|
### ☕ **Ko-fi**
|
|
[](https://ko-fi.com/superclaude)
|
|
|
|
*One-time contributions*
|
|
|
|
</td>
|
|
<td align="center" width="33%">
|
|
|
|
### 🎯 **Patreon**
|
|
[](https://patreon.com/superclaude)
|
|
|
|
*Monthly support*
|
|
|
|
</td>
|
|
<td align="center" width="33%">
|
|
|
|
### 💜 **GitHub**
|
|
[](https://github.com/sponsors/SuperClaude-Org)
|
|
|
|
*Flexible tiers*
|
|
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
### **Your Support Enables:**
|
|
|
|
| Item | Cost/Impact |
|
|
|------|-------------|
|
|
| 🔬 **Claude Max Testing** | $100/month for validation & testing |
|
|
| ⚡ **Feature Development** | New capabilities & improvements |
|
|
| 📚 **Documentation** | Comprehensive guides & examples |
|
|
| 🤝 **Community Support** | Quick issue responses & help |
|
|
| 🔧 **MCP Integration** | Testing new server connections |
|
|
| 🌐 **Infrastructure** | Hosting & deployment costs |
|
|
|
|
> **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! 🙏
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
## 🎉 **What's New in V4**
|
|
|
|
> *Version 4 brings significant improvements based on community feedback and real-world usage patterns.*
|
|
|
|
<table>
|
|
<tr>
|
|
<td width="50%">
|
|
|
|
### 🤖 **Smarter Agent System**
|
|
**16 specialized agents** with domain expertise:
|
|
- PM Agent ensures continuous learning through systematic documentation
|
|
- Deep Research agent for autonomous web research
|
|
- Security engineer catches real vulnerabilities
|
|
- Frontend architect understands UI patterns
|
|
- Automatic coordination based on context
|
|
- Domain-specific expertise on demand
|
|
|
|
</td>
|
|
<td width="50%">
|
|
|
|
### 📝 **Improved Namespace**
|
|
**`/sc:` prefix** for all commands:
|
|
- No conflicts with custom commands
|
|
- 25 commands covering full lifecycle
|
|
- From brainstorming to deployment
|
|
- Clean, organized command structure
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%">
|
|
|
|
### 🔧 **MCP Server Integration**
|
|
**8 powerful servers** working together:
|
|
- **Context7** → Up-to-date documentation
|
|
- **Sequential** → Complex analysis
|
|
- **Magic** → UI component generation
|
|
- **Playwright** → Browser testing
|
|
- **Morphllm** → Bulk transformations
|
|
- **Serena** → Session persistence
|
|
- **Tavily** → Web search for deep research
|
|
- **Chrome DevTools** → Performance analysis
|
|
|
|
</td>
|
|
<td width="50%">
|
|
|
|
### 🎯 **Behavioral Modes**
|
|
**7 adaptive modes** for different contexts:
|
|
- **Brainstorming** → Asks right questions
|
|
- **Business Panel** → Multi-expert strategic analysis
|
|
- **Deep Research** → Autonomous web research
|
|
- **Orchestration** → Efficient tool coordination
|
|
- **Token-Efficiency** → 30-50% context savings
|
|
- **Task Management** → Systematic organization
|
|
- **Introspection** → Meta-cognitive analysis
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%">
|
|
|
|
### ⚡ **Optimized Performance**
|
|
**Smaller framework, bigger projects:**
|
|
- Reduced framework footprint
|
|
- More context for your code
|
|
- Longer conversations possible
|
|
- Complex operations enabled
|
|
|
|
</td>
|
|
<td width="50%">
|
|
|
|
### 📚 **Documentation Overhaul**
|
|
**Complete rewrite** for developers:
|
|
- Real examples & use cases
|
|
- Common pitfalls documented
|
|
- Practical workflows included
|
|
- Better navigation structure
|
|
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
## 🔬 **Deep Research Capabilities**
|
|
|
|
### **Autonomous Web Research Aligned with DR Agent Architecture**
|
|
|
|
SuperClaude v4.2 introduces comprehensive Deep Research capabilities, enabling autonomous, adaptive, and intelligent web research.
|
|
|
|
<table>
|
|
<tr>
|
|
<td width="50%">
|
|
|
|
### 🎯 **Adaptive Planning**
|
|
**Three intelligent strategies:**
|
|
- **Planning-Only**: Direct execution for clear queries
|
|
- **Intent-Planning**: Clarification for ambiguous requests
|
|
- **Unified**: Collaborative plan refinement (default)
|
|
|
|
</td>
|
|
<td width="50%">
|
|
|
|
### 🔄 **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)
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%">
|
|
|
|
### 📊 **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
|
|
|
|
</td>
|
|
<td width="50%">
|
|
|
|
### 🧠 **Case-Based Learning**
|
|
**Cross-session intelligence:**
|
|
- Pattern recognition and reuse
|
|
- Strategy optimization over time
|
|
- Successful query formulations saved
|
|
- Performance improvement tracking
|
|
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
### **Research Command Usage**
|
|
|
|
```bash
|
|
# Basic research with automatic depth
|
|
/sc:research "latest AI developments 2024"
|
|
|
|
# Controlled research depth
|
|
/sc:research "quantum computing breakthroughs" --depth exhaustive
|
|
|
|
# Specific strategy selection
|
|
/sc:research "market analysis" --strategy planning-only
|
|
|
|
# Domain-filtered research
|
|
/sc:research "React patterns" --domains "reactjs.org,github.com"
|
|
```
|
|
|
|
### **Research Depth Levels**
|
|
|
|
| Depth | Sources | Hops | Time | Best For |
|
|
|:-----:|:-------:|:----:|:----:|----------|
|
|
| **Quick** | 5-10 | 1 | ~2min | Quick facts, simple queries |
|
|
| **Standard** | 10-20 | 3 | ~5min | General research (default) |
|
|
| **Deep** | 20-40 | 4 | ~8min | Comprehensive analysis |
|
|
| **Exhaustive** | 40+ | 5 | ~10min | Academic-level research |
|
|
|
|
### **Integrated Tool Orchestration**
|
|
|
|
The Deep Research system intelligently coordinates multiple tools:
|
|
- **Tavily MCP**: Primary web search and discovery
|
|
- **Playwright MCP**: Complex content extraction
|
|
- **Sequential MCP**: Multi-step reasoning and synthesis
|
|
- **Serena MCP**: Memory and learning persistence
|
|
- **Context7 MCP**: Technical documentation lookup
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
## 📚 **Documentation**
|
|
|
|
### **Complete Guide to SuperClaude**
|
|
|
|
<table>
|
|
<tr>
|
|
<th align="center">🚀 Getting Started</th>
|
|
<th align="center">📖 User Guides</th>
|
|
<th align="center">🛠️ Developer Resources</th>
|
|
<th align="center">📋 Reference</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">
|
|
|
|
- 📝 [**Quick Start Guide**](docs/Getting-Started/quick-start.md)
|
|
*Get up and running fast*
|
|
|
|
- 💾 [**Installation Guide**](docs/Getting-Started/installation.md)
|
|
*Detailed setup instructions*
|
|
|
|
</td>
|
|
<td valign="top">
|
|
|
|
- 🎯 [**Commands Reference**](docs/User-Guide/commands.md)
|
|
*All 25 slash commands*
|
|
|
|
- 🤖 [**Agents Guide**](docs/User-Guide/agents.md)
|
|
*15 specialized agents*
|
|
|
|
- 🎨 [**Behavioral Modes**](docs/User-Guide/modes.md)
|
|
*7 adaptive modes*
|
|
|
|
- 🚩 [**Flags Guide**](docs/User-Guide/flags.md)
|
|
*Control behaviors*
|
|
|
|
- 🔧 [**MCP Servers**](docs/User-Guide/mcp-servers.md)
|
|
*7 server integrations*
|
|
|
|
- 💼 [**Session Management**](docs/User-Guide/session-management.md)
|
|
*Save & restore state*
|
|
|
|
</td>
|
|
<td valign="top">
|
|
|
|
- 🏗️ [**Technical Architecture**](docs/Developer-Guide/technical-architecture.md)
|
|
*System design details*
|
|
|
|
- 💻 [**Contributing Code**](docs/Developer-Guide/contributing-code.md)
|
|
*Development workflow*
|
|
|
|
- 🧪 [**Testing & Debugging**](docs/Developer-Guide/testing-debugging.md)
|
|
*Quality assurance*
|
|
|
|
</td>
|
|
<td valign="top">
|
|
- 📓 [**Examples Cookbook**](docs/Reference/examples-cookbook.md)
|
|
*Real-world recipes*
|
|
|
|
- 🔍 [**Troubleshooting**](docs/Reference/troubleshooting.md)
|
|
*Common issues & fixes*
|
|
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
## 🤝 **Contributing**
|
|
|
|
### **Join the SuperClaude Community**
|
|
|
|
We welcome contributions of all kinds! Here's how you can help:
|
|
|
|
| Priority | Area | Description |
|
|
|:--------:|------|-------------|
|
|
| 📝 **High** | Documentation | Improve guides, add examples, fix typos |
|
|
| 🔧 **High** | MCP Integration | Add server configs, test integrations |
|
|
| 🎯 **Medium** | Workflows | Create command patterns & recipes |
|
|
| 🧪 **Medium** | Testing | Add tests, validate features |
|
|
| 🌐 **Low** | i18n | Translate docs to other languages |
|
|
|
|
<p align="center">
|
|
<a href="CONTRIBUTING.md">
|
|
<img src="https://img.shields.io/badge/📖_Read-Contributing_Guide-blue" alt="Contributing Guide">
|
|
</a>
|
|
<a href="https://github.com/SuperClaude-Org/SuperClaude_Framework/graphs/contributors">
|
|
<img src="https://img.shields.io/badge/👥_View-All_Contributors-green" alt="Contributors">
|
|
</a>
|
|
</p>
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
## ⚖️ **License**
|
|
|
|
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
|
|
|
|
<p align="center">
|
|
<img src="https://img.shields.io/badge/License-MIT-yellow.svg?" alt="MIT License">
|
|
</p>
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
## ⭐ **Star History**
|
|
|
|
<a href="https://www.star-history.com/#SuperClaude-Org/SuperClaude_Framework&Timeline">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline&theme=dark" />
|
|
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline" />
|
|
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline" />
|
|
</picture>
|
|
</a>
|
|
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
### **🚀 Built with passion by the SuperClaude community**
|
|
|
|
<p align="center">
|
|
<sub>Made with ❤️ for developers who push boundaries</sub>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="#-superclaude-framework">Back to Top ↑</a>
|
|
</p>
|
|
|
|
</div>
|