Claude Code Starter Kit

Una coleccion completa de agentes, comandos, skills y MCPs para potenciar Claude Code.

Que Incluye

| Componente | Cantidad | Descripcion | |------------|----------|-------------| | Agentes | 11 | Especialistas para diferentes tareas | | Commands | 19 | Workflows automatizados | | Skills | 17 | Patrones y best practices | | MCPs | 3 | Memory, Playwright, GitHub |

Instalacion

Opcion 1: NPX (Recomendado)

cd ~/tu-proyecto
npx @bryanacuna/claude-starter-kit

Opcion 2: Manual

git clone https://github.com/bryanacuna7/claude-starter-kit.git
cp -r claude-starter-kit/.claude ~/tu-proyecto/
cp claude-starter-kit/{CLAUDE,GUARDRAILS,DECISIONS}.md ~/tu-proyecto/

Despues de instalar

1. Abre el proyecto en VSCode + Claude Code
2. Ejecuta /setup
3. Responde las preguntas (nombre, tech stack, etc.)
4. Reinicia Claude Code para activar MCPs

Auto-Routing de Agentes

No necesitas mencionar agentes. Claude detecta automaticamente cual usar:

Tu: "Agregar autenticacion JWT"
Claude: Using @fullstack-developer + @code-reviewer...

Tu: "El login devuelve error 500"
Claude: Using @debugger...

Tu: "Optimizar queries de la base de datos"
Claude: Using @performance-profiler...

Commands (19)

Configuracion

| Comando | Descripcion | |---------|-------------| | /setup | Wizard inicial. Configura CLAUDE.md con tu proyecto: nombre, tech stack, comandos de dev, reglas criticas. Configura MCPs (Memory, Playwright, GitHub opcional). |

Git & Deploy

| Comando | Descripcion | |---------|-------------| | /commit | Commits inteligentes. Analiza cambios, genera mensaje descriptivo con formato conventional commits, detecta archivos sensibles (.env), ejecuta pre-commit hooks. | | /create-pr | Crear Pull Request. Genera titulo y descripcion basado en commits, incluye checklist de testing, crea PR via GitHub CLI. | | /deploy | Deploy a produccion. Pre-flight checks (tests, build, lint), deploy a preview o production, rollback si falla. |

Desarrollo

| Comando | Descripcion | |---------|-------------| | /create | Crear feature/app. Dialogo interactivo para definir requerimientos, genera estructura de archivos, implementa codigo base. Ejemplo: /create sistema de notificaciones push | | /brainstorm | Explorar opciones. Presenta multiples enfoques para resolver un problema, pros/cons de cada uno, recomienda el mejor. Ejemplo: /brainstorm autenticacion para mobile app | | /plan | Plan de implementacion. Desglosa tarea en pasos, identifica dependencias, estima complejidad, crea checklist. | | /preview | Preview local. Inicia servidor de desarrollo, abre browser, verifica que funciona. | | /enhance | Mejorar codigo. Refactoring, optimizacion, mejoras de legibilidad sin cambiar funcionalidad. |

Testing & Debug

| Comando | Descripcion | |---------|-------------| | /test | Correr tests. Ejecuta test suite, analiza failures, sugiere fixes. Soporta Jest, Vitest, Playwright. | | /generate-tests | Generar tests. Analiza codigo y genera tests unitarios, de integracion, edge cases. Incluye mocks y fixtures. | | /debug | Debug sistematico. Reproduce el error, identifica root cause, propone fix, verifica solucion. Ejemplo: /debug el checkout falla con tarjetas Amex |

Analisis & Review

| Comando | Descripcion | |---------|-------------| | /code-review | Review de calidad. Analiza seguridad, performance, mantenibilidad, accesibilidad. Genera reporte con severidad. | | /explain-code | Explicar codigo. Documenta que hace un archivo/funcion, flujo de datos, dependencias. Util para onboarding. | | /refactor-code | Refactorizar. Mejora estructura sin cambiar comportamiento. Aplica SOLID, DRY, patterns. | | /ultra-think | Analisis profundo. Razonamiento multi-dimensional para problemas complejos. Considera trade-offs, edge cases, long-term. |

Documentacion & Arquitectura

| Comando | Descripcion | |---------|-------------| | /status | Estado del proyecto. Git status, procesos corriendo, health checks, TODOs pendientes. | | /orchestrate | Multi-agent. Coordina multiples agentes para tareas complejas. Ejemplo: /orchestrate migrar de REST a GraphQL | | /create-architecture-documentation | Docs de arquitectura. Genera diagramas, ADRs, guias de componentes, API docs. |

Agentes (11)

