v3.2.0 — Open Source MCP Plugin

Your AI Development Team

8 specialist agents with a shared index system for lightning-fast context. Build stunning apps with 3D scenes, scroll animations, glassmorphism, particles, and production-grade UI. Avoids two confirmed Claude Code cache bugs that can inflate your API costs. Describe what you want. They architect, design, code, test, and deploy it.

Claude Code Claude Desktop Cursor Windsurf VS Code + Copilot Cline Continue.dev Codex CLI OpenCode
8
AI Agents
22
MCP Tools
19
Commands
61
Knowledge Files
9
AI Clients
2
Cache Bugs Avoided

Three steps. Zero boilerplate.

Describe your vision in plain language. The agents handle architecture, code, design, tests, and deployment.

1

Describe Your App

Tell the AI what you want to build. "A SaaS dashboard with user auth, Stripe billing, and an analytics page." That is enough.

2

Agents Build It

The Team Lead plans the architecture. Frontend Dev builds the UI. Backend Dev writes the APIs. UI Designer polishes. QA tests. All coordinated through a shared index.

3

Ship It

Get a complete, working application with clean code, proper file structure, responsive design, and deployment config. Iterate with natural language.

Works with 9 AI clients

One plugin, every major AI coding tool. Install once, use everywhere.

Claude Desktop

MCP native

Claude Code

MCP or direct plugin

Cursor

MCP server

Windsurf

MCP server

VS Code + Copilot

MCP server

Cline

MCP server

Continue.dev

MCP server

OpenAI Codex CLI

MCP server

OpenCode

MCP server

8 Specialist Agents

Each agent has deep expertise in its domain, a full instruction set, and access to 61 knowledge files with copy-paste-ready code — including 3D scenes, scroll animations, and particle effects.

Team Lead

Orchestrator

Plans architecture, decomposes features into tasks, delegates to specialists, tracks progress through the shared index.

All scopes

Frontend Dev

UI Builder

Builds pages, components, layouts. HTML/CSS/JS for Simple scope, React for Prototype, Next.js for MVP/Production. Uses design system tokens.

All scopes

Backend Dev

API & Data

API routes, database schemas, authentication, business logic, external integrations. Prisma ORM, NextAuth, Stripe, Zod validation.

MVP + Production

UI Designer

Design System

Creates design tokens (globals.css, tailwind.config.ts), enforces visual consistency, typography hierarchy, color palettes, spacing rhythm.

Prototype+

3D Designer

3D Experience

Builds immersive 3D scenes, particle systems, scroll-driven animations, glassmorphism effects using React Three Fiber, Drei, GSAP, and post-processing.

All scopes

QA Tester

Quality

Writes tests (unit, integration, E2E), runs lint checks, audits accessibility, checks dependency versions, validates API contracts.

MVP + Production

Deployer

Infrastructure

CI/CD pipelines, Docker configuration, hosting setup (Vercel, Netlify, Railway), environment variables, production optimization.

Production

Error Recovery

Debugger

Diagnoses build failures, runtime errors, dependency conflicts. Reads error logs, suggests fixes, applies patches. Called on-demand when things break.

On demand

Right tool for every project size

The scope controls the stack, which agents activate, and how much infrastructure gets built. Never overbuild.

Simple

HTML / CSS / JS

Landing pages, portfolios, static sites. No build tools, no frameworks.

  • Pure HTML/CSS/JS
  • Frontend agent only
  • Static hosting
  • Zero dependencies

Prototype

Vite + React + Tailwind

Interactive demos, proof-of-concepts. Fast iteration with mock data.

  • Vite + React
  • Tailwind CSS
  • Mock data (no API)
  • UI + Frontend agents

MVP

Next.js + Prisma + shadcn/ui

Full-stack apps with database, auth, and API routes. Ship to real users.

  • Next.js App Router
  • Prisma + SQLite/Postgres
  • shadcn/ui components
  • Auth + API routes
  • Critical path tests

Production

Full Stack + CI/CD + Docker

Production-grade apps. All agents active, full test suite, deployment pipeline.

  • Everything in MVP
  • Full test suite
  • CI/CD pipeline
  • Docker config
  • Error tracking
  • All 8 agents active

