SuperClaude - Marco de Desarrollo de IA Especializado

Resumen del Proyecto

SuperClaude es un marco de configuración integral, diseñado específicamente para mejorar las capacidades de Claude Code. Transforma a Claude Code de un asistente de IA genérico en un socio de desarrollo de IA especializado, ofreciendo 19 comandos especializados, 9 roles cognitivos y una metodología de desarrollo avanzada.

Características Principales

🎯 Sistema de Roles Cognitivos

SuperClaude ofrece 9 roles cognitivos especializados, cada uno con un área de especialización y un modo de pensamiento específicos:

Rol	Área de Especialización	Escenario de Uso	Comando de Ejemplo
architect	Diseño de sistemas, mantenibilidad a largo plazo	Planificación de sistemas grandes	/persona:architect → /user:design --api --ddd
frontend	Experiencia de usuario, interfaz visual	Trabajo de UI/UX	/persona:frontend → /user:build --react
backend	Rendimiento, fiabilidad, API	Desarrollo de lado del servidor	/persona:backend → /user:build --api
analyzer	Análisis de causa raíz, toma de decisiones basada en evidencia	Depuración de problemas complejos	/persona:analyzer → /user:troubleshoot --investigate
security	Modelado de amenazas, seguridad primero	Revisión de seguridad	/persona:security → /user:scan --security
mentor	Enseñanza, descubrimiento guiado	Aprendizaje/Explicación	/persona:mentor → /user:explain --depth
refactorer	Calidad de código, simplificación	Mejora de código	/persona:refactorer → /user:improve --quality
performance	Optimización de velocidad, análisis de cuellos de botella	Ajuste de rendimiento	/persona:performance → /user:improve --performance
qa	Aseguramiento de calidad, pruebas	Flujo de trabajo de pruebas	/persona:qa → /user:test --coverage

🛠️ Sistema de Comandos Especializados

SuperClaude ofrece 18 comandos de barra especializados, que cubren todo el ciclo de vida del desarrollo:

Comandos de Desarrollo (3)

• /user:build - Constructor de proyectos general
  • --init Nuevo proyecto, --feature Añadir característica, --react Aplicación React, --api Backend, --tdd Desarrollo guiado por pruebas
• /user:dev-setup - Configuración del entorno de desarrollo
  • --install Herramientas, --ci CI/CD, --monitor Monitoreo
• /user:test - Marco de pruebas
  • --coverage Cobertura, --watch Modo de observación, --e2e Pruebas de extremo a extremo

Comandos de Análisis y Mejora (4)

• /user:analyze - Análisis multidimensional
  • --code Revisión de código, --architecture Diseño, --profile Rendimiento, --security Vulnerabilidades
• /user:troubleshoot - Depuración y reparación
  • --investigate Explorar, --fix Reparar, --five-whys Causa raíz, --prod Entorno de producción
• /user:improve - Mejorar código/rendimiento
  • --quality Refactorizar, --performance Optimizar, --iterate Mejora continua, --threshold Porcentaje objetivo
• /user:explain - Explicación profunda
  • --depth Nivel de complejidad, --visual Diagramas, --examples Ejemplos de código

Comandos de Operaciones (6)

• /user:deploy - Despliegue de aplicaciones
• /user:migrate - Migración de bases de datos/código
• /user:scan - Seguridad y validación
• /user:estimate - Predicción de tiempo/complejidad
• /user:cleanup - Mantenimiento del proyecto
• /user:git - Gestión del flujo de trabajo de Git

Comandos de Diseño y Arquitectura (1)

• /user:design - Diseño de sistemas
  • --api REST, --ddd Diseño dirigido por dominio, --prd Requisitos, --openapi Especificación, --graphql GraphQL

Comandos de Flujo de Trabajo (2)

• /user:spawn - Crear subagente especializado
• /user:document - Creación de documentación

Comandos de Sistema (1)

• /user:load - Cargar contexto del proyecto

🔧 Integración MCP (Protocolo de Contexto del Modelo)

SuperClaude integra cuatro potentes servidores MCP:

1. Context7 (C7) - Búsqueda automática de documentación

   • Búsqueda instantánea de documentación de bibliotecas
   • Integración perfecta con flujos de trabajo de GitHub

2. Sequential - Análisis complejo

   • Pensamiento secuencial para problemas profundos
   • Adecuado para diseño de sistemas y análisis de causa raíz

3. Magic - Generación de UI

   • Creación automática de componentes React
   • Construcción inteligente de UI

