🤖 SuperDroid Framework

Transform Factory Droid CLI into a Structured Development Platform

📊 Framework Statistics

| Commands | Droids | Modes | MCP Servers | |:------------:|:----------:|:---------:|:---------------:| | 30 | 20 | 7 | 8 | | Slash Commands | Specialized AI | Behavioral | Integrations |

30 slash commands covering the complete development lifecycle from brainstorming to deployment.

🎯 Overview

SuperDroid adapts SuperClaude Framework's command/droid/mode architecture for Factory Droid CLI. It provides 30 slash commands, 20 specialized droids, and 7 behavioral modes for structured development workflows.

Note: This is a prompt-level adaptation focusing on commands, droids, and modes. SuperClaude's pytest plugin, PM agent modules, and MCP code integration are not included (yet).

Disclaimer

This project is not affiliated with or endorsed by Factory AI. Factory Droid CLI is a product built and maintained by Factory AI.

⚡ Quick Installation

Option 1: pipx (Recommended for Python users)

# Install from PyPI
pipx install superdroid

# Install commands, droids, and modes
superdroid install

# Verify installation
superdroid doctor

Option 2: npm (Recommended for Node.js users)

# Install globally from npm
npm install -g @frexxis/superdroid

# Install commands, droids, and modes
superdroid install

# Verify installation
superdroid doctor

Option 3: Install Script

# Clone and install
git clone https://github.com/Frexxis/SuperDroid.git
cd SuperDroid
./install.sh

Option 4: Manual Installation

# Clone the repository
git clone https://github.com/Frexxis/SuperDroid.git
cd SuperDroid

# Copy commands
mkdir -p ~/.factory/commands/sd
cp -r .factory/commands/* ~/.factory/commands/sd/

# Copy droids
cp -r .factory/droids/* ~/.factory/droids/

# Copy modes
cp -r .factory/modes/* ~/.factory/modes/

After installation:

1. Restart Droid CLI to load new commands
2. Enable Custom Droids: /settings → Custom Droids → Enable
3. Verify: Type /sd-help to see all commands

Available Commands After Installation

• /sd-research - Deep web research (enhanced with Tavily MCP)
• /sd-brainstorm - Structured brainstorming
• /sd-implement - Code implementation
• /sd-test - Testing workflows
• /sd-pm - Project management
• /sd - Show all 30 available commands

Enhanced Performance (Optional MCPs)

For 2-3x faster execution and 30-50% fewer tokens, configure MCP servers in ~/.factory/mcp.json:

# Recommended MCP servers:
# - Tavily: Web search for Deep Research
# - Context7: Official documentation lookup
# - Sequential: Token-efficient reasoning
# - Playwright: Browser automation

Performance Comparison:

• Without MCPs: Fully functional, standard performance ✅
• With MCPs: 2-3x faster, 30-50% fewer tokens ⚡

🎉 Features

🤖 20 Specialized Droids

Domain expertise on demand:

• PM Agent for project orchestration
• Deep Research agent for web research
• Security engineer for vulnerability checks
• Frontend/Backend architects
• Quality & Performance engineers
• And 15 more specialists

⚡ Optimized Performance

Efficient framework design:

• Reduced token footprint
• More context for your code
• Longer conversations possible
• Complex operations enabled

🔧 MCP Server Integration

8 powerful servers supported:

• Tavily → Primary web search
• Context7 → Documentation lookup
• Sequential → Multi-step reasoning
• Playwright → Browser automation
• Serena → Session persistence
• And more...

🎯 7 Behavioral Modes

Adaptive modes for different contexts:

• Brainstorming → Discovery questions
• Business Panel → Multi-expert analysis
• Deep Research → Autonomous research
• Orchestration → Tool coordination
• Token-Efficiency → Context savings
• Task Management → Organization
• Introspection → Meta-analysis

🔬 Deep Research Capabilities

Autonomous Web Research

SuperDroid includes comprehensive Deep Research capabilities:

🎯 Adaptive Planning

• Planning-Only: Direct execution
• Intent-Planning: Clarification first
• Unified: Collaborative refinement

🔄 Multi-Hop Reasoning

• Entity expansion
• Concept deepening
• Temporal progression
• Causal chains

Research Command Usage

# Basic research
/sd-research "latest AI developments 2024"

# Deep research
/sd-research "quantum computing breakthroughs" --depth exhaustive

# Domain-filtered (with Tavily MCP)
/sd-research "React patterns" --domains reactjs.org,github.com

Research Depth Levels

| Depth | Sources | Time | Best For | |:-----:|:-------:|:----:|----------| | Quick | 5-10 | ~2min | Quick facts | | Standard | 10-20 | ~5min | General research | | Deep | 20-40 | ~8min | Comprehensive | | Exhaustive | 40+ | ~10min | Academic-level |

📚 Documentation

Complete Guide to SuperDroid

• 📝 Quick Start
• 💾 Installation

• 🎯 Commands
• 🤖 Droids
• 🔧 MCP Servers

• 📓 Commands List

📋 All 30 Commands

🧠 Planning & Design (4)

• /sd-brainstorm - Structured brainstorming
• /sd-design - System architecture
• /sd-estimate - Time/effort estimation
• /sd-spec-panel - Specification analysis

💻 Development (5)

• /sd-implement - Code implementation
• /sd-build - Build workflows
• /sd-improve - Code improvements
• /sd-cleanup - Refactoring
• /sd-explain - Code explanation

🧪 Testing & Quality (4)

• /sd-test - Test generation
• /sd-analyze - Code analysis
• /sd-troubleshoot - Debugging
• /sd-reflect - Retrospectives

📚 Documentation (2)

• /sd-document - Doc generation
• /sd-help - Command help

🔧 Version Control (1)

• /sd-git - Git operations

📊 Project Management (3)

• /sd-pm - Project management
• /sd-task - Task tracking
• /sd-workflow - Workflow automation

🔍 Research & Analysis (2)

• /sd-research - Deep web research
• /sd-business-panel - Business analysis

🎯 Utilities (9)

• /sd-agent - Invoke droids
• /index-repo - Repository indexing
• /sd-index - Quick indexing
• /sd-recommend - Command recommendations
• /sd-select-tool - Tool selection
• /sd-spawn - Parallel tasks
• /sd-load - Load sessions
• /sd-save - Save sessions
• /sd - Show all commands

📖 View Detailed Command Reference →

🤝 Contributing

Join the SuperDroid Community

We welcome contributions of all kinds!

| Priority | Area | Description | |:--------:|------|-------------| | 📝 High | Commands | Add new slash commands | | 🤖 High | Droids | Create specialized droids | | 📚 Medium | Documentation | Improve guides & examples | | 🧪 Medium | Testing | Test and validate features |

⚖️ License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Credits

• Inspired by SuperClaude Framework
• Built for Factory Droid CLI

🤖 Built with passion for the Factory Droid community