19 slash commands. 22 MCP tools.

Natural language skills for every stage of development. Type /start in Claude Code to begin, or call MCP tools programmatically from any AI client.

▶ Project Lifecycle

  • startNew project -- vision capture + scope selection
  • buildExecute the full build pipeline
  • resumeprojectContinue from where you left off
  • statusQuick project overview
  • projectsList/switch between all your projects

✚ Add Features

  • add-pageAdd a page to existing app
  • add-featureAdd a feature (frontend + backend)
  • generateGenerate component, api, hook, model, or test
  • connect-dataConnect external data (API, Supabase, Firebase, CSV)

✎ Modify & Fix

  • modify-uiQuick UI changes -- layout, theme, colors, dark mode
  • fixFix a bug -- describe the problem
  • refactorImprove code quality

⚙ Maintenance

  • reviewCode quality review
  • explainExplain how something works
  • deploySet up deployment
  • update-depsCheck/update dependencies
  • configView/change project settings
  • indexView/rebuild project index
  • helpShow all commands and tips

Real scenarios, real results

SaaS Dashboard

Full-stack app with auth, Stripe billing, analytics charts, and admin panel. MVP scope with Next.js + Prisma.

"Build a SaaS dashboard with user auth, Stripe billing, and usage analytics"

Portfolio Site

Beautiful personal site with projects grid, about section, contact form. Simple scope -- pure HTML/CSS/JS, no frameworks.

"Create a portfolio site with a dark theme, project showcase, and contact form"

E-commerce Store

Product catalog, cart, checkout with Stripe, order management. Production scope with full test suite and CI/CD.

"Build an online store for handmade jewelry with Stripe checkout"

Data Dashboard

Interactive charts, real-time data, CSV import, filterable tables. Prototype scope with Vite + React + Recharts.

"Create a dashboard that visualizes CSV data with charts and filters"

Internal Tool

CRUD app connected to Supabase, role-based access, data tables with sort/filter/export. MVP scope.

"Build an internal tool for managing customer support tickets with Supabase"

3D Immersive Website

Scroll-driven 3D story with real GLTF models from Sketchfab/Mixamo, GSAP animations, particles, and glassmorphism overlays. Prototype scope with R3F + Drei.

"Create a Dora-style 3D scroll website for my job search app with real 3D models"

Structured reference for AI agents

Everything an AI agent needs to understand, configure, and use 10x Development Team in a user's project.

This section is designed for machine parsing. AI agents: read the code blocks and tables below for exact commands, config paths, and tool signatures.

Setup Commands

# Auto-detect all installed AI clients and configure them
npx 10x-development-team setup

# Configure a specific client
npx 10x-development-team setup --client cursor
npx 10x-development-team setup --client claude-desktop
npx 10x-development-team setup --client claude-code
npx 10x-development-team setup --client windsurf
npx 10x-development-team setup --client cline
npx 10x-development-team setup --client vscode
npx 10x-development-team setup --client continue
npx 10x-development-team setup --client codex
npx 10x-development-team setup --client opencode

# Configure all clients at once
npx 10x-development-team setup --all

# Install as Claude Code direct plugin (no MCP)
npx 10x-development-team install-plugin ~/my-app

# Health check
npx 10x-development-team doctor

Config File Locations (per client)

ClientConfig Path (macOS/Linux)Config Path (Windows)
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json
Claude Code~/.claude/.mcp.json
Cursor~/.cursor/mcp.json
Windsurf~/.codeium/windsurf/mcp_config.json
ClineVS Code globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
VS Code + Copilot.vscode/mcp.json (workspace) -- uses "servers" key, not "mcpServers"
Continue.dev~/.continue/mcp.json
Codex CLI~/.codex/mcp.json
OpenCode~/.config/opencode/mcp.json

MCP Config Format (.mcp.json -- auto-created by postinstall)

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    },
    "10x-dev": {
      "command": "node",
      "args": ["/path/to/node_modules/10x-development-team/dist/index.js"],
      "env": {
        "PROJECT_DIR": "/path/to/your/project",
        "PLUGIN_ROOT": "/path/to/node_modules/10x-development-team"
      }
    }
  }
}