| Agente | Especialidad | Cuando se usa | |--------|--------------|---------------| | fullstack-developer | Frontend + Backend | Features, integraciones, CRUD | | test-engineer | Testing | Tests, coverage, QA | | debugger | Errores | Bugs, crashes, logs | | code-reviewer | Calidad | Reviews, seguridad | | performance-profiler | Optimizacion | Slow queries, memory leaks | | architecture-modernizer | Arquitectura | Refactors grandes, migraciones | | documentation-expert | Docs | README, API docs, comments | | ui-ux-designer | Diseno | UI, 50+ estilos, 25 paletas | | product-strategist | Producto | Roadmap, features, prioridades | | prompt-engineer | Prompts | Optimizar prompts para LLMs | | context-manager | Coordinacion | Sesiones largas, multi-file |

Skills (17)

Web Development

| Skill | Contenido | |-------|-----------| | react-patterns | Hooks, state management, performance, custom hooks | | nextjs-best-practices | App Router, Server Components, caching, ISR | | tailwind-patterns | Utilities, responsive, dark mode, animations | | typescript-expert | Generics, utility types, type guards, inference |

Backend

| Skill | Contenido | |-------|-----------| | nodejs-best-practices | Express setup, error handling, logging, security | | python-patterns | FastAPI, Pydantic, SQLAlchemy, async patterns | | api-patterns | REST design, validation, auth, rate limiting | | database-design | Schema design, SQL optimization, Prisma, migrations |

DevOps & Security

| Skill | Contenido | |-------|-----------| | docker-devops | Dockerfiles, Compose, CI/CD, Kubernetes | | security-hardening | OWASP Top 10, JWT, encryption, input validation |

Testing

| Skill | Contenido | |-------|-----------| | testing-patterns | Jest, Vitest, Playwright, mocking, coverage | | webapp-testing | Browser automation, screenshots, E2E |

Mobile & i18n

| Skill | Contenido | |-------|-----------| | mobile-development | React Native, Expo, navigation, performance | | i18n-localization | Next.js i18n, dictionaries, RTL, date formatting |

SEO & Code Quality

| Skill | Contenido | |-------|-----------| | seo-fundamentals | Meta tags, structured data, sitemap, Core Web Vitals | | clean-code | Naming, SOLID, refactoring, code smells | | intelligent-routing | Auto-detect agents basado en tarea |

MCPs

| MCP | Funcion | Configuracion | |-----|---------|---------------| | Memory | Contexto persistente entre sesiones | Incluido por defecto | | Playwright | Browser automation, screenshots, testing | Incluido por defecto | | GitHub | PRs, issues, branches desde Claude | Opcional, requiere token |

Archivos de Configuracion

tu-proyecto/
├── .claude/
│   ├── agents/       # 11 agentes especializados
│   ├── commands/     # 19 workflows
│   └── skills/       # 17 skills de tecnologia
├── .mcp.json         # Config de MCPs
├── CLAUDE.md         # Instrucciones del proyecto
├── GUARDRAILS.md     # Comportamientos fijos
└── DECISIONS.md      # Log de decisiones

CLAUDE.md

Instrucciones especificas de tu proyecto:

## Project Overview
E-commerce de productos artesanales

## Tech Stack
Next.js 14, PostgreSQL, Stripe, Tailwind

## Development Commands
npm run dev    # Desarrollo
npm test       # Tests
npm run build  # Build

## Critical Rules
- TypeScript estricto
- Tests para cada feature
- Code review obligatorio

GUARDRAILS.md

Comportamientos que nunca cambian:

## Baseline Declaration
| Area | Comportamiento |
|------|----------------|
| Auth | JWT con refresh tokens |
| API | Formato { data, error, meta } |
| DB | Soft delete, nunca hard delete |

Ejemplos de Uso

# Crear feature completa
/create sistema de reviews con rating 1-5 estrellas

# Debug especifico
/debug el filtro de precio no funciona en mobile

# Preparar deploy
/deploy preview

# Review antes de merge
/code-review src/components/Checkout.tsx

# Documentar API
/create-architecture-documentation para el modulo de pagos

Verificar Instalacion

npm run validate   # Checklist rapido
npm run compare    # Comparar con otros kits

Troubleshooting

| Problema | Solucion | |----------|----------| | MCP no conecta | Reiniciar VSCode | | Playwright error | npx playwright install | | Agent no detectado | Mencionar @agent explicitamente | | Command no funciona | Verificar que .claude/ existe |

Links

• NPM: https://www.npmjs.com/package/@bryanacuna/claude-starter-kit
• GitHub: https://github.com/bryanacuna7/claude-starter-kit

Licencia

MIT