Claude Code — Agente IA de Desarrollo

# Instalar Claude Code globalmente npm install -g @anthropic-ai/claude-code # Verificar instalación claude --version # Abrir en el repo de GrowBot cd ~/projects/growbot-app claude # Claude lee CLAUDE.md automáticamente y # entra en modo conversacional interactivo.

CLAUDE.md # GrowBot — Marketing Automation SaaS ## Stack - Next.js 14 App Router, TypeScript strict - Prisma ORM + PostgreSQL (dev: localhost:5432/growbot_dev) - Resend para transaccional de email - Stripe Billing (suscripciones + metered usage) - Vitest + Testing Library + Playwright E2E ## Comandos esenciales - pnpm dev — servidor en puerto 3000 - pnpm test:unit — Vitest modo watch - pnpm test:e2e — Playwright headless - pnpm typecheck — tsc --noEmit - pnpm db:migrate — Prisma migrate dev - pnpm db:studio — Prisma Studio UI ## Convenciones de código - Result<T,E> para errores de dominio, NUNCA throw - Zod en todos los endpoints de API (src/schemas/) - Logging estructurado con Pino (NO console.log) - Feature flags via src/lib/flags.ts - Consultas DB exclusivamente por Prisma client ## Antes de modificar código 1. Leer el archivo de test del módulo afectado 2. Ejecutar los tests existentes del módulo 3. Después de cambios: pnpm typecheck && pnpm test:unit ## Reglas absolutas - NO añadir dependencias sin preguntar al usuario - NO modificar schema Prisma sin crear migración - NO cambiar lógica de auth sin aprobación explícita - NUNCA commitear directamente en main → crear branch + PR

src/billing/CLAUDE.md # Módulo Billing — Stripe Stripe es el proveedor de pagos. Todas las llamadas a la API de Stripe pasan por src/lib/stripe/client.ts que envuelve el SDK con reintentos y manejo de errores. ## Webhooks — Idempotencia obligatoria Cada handler de webhook DEBE verificar la clave de idempotencia antes de procesar. Stripe puede reenviar el mismo evento múltiples veces. Los IDs de eventos procesados se guardan en la tabla stripe_events (Prisma model StripeEvent). ## Tarjetas de prueba - 4242 4242 4242 4242 — pago exitoso - 4000 0000 0000 0002 — tarjeta rechazada - 4000 0000 0000 9995 — fondos insuficientes ## Tests de billing Siempre usar pnpm test:unit src/billing y verificar que el test de idempotencia pase.

~/.claude/mcp.json { "mcpServers": { "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_TOKEN": "ghp_xxxx" } }, "sentry": { "command": "npx", "args": ["-y", "@sentry/mcp-server"], "env": { "SENTRY_AUTH_TOKEN": "sntryu_xxxx", "SENTRY_ORG": "growbot-sas" } } } }

.mcp.json { "mcpServers": { "database": { "command": "npx", "args": [ "tsx", "mcp-servers/database/index.ts" ], "env": { "DATABASE_URL": "postgresql://localhost:5432/growbot_dev" } } } } # Añadir a .gitignore si tiene credenciales # echo ".mcp.json" >> .gitignore