🤖 SuperDroid Framework

Transform Factory Droid CLI into a Structured Development Platform

Quick Start • Features • Docs • Contributing

---

📊 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

🚀 Getting Started	📖 User Guides	📋 Reference
📝 Quick Start 💾 Installation	🎯 Commands 🤖 Droids 🔧 MCP Servers	📓 Commands List

---

📋 All 30 Commands

Click to expand full command list

🧠 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

_{Made with ❤️ for developers who push boundaries}

Back to Top ↑