VS Code uses "servers" as the top-level key instead of "mcpServers". Windows uses "command": "cmd", "args": ["/c", "npx", ...] for Playwright.

MCP Tool Reference (22 tools)

Project Lifecycle (5 tools)

ToolParametersReturns
tenx_start name, description, scope (simple|prototype|mvp|production), type (website|webapp|mobile|ecommerce|other), target_users?, core_features?, first_screen? Project JSON, creates .10x/ directory, registers in SQLite memory
tenx_build vision_summary? (string) Project data, existing files, tasks, build instructions from skill file
tenx_projects action (list|search|info|delete), query? (string) Project list, search results, project info with sessions/memories
tenx_read_index (none) project.json + file-index.json + tasks.json + feature-map.json
tenx_update_index file_index_updates?, task_updates?, dev_log_entry?, feature_map_updates? Confirmation of which files were updated

Knowledge & Components (4 tools)

ToolParametersReturns
tenx_get_skill skill_name (start|build|add-page|add-feature|connect-data|modify-ui|generate|fix|refactor|review|explain|deploy|resumeproject|status|update-deps|config|index|projects|help) Full skill markdown with step-by-step instructions
tenx_get_knowledge category (frameworks|libraries|patterns|components-source), file_name (e.g. "nextjs.md") Knowledge file content with copy-paste code patterns
tenx_list_knowledge (none) Full knowledge index JSON with all categories and file descriptions
tenx_get_components (none) Component registry JSON with props, variants, template paths

Memory & Context (3 tools)

ToolParametersReturns
tenx_save_memory category (decision|preference|issue|context|user_feedback), content (string) Confirmation of saved memory
tenx_get_context (none) Project info, recent sessions, saved memories
tenx_get_agent agent_name (team-lead|frontend-dev|backend-dev|ui-designer|3d-designer|qa-tester|deployer|error-recovery) Full agent instruction markdown

Session & Health (2 tools) NEW v3.1

ToolParametersReturns
tenx_update_session session_id (string), summary?, tasks_completed? (string[]), files_created? (string[]), files_modified? (string[]) Closes/updates a build session. Persists what was accomplished to SQLite for cross-session memory
tenx_health (none) Full health check: SQLite status, project index, file count, tasks, plugin files, feature map, dev log

User Interaction (2 tools) NEW

ToolParametersReturns
tenx_ask_user question_type (approval|choice|multi_choice|open_ended|priority|confirmation), title, question, context?, options? [{label, description?, preview?}], default_option?, deadline_context? Formatted question for user with question_id. Stores in .10x/pending-questions.json
tenx_save_answer question_id (string), answer (string), selected_options? (string[]) Saves user response, persists to SQLite memory for cross-session recall

3D Asset Pipeline (4 tools) NEW

ToolParametersReturns
tenx_download_asset url (URL), filename (e.g. "laptop.glb"), asset_type (model|texture|hdri|animation|other), source?, license?, description? Downloaded file path, public URL, R3F usage hint. Tracked in .10x/assets.json
tenx_list_assets (none) All downloaded 3D assets with paths, sources, licenses
tenx_browse_3d_sources query (string), source (all|sketchfab|polyhaven|mixamo|kenney|quaternius), format_preference (glb|gltf|fbx|any), license_filter (any|cc0|cc-by|free), max_poly? Search URLs for each source, recommended workflow, tips per source
tenx_model_sources category (all|characters|objects|environments|effects|textures|hdri) Full registry of free 3D sources: Sketchfab, Poly Haven, Mixamo, Kenney, Quaternius, ReadyPlayer.me + tools (gltf.pmnd.rs, gltf.report, gltf-transform)

Storyboard & Visual (2 tools) NEW

ToolParametersReturns
tenx_storyboard action (create|read|update_scene|approve|reject), storyboard? {title, narrative, style (dora-hero|scroll-story|parallax-layers|scene-transitions|interactive-explore), scenes? [{id, title, scroll_range, model_3d, text_overlay, background, camera?, transition?}]}, scene_id?, scene_updates?, feedback? Creates/reads/updates storyboard in .10x/storyboard.json. Supports approval/rejection workflow
tenx_screenshot url (default localhost:5173), filename, full_page?, width?, height?, wait_for?, scroll_to? Screenshot saved to .10x/screenshots/. Uses Playwright (auto-installed). Falls back gracefully if unavailable

