SuperClaude-Org · Utakata · Oct 12, 2025 · Oct 13, 2025 · Oct 13, 2025 · Oct 14, 2025
@@ -0,0 +1,19 @@
+{
+  "name": "superclaude-marketplace",
+  "version": "1.0.0",
+  "description": "Official SuperClaude Framework plugin marketplace",
+  "repository": "https://github.com/SuperClaude-Org/superclaude-plugin-marketplace",
+  "plugins": {
+    "superclaude-framework": {
+      "source": "github",
+      "repo": "SuperClaude-Org/SuperClaude_Framework",
+      "path": ".",
+      "version": "5.0.0",
+      "installCommand": "/plugin install superclaude-framework@superclaude-marketplace"
+    }
+  },
+  "categories": {
+    "core": ["superclaude-framework"],
+    "extensions": []
+  }
+}
@@ -0,0 +1,26 @@
+{
+  "name": "superclaude",
+  "version": "5.0.0",
+  "description": "Meta-programming configuration framework that transforms Claude Code into a structured development platform with 25 commands, 15 specialized agents, and 8 MCP integrations",
+  "author": {
+    "name": "SuperClaude-Org",
+    "email": "[email protected]",
+    "url": "https://github.com/SuperClaude-Org"
+  },
+  "homepage": "https://superclaude.org/",
+  "repository": "https://github.com/SuperClaude-Org/SuperClaude_Framework",
+  "license": "MIT",
+  "keywords": [
+    "claude-code",
+    "development-framework",
+    "ai-coding",
+    "mcp-integration",
+    "workflow-automation",
+    "code-analysis",
+    "deep-research"
+  ],
+  "commands": "./commands/",
+  "agents": "./agents/",
+  "hooks": "./hooks/hooks.json",
+  "mcpServers": "./.mcp.json"
+}
@@ -0,0 +1,58 @@
+{
+  "mcpServers": {
+    "serena": {
+      "source": "marketplace:devtools/serena"
+    },
+    "context7": {
+      "source": "marketplace:devtools/context7"
+    },
+    "sequential-thinking": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-sequential-thinking"
+      ]
+    },
+    "magic": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@21st/mcp"
+      ]
+    },
+    "playwright": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "playwright-mcp-server"
+      ]
+    },
+    "morphllm-fast-apply": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "morphllm-fast-apply-mcp-server"
+      ]
+    },
+    "tavily": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "tavily-mcp-server"
+      ],
+      "env": {
+        "TAVILY_API_KEY": "${TAVILY_API_KEY}"
+      }
+    },
+    "firecrawl": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "firecrawl-mcp-server"
+      ],
+      "env": {
+        "FIRECRAWL_API_KEY": "${FIRECRAWL_API_KEY}"
+      }
+    }
+  }
+}
@@ -7,6 +7,55 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [4.2.0] - 2025-09-18
+### Added
+- **Deep Research System** - Complete implementation of autonomous web research capabilities
+  - New `/sc:research` command for intelligent web research with DR Agent architecture
+  - `deep-research-agent` - 15th specialized agent for research orchestration
+  - `MODE_DeepResearch` - 7th behavioral mode for research workflows
+  - Tavily MCP integration (7th MCP server) for real-time web search
+  - Research configuration system (`RESEARCH_CONFIG.md`)
+  - Comprehensive workflow examples (`deep_research_workflows.md`)
+  - Three planning strategies: Planning-Only, Intent-to-Planning, Unified Intent-Planning
+  - Multi-hop reasoning with genealogy tracking for complex queries
+  - Case-based reasoning for learning from past research patterns
+
+### Changed
+- Updated agent count from 14 to 15 (added deep-research-agent)
+- Updated mode count from 6 to 7 (added MODE_DeepResearch)
+- Updated MCP server count from 6 to 7 (added Tavily)
+- Updated command count from 24 to 25 (added /sc:research)
+- Enhanced MCP component with remote server support for Tavily
+- Added `_install_remote_mcp_server` method to handle remote MCP configurations
+
+### Technical
+- Added Tavily to `server_docs_map` in `setup/components/mcp_docs.py`
+- Implemented remote MCP server handler in `setup/components/mcp.py`
+- Added `check_research_prerequisites()` function in `setup/utils/environment.py`
+- Created verification script `scripts/verify_research_integration.sh`
+
+### Requirements
+- `TAVILY_API_KEY` environment variable for web search functionality
+- Node.js and npm for Tavily MCP execution
+
+## [4.1.5] - 2025-09-26
+### Added
+- Comprehensive flag documentation integrated into `/sc:help` command
+- All 25 SuperClaude framework flags now discoverable from help system
+- Practical usage examples and flag priority rules
+
+### Fixed
+- MCP incremental installation and auto-detection system
+- Auto-detection of existing MCP servers from .claude.json and claude_desktop_config.json
+- Smart server merging (existing + selected + previously installed)
+- Documentation cleanup: removed non-existent commands (sc:fix, sc:simple-pix, sc:update, sc:develop, sc:modernize, sc:simple-fix)
+- CLI logic to allow mcp_docs installation without server selection
+### Changed
+- MCP component now supports true incremental installation
+- mcp_docs component auto-detects and installs documentation for all detected servers
+- Improved error handling and graceful fallback for corrupted config files
+- Enhanced user experience with single-source reference for all SuperClaude capabilities
+
 ## [4.1.0] - 2025-09-13
 ### Added
 - Display author names and emails in the installer UI header.
