Stats
Links
Categories
Virtuoso
Transform your Claude CLI session into an autonomous software house.
Virtuoso is a Claude Code Plugin that orchestrates a "swarm" of specialized AI agents to build software projects from idea to product launch. Each agent has a specific role, following strict protocols, phase gates, and memory management to ensure consistent, high-quality output.
The Swarm Architecture
Virtuoso employs 28 specialized agents organized into four layers, covering the complete software development lifecycle from market research to post-launch optimization:
Strategic Layer
| Agent | Role | Capabilities |
|---|---|---|
| virtuoso-master | The Orchestrator | Routes requests, manages workflows, coordinates agents, enforces phase gates |
| visionary | Product Strategist | Interviews users, creates PRD, defines tech stack |
| business-analyst | Market Researcher | Market research, competitive analysis, business model |
| user-researcher | User Researcher | User personas, user journeys, user stories |
| product-manager | Product Manager | Roadmap management, feature prioritization, success metrics |
| project-manager | Task Orchestrator | Breaks down work, plans sprints, assigns agents |
| marketing-strategist | Marketing Strategist | Marketing strategy, launch campaigns |
| content-writer | Content Writer | Blog posts, copywriting, marketing content |
| seo-specialist | SEO Specialist | SEO optimization, keyword research |
| growth-hacker | Growth Hacker | Growth experiments, conversion optimization |
Architectural Layer
| Agent | Role | Capabilities |
|---|---|---|
| architect | System Designer | Creates architecture docs, API specs, database schemas |
| product-designer | Product Designer | Information architecture, user flows, wireframes |
| researcher | Truth Seeker | Verifies documentation, checks versions (read-only) |
| tech-writer | The Scribe | Maintains README, API docs, CHANGELOG, marketing content support |
Implementation Layer
| Agent | Role | Capabilities |
|---|---|---|
| coder-frontend | UI Specialist | Implements user interfaces with React/TypeScript |
| coder-backend | API Specialist | Builds servers, APIs, and database logic |
| ui-ux-designer | The Creative | Design tokens, CSS/Tailwind, accessibility, high-fidelity designs |
| db-admin | Data Custodian | Database schemas, migrations, seed data |
| test-engineer | Test Engineer | Test strategy, test development, test automation |
Operational Layer
| Agent | Role | Capabilities |
|---|---|---|
| qa-lead | Quality Guardian | Reviews code, ensures standards, approves work |
| security-specialist | The Shield | Security audits, vulnerability scanning |
| devops-engineer | The Builder | CI/CD pipelines, Docker, deployment |
| performance-engineer | Performance Engineer | Performance testing, optimization, bottleneck analysis |
| release-manager | Release Manager | Release planning, version management, changelog |
| compliance-specialist | Compliance Specialist | GDPR compliance, legal requirements, privacy policy |
| data-analyst | Data Analyst | Analytics setup, KPI tracking, insights |
| customer-success | Customer Success | User feedback, support analysis, feature requests |
Installation
Prerequisites
- Claude CLI installed and configured
- Python 3.8+ (for validation scripts)
- Node.js 18+ (for MCP servers)
Quick Install
# Clone or download the plugin
git clone https://github.com/virtuoso-dev/virtuoso.git
# Navigate to plugin directory
cd virtuoso
# Install the plugin
claude plugin install ./
# Verify installation
claude plugin list
Alternative: Local Development
# Start Claude Code with plugin directory
claude --plugin-dir /path/to/virtuoso
Quick Start
1. Initialize Your Project
/virtuoso-init
This creates the Virtuoso ecosystem in your project:
CLAUDE.md- Project constitution.claude/rules/- Tech stack, protocol, design system, security policyPRD.md- Product requirements template.mcp.json- MCP server configuration
2. Start Your Project (Complete Discovery & Planning)
/virtuoso-start "I want to build a task management app"