Knowledge Base Index (61 files)

Agents should call tenx_get_knowledge with the category and filename before writing code. Each file contains copy-paste-ready patterns.

📁 Frameworks

  • framework-selection.mdDecision matrix: which framework for which scope
  • nextjs.mdNext.js App Router, API routes, layouts, metadata
  • vite-react.mdVite + React setup, routing, build config
  • expo-react-native.mdExpo + React Native, navigation, native APIs
  • html-css-js.mdVanilla HTML/CSS/JS for Simple scope

📚 Libraries

  • shadcn-ui.mdshadcn/ui install, component list, theming
  • tailwind.mdTailwind utilities, responsive, dark mode, config
  • framer-motion.mdAnimations: fade, slide, scale, stagger, scroll
  • prisma.mdDatabase ORM: schema, migrations, CRUD, relations
  • zod.mdValidation: schemas, parsing, error messages
  • nextauth.mdAuth: providers, session, middleware, protected routes
  • stripe.mdPayments: checkout, subscriptions, webhooks
  • zustand.mdState management: stores, selectors, persist
  • react-hook-form.mdForms: validation, error display, submission
  • resend.mdEmail: Resend API, React Email templates
  • charts-dataviz.mdRecharts, stat cards, sparklines, dashboards
  • react-three-fiber.mdR3F Canvas, meshes, materials, lights, camera
  • drei.mdFloat, Stars, Sparkles, Environment, useGLTF, MeshDistortMaterial
  • gsap-scrolltrigger.mdGSAP timelines, ScrollTrigger, scrub, pin
  • three-postprocessing.mdBloom, vignette, chromatic aberration, depth of field

🔧 Patterns

  • ui-ux-principles.mdTypography, spacing, color tokens, accessibility
  • design-system.mdglobals.css tokens, tailwind.config.ts, HSL system
  • react-components.mdProps, composition, conditional render, lists
  • api-patterns.mdCRUD routes, auth middleware, error handling
  • data-fetching.mdServer components, client fetch, SWR, loading states
  • auth-flow.mdLogin, signup, session, protected routes
  • responsive-layout.mdMobile-first, breakpoints, grid, flex
  • dark-mode.mdTailwind class strategy, system preference, toggle
  • seo.mdMetadata, sitemap, robots, Open Graph
  • external-api.mdREST client, GraphQL, proxy routes, OAuth
  • data-sources.mdSupabase, Firebase, Airtable, Google Sheets, Notion
  • file-ingestion.mdCSV, JSON, Excel parsing, drag-drop upload
  • file-storage.mdS3/R2 presigned URLs, Supabase Storage
  • realtime.mdSSE, WebSocket, Supabase Realtime, polling
  • rate-limiting.mdRate limiting, CORS, security headers
  • monitoring.mdSentry, structured logging, health checks
  • plugin-memory.mdSQLite memory schema, cross-project tracking
  • 3d-scenes.mdScene composition, lighting rigs, material recipes
  • particle-systems.mdInstanced particles, confetti, sparkle trails
  • scroll-driven-3d.mdGSAP + R3F scroll animation, chapter transitions
  • glassmorphism.mdFrosted glass, backdrop-blur, layered transparency
  • 3d-hero-sections.mdHero with 3D background, text overlay, scroll indicator

📦 Components (copy-paste)

  • button.mdButton with variants, sizes, loading state
  • card.mdCard with image, content, actions
  • input.mdInput with label, error, icon
  • form.mdComplete form with validation
  • modal.mdModal/dialog with backdrop, focus trap
  • navbar.mdResponsive navbar with mobile menu
  • sidebar.mdCollapsible sidebar for dashboards
  • data-table.mdData table with sort, filter, pagination
  • toast.mdToast notification system
  • auth-pages.mdLogin + Signup pages

Architecture

Two Integration Modes