@@ -26,7 +75,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Added the `claude` CLI as a formal prerequisite for MCP server management, which was previously undocumented.
 
 ### Changed
-- Version bump to 4.1.0
 
 ### Technical
 - Prepared package for PyPI distribution

@@ -518,7 +518,7 @@ This code of conduct draws inspiration from several established community standa
 
 **Last Updated**: December 2024 (SuperClaude Framework v4.0)
 **Next Review**: June 2025 (Semi-annual review cycle)
-**Version**: 4.1.0 (Updated for v4 community structure and governance)
+**Version**: 4.1.5 (Updated for v4 community structure and governance)
 
 **Review Schedule:**
 - **Semi-Annual Reviews**: Policy effectiveness assessment and community feedback integration

@@ -27,7 +27,7 @@ SuperClaude Framework transforms Claude Code into a structured development platf
 **Good Bug Report Example:**
 ```
 **Environment:**
-- SuperClaude: 4.1.0
+- SuperClaude: 4.1.5
 - OS: Ubuntu 22.04
 - Claude Code: 1.5.2
 - Python: 3.9.7

@@ -34,14 +34,19 @@ This guide documents how SuperClaude's Context-Oriented Configuration Framework
 ├── MCP_Playwright.md               # Playwright MCP integration
 ├── MCP_Sequential.md               # Sequential MCP integration
 ├── MCP_Serena.md                   # Serena MCP integration
+├── MCP_Tavily.md                   # Tavily MCP integration
 ├── MCP_Zig.md                      # Zig MCP integration
 ├── MODE_Brainstorming.md           # Collaborative discovery mode
+├── MODE_Business_Panel.md          # Business expert panel mode
+├── MODE_DeepResearch.md            # Deep research mode
 ├── MODE_Introspection.md           # Transparent reasoning mode
 ├── MODE_Orchestration.md           # Tool coordination mode
 ├── MODE_Task_Management.md         # Task orchestration mode
 ├── MODE_Token_Efficiency.md        # Compressed communication mode
-├── agents/                         # Domain specialist contexts (14 total)
+├── agents/                         # Domain specialist contexts (19 total)
 │   ├── backend-architect.md        # Backend expertise
+│   ├── business-panel-experts.md   # Business strategy panel
+│   ├── deep-research-agent.md      # Deep research expertise
 │   ├── devops-architect.md         # DevOps expertise
 │   ├── frontend-architect.md       # Frontend expertise
 │   ├── learning-guide.md           # Educational expertise
@@ -53,27 +58,34 @@ This guide documents how SuperClaude's Context-Oriented Configuration Framework
 │   ├── root-cause-analyst.md       # Problem diagnosis expertise
 │   ├── security-engineer.md        # Security expertise
 │   ├── socratic-mentor.md          # Educational expertise
+│   ├── spec-panel-experts.md       # Specification review panel
 │   ├── system-architect.md         # System design expertise
-│   └── technical-writer.md         # Documentation expertise
+│   ├── technical-writer.md         # Documentation expertise
+│   ├── test-runner.md              # Test execution expertise
+│   └── wave-orchestrator.md        # Wave orchestration patterns
 └── commands/                       # Workflow pattern contexts
-    └── sc/                         # SuperClaude command namespace (21 total)
+    └── sc/                         # SuperClaude command namespace (25 total)
         ├── analyze.md              # Analysis patterns
         ├── brainstorm.md           # Discovery patterns
         ├── build.md                # Build patterns
+        ├── business-panel.md       # Business expert panel patterns
         ├── cleanup.md              # Cleanup patterns
         ├── design.md               # Design patterns
         ├── document.md             # Documentation patterns
         ├── estimate.md             # Estimation patterns
         ├── explain.md              # Explanation patterns
         ├── git.md                  # Git workflow patterns
+        ├── help.md                 # Help and command listing
         ├── implement.md            # Implementation patterns
         ├── improve.md              # Improvement patterns
         ├── index.md                # Index patterns
         ├── load.md                 # Context loading patterns
         ├── reflect.md              # Reflection patterns
+        ├── research.md             # Deep research patterns
         ├── save.md                 # Session persistence patterns
         ├── select-tool.md          # Tool selection patterns
         ├── spawn.md                # Multi-agent patterns
+        ├── spec-panel.md           # Specification review panel
         ├── task.md                 # Task management patterns
         ├── test.md                 # Testing patterns
         ├── troubleshoot.md         # Troubleshooting patterns
@@ -112,9 +124,12 @@ The main `CLAUDE.md` file uses an import system to load multiple context files:
 @MCP_Playwright.md         # Playwright MCP integration
 @MCP_Sequential.md         # Sequential MCP integration
 @MCP_Serena.md             # Serena MCP integration
+@MCP_Tavily.md             # Tavily MCP integration
 @MCP_Zig.md                # Zig MCP integration
 *CRITICAL*
 @MODE_Brainstorming.md     # Collaborative discovery mode
+@MODE_Business_Panel.md    # Business expert panel mode
+@MODE_DeepResearch.md      # Deep research mode
 @MODE_Introspection.md     # Transparent reasoning mode
 @MODE_Task_Management.md   # Task orchestration mode
 @MODE_Orchestration.md     # Tool coordination mode

@@ -5,7 +5,7 @@
 ### **Transform Claude Code with 21 Commands, 14 Agents & 6 MCP Servers**
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-4.1.0-blue?style=for-the-badge" alt="Version">
+  <img src="https://img.shields.io/badge/version-4.1.5-blue?style=for-the-badge" alt="Version">
   <img src="https://img.shields.io/badge/Python-3.8+-green?style=for-the-badge" alt="Python">
   <img src="https://img.shields.io/badge/Platform-Linux%20|%20macOS%20|%20Windows-orange?style=for-the-badge" alt="Platform">
 </p>
@@ -266,7 +266,7 @@ SuperClaude install --dry-run
 ```bash
 # Verify SuperClaude version
 python3 -m SuperClaude --version