4. Puppeteer - Pruebas de navegador

   • Validación de componentes de UI
   • Monitoreo de rendimiento

🚀 Ventajas Clave

Optimización de Tokens

• Modo UltraComprimido: 70% de reducción de Tokens
• Simplificación estilo telegrama: Eliminación de artículos/conjunciones/preposiciones
• Simbolización: →(a), &(y), @(en), w/(con), +(añadir), -(eliminar)
• Abreviaturas: cfg(configuración), fn(función), impl(implementación)

Enfoque Prioritario en la Investigación

• Búsqueda automática de documentación oficial
• Toma de decisiones basada en evidencia
• Implementación impulsada por referencias

Pensamiento Adaptativo

• Ajusta la profundidad del análisis según la tarea
• Selección inteligente de herramientas
• Respuestas conscientes del contexto

Instalación y Configuración

Instalación Automática

git clone https://github.com/NomenAK/SuperClaude.git
cd SuperClaude
./install.sh

Instalación Manual

# 1. Crear estructura
mkdir -p ~/.claude/commands/shared

# 2. Copiar archivos de configuración
cp CLAUDE.md RULES.md PERSONAS.md MCP.md ~/.claude/

# 3. Copiar comandos
cp .claude/commands/*.md ~/.claude/commands/

# 4. Copiar recursos compartidos
cp .claude/commands/shared/*.yml ~/.claude/commands/shared/

Verificación de la Instalación

# Comprobar instalación
ls -la ~/.claude/ # Debería mostrar 4 archivos principales
ls -la ~/.claude/commands/ # Debería mostrar 17 archivos (16 comandos + índice)

# Probar uso
# Abrir cualquier proyecto en Claude Code e intentar:
/user:analyze --code
/persona:architect

Estructura del Proyecto

~/.claude/
├── CLAUDE.md          # Configuración principal (carga otros archivos)
├── RULES.md           # Gobernanza y prácticas
├── PERSONAS.md        # 9 arquetipos cognitivos
├── MCP.md             # Patrones del Protocolo de Contexto del Modelo
└── commands/          # 17 comandos de barra especializados + índice
    ├── analyze.md
    ├── build.md
    ├── cleanup.md
    ├── deploy.md
    ├── design.md
    ├── dev-setup.md
    ├── document.md
    ├── estimate.md
    ├── explain.md
    ├── git.md
    ├── improve.md
    ├── index.md
    ├── load.md
    ├── migrate.md
    ├── scan.md
    ├── spawn.md
    ├── test.md
    ├── troubleshoot.md
    └── shared/        # 19 recursos de configuración
        ├── ambiguity-check.yml
        ├── audit.yml
        ├── checkpoint.yml
        ├── cleanup-patterns.yml
        ├── command-memory.yml
        ├── documentation-dirs.yml
        ├── evidence.yml
        ├── git-operations.yml
        ├── git-workflow.yml
        ├── impl.yml
        ├── loading-cfg.yml
        ├── mcp-flags.yml
        ├── patterns.yml
        ├── performance-monitoring.yml
        ├── planning-mode.yml
        ├── research-first.yml
        ├── thinking-modes.yml
        ├── ultracompressed.yml
        └── validation.yml

Ejemplos de Uso

Banderas Generales

Banderas generales soportadas por todos los comandos:

Planificación y Pensamiento

• --plan - Muestra el plan de ejecución antes de ejecutar
• --think - Modo de análisis estándar (contexto de múltiples archivos)
• --think-hard - Modo de análisis profundo (nivel de arquitectura)
• --ultrathink - Modo de análisis crítico (nivel de sistema)

Control de Documentación

• --ultracompressed / --uc - Modo de reducción de Tokens de ~70%

Control del Servidor MCP

• --c7 / --no-c7 - Habilitar/Deshabilitar documentación Context7
• --seq / --no-seq - Habilitar/Deshabilitar pensamiento Sequential
• --magic / --no-magic - Habilitar/Deshabilitar constructor de UI Magic
• --pup / --no-pup - Habilitar/Deshabilitar navegador Puppeteer
• --all-mcp - Habilitar todos los servidores MCP
• --no-mcp - Deshabilitar todos los servidores MCP (solo herramientas nativas)

Ejemplos de Flujo de Trabajo

Proceso de Desarrollo Completo

/persona:architect → /user:load --depth deep → /user:analyze --architecture
/user:design --api --ddd → /user:estimate --detailed
/persona:backend → /user:build --api
/persona:frontend → /user:build --react → /user:test --coverage
/persona:security → /user:scan --security → /user:improve --quality
/user:cleanup --all → /user:deploy --env staging

Flujo de Trabajo de Depuración

/persona:analyzer → /user:troubleshoot --investigate --prod → /user:analyze --profile
"think hard about performance bottlenecks" → /user:troubleshoot --five-whys
/persona:performance → /user:improve --performance --iterate --threshold 90%

Pruebas y Aseguramiento de Calidad

/persona:qa → /user:test --e2e → /user:scan --validate
/persona:mentor → /user:explain --depth beginner --visual --examples
/user:document --user → /user:build --tdd → /user:analyze --code

Organización de la Documentación

Documentación Operativa vs. Documentación del Proyecto

SuperClaude separa automáticamente los informes operativos y la documentación del proyecto:

.claudedocs/           # Documentación operativa de Claude
├── audit/
├── reports/
├── summaries/
├── metrics/
└── incidents/

/docs                  # Documentación del proyecto
├── api/
├── guides/
├── architecture/
└── development/

Informes Automáticos

• analyze → reports/
• scan → reports/
• test → metrics/
• troubleshoot → incidents/

Documentación Manual

• /user:document → API → /docs/api/
• Guías → /docs/guides/

Funciones Avanzadas

Adaptación del Modelo

• Tareas simples → sonnet (rentable)
• Tareas complejas → sonnet-4 (equilibrado)
• Tareas críticas → opus-4 (máxima capacidad)

Comandos de Conveniencia

• /compact - Reducción inteligente
• /clear - Empezar de nuevo
• /model - Cambiar modelo

Sistema de Puntos de Control

El sistema de puntos de control integrado con Git permite a los desarrolladores navegar de vuelta a cualquier punto del flujo de trabajo:

/user:git --checkpoint before-refactor
/user:git --rollback

Solución de Problemas

Problemas Comunes

1. El comando no funciona: Comprobar ls ~/.claude/commands/ (debería mostrar 17 archivos)
2. Problemas de planificación: Añadir la bandera --plan → /user:deploy --plan
3. Problemas de rol: /persona:architect → /persona:security → /user:scan --security
4. Problemas de MCP: "React docs" → C7 | "slow app" → Sequential

Comandos de Mantenimiento

• Actualizar: cd SuperClaude && git pull && ./install.sh
• Copia de seguridad: cp -r ~/.claude/ ~/.claude.backup.$(date +%Y%m%d)
• Desinstalar: rm -rf ~/.claude/

Ventajas del Proyecto

Ventajas para el Desarrollador

• ✅ Flujo de trabajo consistente para todos los proyectos
• ✅ Enfoque prioritario en la investigación → siempre busca documentación oficial
• ✅ Estándares de calidad → mejores prácticas integradas
• ✅ Especialización cognitiva → el modo de pensamiento correcto para cada tarea

Escenarios de Aplicación

• Desarrolladores → Flujo de trabajo de codificación más rápido e inteligente
• Equipos → Patrones de asistencia de IA consistentes
• Proyectos → Desarrollo centrado en la calidad
• Aprendizaje → Desarrollo de habilidades guiado por IA

Características Técnicas

Sistema de Símbolos

SuperClaude utiliza un sistema de símbolos único para mejorar la eficiencia:

Símbolo	Significado	Abreviatura	Significado
→	Resulta en	cfg	Configuración
&	Y/Con	fn	Función
w/	Con	impl	Implementación
@	En/Ubicado en	env	Entorno
+	Añadir/Incluir	dev	Desarrollo
-	Eliminar/Excluir	auth	Autenticación
∀	Para todos/Cada	API	Interfaz de Programación de Aplicaciones

Información de la Versión

• Versión Actual: v4.0.0
• Tipo: Marco de configuración (no código ejecutable)
• Compatibilidad: Claude Code
• Ubicación de Instalación: ~/.claude/ (instalación global)

Resumen

SuperClaude transforma a Claude Code de un asistente de IA genérico en un socio de desarrollo especializado, ofreciendo:

• Un sistema de roles cognitivos especializados
• Un conjunto completo de herramientas de comandos
• Integración inteligente de MCP
• Optimización eficiente de Tokens
• Metodología impulsada por la investigación

Este marco es particularmente adecuado para desarrolladores y equipos que requieren una experiencia de desarrollo asistida por IA consistente y de alta calidad. A través de su diseño modular y enfoque especializado, SuperClaude asegura que cada tarea de desarrollo reciba la experiencia y el soporte de herramientas adecuados.