ModeHowBest For
MCP ServerRuns as local MCP server. AI client connects via stdio. 22 tools exposed. Works with all 9 clients. SQLite optional (graceful fallback).Any AI client with MCP support
Direct PluginCopies agents/, skills/, knowledge/, components/ into project's .claude/ directory. No server needed.Claude Code only

Plugin File Structure

plugin/
  agents/           # 8 agent instruction files (.md)
    team-lead.md        # Orchestrator -- delegates, tracks, reports
    frontend-dev.md     # Pages, components, UI
    backend-dev.md      # APIs, database, auth
    ui-designer.md      # Design system, tokens, visual consistency
    3d-designer.md      # 3D scenes, particles, scroll-driven 3D, R3F
    qa-tester.md        # Tests, lint, quality
    deployer.md         # CI/CD, Docker, hosting
    error-recovery.md   # Fix build errors, crashes
  skills/           # 19 skill files (.md) -- step-by-step instructions
    start.md, build.md, add-page.md, add-feature.md, ...
  knowledge/        # 61 reference files organized by category
    frameworks/     # nextjs.md, vite-react.md, html-css-js.md, expo-react-native.md
    libraries/      # shadcn-ui.md, tailwind.md, prisma.md, stripe.md,
                    # react-three-fiber.md, drei.md, gsap-scrolltrigger.md, three-postprocessing.md
    patterns/       # ui-ux-principles.md, design-system.md, api-patterns.md,
                    # 3d-scenes.md, particle-systems.md, scroll-driven-3d.md,
                    # glassmorphism.md, 3d-hero-sections.md
    components-source/  # button.md, card.md, navbar.md, modal.md, ...
    index.json      # Master index -- read this first
  components/
    registry.json   # Component registry with props and variants
  CLAUDE.md         # Master instructions for all agents

Project Index (.10x/ directory)

.10x/
  project.json      # App name, scope, type, stack, vision
  file-index.json   # Every file: type, description, exports, dependencies
  tasks.json        # Task tracker: id, status, assigned_to, goal
  feature-map.json  # Feature-to-file mapping with data flow wiring
  dev-log.md        # Chronological log of all agent actions
  assets.json       # Downloaded 3D models, textures, HDRIs with licenses
  storyboard.json   # 3D website story scenes, scroll mappings, model refs
  pending-questions.json  # User approval/choice questions awaiting response
  screenshots/      # Playwright screenshots for visual verification

Auto-Created by Postinstall

# When users run: npm install 10x-development-team
# The postinstall script automatically creates:

.claude/              # Plugin files (agents, skills, knowledge, components, hooks)
.10x/                 # Project tracking directory
.10x/assets.json      # 3D asset registry
.env                  # Environment variable skeleton
.env.example          # All possible env vars documented
.mcp.json             # Playwright MCP + 10x MCP wired in
.gitignore            # Updated with .env, .10x/screenshots/
public/models/        # Directory for 3D models (GLB, GLTF)
public/textures/      # Directory for PBR textures
public/hdri/          # Directory for environment maps

# SQLite memory (~/.10x/memory.db) is created on first use
# SQLite is optional — server works without it (graceful fallback)

Persistent Memory

# SQLite database at ~/.10x/memory.db
# Tables: projects, sessions, memories
# Tracks all projects across sessions
# Falls back to .10x/ files if SQLite unavailable

The Index System — shared brain for all agents

Agents don't scan your filesystem. They read a lightweight index that tracks every file, task, feature, and decision. This cuts token usage by 60-80% and eliminates duplicate work.

📁 Project Index .10x/

Lives inside each project directory. Every agent reads this instead of exploring the codebase.

  • project.json — App name, scope, stack, vision
  • file-index.json — Every file: type, exports, dependencies
  • tasks.json — Task tracker with goals and assignments
  • feature-map.json — Feature-to-file mapping with data flow
  • dev-log.md — Chronological log of all agent actions

🗃 Global Memory ~/.10x/

SQLite database in your home directory. Remembers ALL projects across sessions. Optional — graceful fallback if unavailable.

  • projects — Every project you've ever built
  • sessions — Build history, files created, tasks done
  • memories — Decisions, preferences, user feedback
  • shared_patterns — Reusable code across projects
  • Falls back to .10x/ files if SQLite is unavailable