-# Expected: SuperClaude 4.1.0
+# Expected: SuperClaude 4.1.5
 
 # List installed components
 SuperClaude install --list-components

@@ -6,7 +6,7 @@
 
 <p align="center">
   <img src="https://img.shields.io/badge/Framework-Context_Engineering-purple?style=for-the-badge" alt="Framework">
-  <img src="https://img.shields.io/badge/Version-4.1.0-blue?style=for-the-badge" alt="Version">
+  <img src="https://img.shields.io/badge/Version-4.1.5-blue?style=for-the-badge" alt="Version">
   <img src="https://img.shields.io/badge/Time_to_Start-5_Minutes-green?style=for-the-badge" alt="Quick Start">
 </p>
 
@@ -486,7 +486,7 @@ Create custom workflows
 </p>
 
 <p align="center">
-  <sub>SuperClaude v4.1.0 - Context Engineering for Claude Code</sub>
+  <sub>SuperClaude v4.1.5 - Context Engineering for Claude Code</sub>
 </p>
 
 </div>
@@ -0,0 +1,76 @@
+# SuperClaude v4 → v5 (Plugin) Migration Guide
+
+## Overview
+SuperClaude v5 adopts Anthropic's official plugin system for easier installation and updates.
+
+## Before You Begin
+- **Backup**: Your configurations will be preserved, but a backup is recommended
+- **Time**: Migration takes 5-10 minutes
+- **Compatibility**: v4 and v5 can coexist during the transition period
+
+## Migration Steps
+
+### Step 1: Check Your Current Installation
+```bash
+python3 migrate-to-plugin.py --check
+```
+
+### Step 2: Backup (Automatic)
+```bash
+python3 migrate-to-plugin.py --migrate
+```
+This automatically creates a backup at `~/.claude-v4-backup`
+
+### Step 3: Install Plugin
+In Claude Code:
+```
+/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
+/plugin install superclaude-framework
+```
+
+### Step 4: Verify Installation
+```
+/help
+```
+You should see all 25 SuperClaude commands listed.
+
+## Preserved Configurations
+These files are NOT modified during migration:
+- Custom `CLAUDE.md` additions
+- Personal `.claude/settings.json`
+- Project-specific configurations
+- MCP server API keys
+
+## Rollback (If Needed)
+```bash
+python3 migrate-to-plugin.py --rollback
+```
+
+## Troubleshooting
+
+### Issue: `/plugin install` fails
+- **Cause**: This can happen if the marketplace was not added correctly or if there's a network issue.
+- **Solution**:
+  1. Ensure you have a stable internet connection.
+  2. Verify that the marketplace was added correctly by running `/plugin marketplace list`.
+  3. Try removing and re-adding the marketplace:
+     ```
+     /plugin marketplace remove SuperClaude-Org/superclaude-plugin-marketplace
+     /plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
+     ```
+
+### Issue: Old commands are still showing up
+- **Cause**: The migration script may not have fully cleaned up the old files.
+- **Solution**:
+  1. Manually delete the old command files from `~/.claude/commands/sc/`.
+  2. Restart Claude Code.
+
+### Issue: MCP Servers are not connecting
+- **Cause**: API keys may not be correctly set as environment variables.
+- **Solution**:
+  1. Ensure that `TAVILY_API_KEY`, `FIRECRAWL_API_KEY`, etc., are set in your shell's startup file (e.g., `.bashrc`, `.zshrc`).
+  2. Restart your terminal and Claude Code to ensure the environment variables are loaded.
+
+## Support Period
+- v4.x: Supported until April 2025 (6-month support window)
+- v5.x: Current and actively developed
@@ -13,7 +13,7 @@ Test: /sc:brainstorm "test" should ask questions
 
 ### 2. Installation Verification
 ```bash
-python3 -m SuperClaude --version    # Should show 4.1.0
+python3 -m SuperClaude --version    # Should show 4.1.5
 
 # If not working:
 # For pipx users
@@ -71,7 +71,7 @@ pip3 install SuperClaude
 ```
 
 ## Verification Checklist
-- [ ] `python3 -m SuperClaude --version` returns 4.1.0
+- [ ] `python3 -m SuperClaude --version` returns 4.1.5
 - [ ] `/sc:brainstorm "test"` works in Claude Code
 - [ ] `SuperClaude install --list-components` shows components