60-80% less tokens
Agents read the index (2K tokens) instead of scanning files (80K+ tokens)
🔗
Zero duplicate work
Agents see what others built. Backend logs API shapes, frontend reads them
🔄
Resume without cache rebuild
Avoids Claude Code's --resume cache bug (#34629). Reads index files in a fresh session instead.

Avoids two confirmed Claude Code cache bugs

Two open bugs in Claude Code can break prompt caching without any visible error. This plugin's index-first architecture sidesteps both — especially the --resume bug, where /resumeproject is significantly cheaper.

Bug 1 #40524

Sentinel Replacement Breaks Cache

The standalone binary replaces a billing sentinel in the request body. If your conversation contains CC internal strings, it replaces the wrong instance — changing your messages every request and breaking the cache prefix.

Impact
~$0.04–0.15 extra per request, every request, silently
Bug 2 #34629

--resume Always Breaks Cache

Since v2.1.69, every --resume causes a full cache miss. Only the system prompt is cached; all conversation history rebuilds from scratch due to a deferred_tools_delta injection mismatch.

Impact
~$0.15 per resume on a 500K token conversation

How This Plugin Avoids Both Bugs

Bug 1 — Clean Context

The plugin's CLAUDE.md and knowledge files contain only project instructions and framework references — no CC internals or billing strings. This means the trigger conditions for this bug are unlikely to occur. Note: most normal projects are also unaffected by this bug.

Bug 2 — Index-Based Resume

Instead of --resume, the plugin's /resumeproject command reads small .10x/ index files in a fresh session. Full context reconstruction from ~5KB of JSON instead of rebuilding the entire conversation cache. This is the plugin's most concrete cost benefit.

💰
~$0.15 per resume
Cost of --resume on a 500K token conversation. Scales with conversation size.
🛡
~$0.001 with /resumeproject
Reads 5 small JSON index files in a fresh session. No cache rebuild needed.
📈
Significant savings on resume
The bigger your conversation, the more you save. Index-based resume scales to any project size.

Install in 30 seconds

Install globally to use across all projects, or per-project for full auto-setup. Both modes give you the complete skill set.

MCP Server (any AI client)

Configure the MCP server for Cursor, Windsurf, Cline, VS Code, Continue, Codex, or OpenCode.

npx 10x-development-team setup --client cursor
npx 10x-development-team setup --client windsurf
npx 10x-development-team setup --all

Claude Code Direct Plugin (no MCP)

Copy plugin files directly into a project. Claude Code reads .claude/ natively — no server needed.

npx 10x-development-team install-plugin ~/my-app
# Then: cd ~/my-app && claude
# Type: /start

What gets auto-created on npm install

.claude/ agents, skills, knowledge, hooks
.10x/ project tracking + assets
.mcp.json Playwright + 10x MCP
.env + .env.example skeleton
public/models/ 3D asset directories
hooks.json index enforcement hooks

CLI Commands

# Setup & Configuration
npx 10x-development-team setup                    # Auto-detect + configure all AI clients
npx 10x-development-team setup --client cursor     # Configure specific client
npx 10x-development-team setup --all               # Configure ALL 9 clients
npx 10x-development-team install-plugin ~/my-app   # Direct plugin install (Claude Code)
npx 10x-development-team doctor                    # Health check + diagnostics
npx 10x-development-team --version                 # Show version

Slash Commands (Claude Code)

# In Claude Code, type any of these:
/start          # New project -- describe what you want to build
/build          # Execute the full build pipeline
/add-page       # Add a new page to your app
/add-feature    # Add a feature (frontend + backend)
/generate       # Generate component, api, hook, model, or test
/connect-data   # Connect external data (API, Supabase, Firebase, CSV)
/modify-ui      # Quick UI changes -- layout, theme, colors, dark mode
/fix            # Fix a bug -- describe the problem
/refactor       # Improve code quality
/review         # Code quality review
/explain        # Explain how something works
/deploy         # Set up deployment
/resumeproject  # Continue from where you left off
/status         # Quick project overview
/update-deps    # Check/update dependencies
/config         # View/change project settings
/index          # View/rebuild project index
/projects       # List/switch between all projects
/help           # Show all commands and tips