Saltar al contenido
Gabriel Neuman

Claude Code

Mis Insights con Claude Code

46 sesiones, 376 mensajes, 66 horas reales con Claude Code: qué funciona, qué falla y cómo lo estoy mejorando operando mi marca con Claudia.

Transparencia total · Feb–Mar 2026

63 sesiones. 376 mensajes. 66 horas de trabajo real con IA. Esto es lo que aprendí — con los errores incluidos.

  • 63 sesiones totales
  • 46 sesiones analizadas
  • 376 mensajes
  • 66h de trabajo
  • 15 commits

Dónde trabajé: 5 áreas de proyecto

Trabajo en múltiples proyectos simultáneamente — cada uno con su stack y sus desafíos propios.

🏗️ WordPress SEO & Migración Next.js (10 sesiones)

Auditorías E-E-A-T, corrección de H1s y meta descriptions, schemas, sitemaps y migración headless. El área más activa.

🚀 Startup/VC Platform (Airtable + Next.js) (8 sesiones)

Plataforma de gestión de startups con auth multi-rol, contactos, rondas y formularios. Los field names de Airtable fueron el mayor punto de fricción.

🏘️ 4Cuadrante Real Estate (Nuxt/Vue) (8 sesiones)

pSEO, modales, búsqueda de propiedades, detección de duplicados y limpieza de datos. Claude editó el proyecto equivocado en más de una ocasión.

🎓 Plataforma Educativa & Sales Site (5 sesiones)

Academia con Stripe, auth y página de membresía para davidergas.com. Compatibilidad con Edge Runtime y refinamientos de UI requirieron muchas iteraciones.

⚙️ Content Pipeline & Marketing Automation (5 sesiones)

Pipeline YouTube → NotebookLM → sitio web, sistema de cotizaciones en YAML/Markdown y configuración del asistente de marketing con skills y slash commands.

Lo que realmente funciona: 3 workflows impresionantes

Donde Claude Code entrega valor real y consistente en mi flujo de trabajo.

🔍 SEO y Schema a escala

Auditorías E-E-A-T completas, corrección masiva desde CSVs, implementación de structured data y optimización de sitemaps. Un flujo repetible entre proyectos.

🏗️ Plataformas multi-archivo

29 cambios multi-archivo exitosos. Construí plataformas completas iterativamente: academia con Stripe, cotizaciones en YAML, app con roles y Airtable.

🎬 Pipeline de contenido automatizado

Diseñé un pipeline YouTube → NotebookLM → sitio web con slash commands reutilizables. Pensamiento creativo aplicado más allá del código.

Dónde pierdo tiempo: 3 fuentes de fricción

Sin filtros. Esto es lo que me costó sesiones completas — y cómo lo estoy resolviendo.

🎯 #1 Proyecto equivocado

Claude confundió qué proyecto editar en al menos 3 sesiones completas, desperdiciando horas de trabajo.

Ejemplo real: Editó davidergas en lugar de 4Cuadrante. Confundió colectivo23 como target cuando explícitamente dije que no tenía nada que ver.

🐛 #2 Código con bugs que acumula bugs

Las implementaciones iniciales frecuentemente introducían nuevos bugs — imports faltantes, variables mal ubicadas — generando ciclos de corrección interminables.

Ejemplo real: Al corregir field names de Airtable, cada fix introducía un nuevo error. La sesión terminó en el límite sin resolver todo.

📦 #3 Sesiones sobrecargadas

Poner demasiadas metas en una sola sesión significa que Claude llega al límite de contexto antes de terminar, dejando features a medias.

Ejemplo real: Stripe + UI + bugs + páginas nuevas en una sola sesión. El middleware de limpieza de datos se rompió al agregar MongoDB + Sheet writeback simultáneamente.

Mejoras que estoy implementando: adiciones a CLAUDE.md

El archivo CLAUDE.md le da contexto permanente a Claude Code. Estas reglas me ahorran sesiones enteras.

Identificación de proyecto

Por qué: 3 sesiones completas destruidas por editar el proyecto incorrecto.

## Project Identification
Antes de cualquier cambio, confirmar el directorio correcto.
Lista de proyectos activos: 4Cuadrante (Nuxt), davidergas.com (Next.js),
importador-4C, colectivo23. SIEMPRE verificar antes de editar.

Cambios incrementales

Por qué: Al menos 2 sesiones se rompieron por combinar demasiados cambios.

## Incremental Changes
Hacer cambios de a uno y verificar antes de continuar.
NO agregar múltiples features simultáneamente.
Completar y verificar uno antes del siguiente.

Airtable — leer antes de escribir

Por qué: Múltiples sesiones destruidas por field names incorrectos.

## Airtable Integration
Siempre leer los field names reales del schema.
Son case-sensitive. NUNCA adivinar — verificar primero
con la API de metadata o el código existente.

Próximos pasos: en el horizonte

Workflows más autónomos que ya estoy explorando con Claudia y en el programa.

🧪 Bug fixing con tests primero

Claude escribe el test que falla primero, luego itera hasta que pasa. Elimina los ciclos de back-and-forth donde cada fix introduce un nuevo bug.

Prompt de arranque:

Antes de escribir el fix: 1) Lee los archivos relevantes. 2) Escribe un test que reproduce el bug. 3) Confirma que falla. 4) Implementa el fix mínimo. 5) Confirma que pasa. 6) Corre el suite completo.

🤝 Agentes paralelos por feature

En lugar de meter Stripe + UI + bugs en una sesión, cada feature corre en su propio agente sobre una branch separada. Se mergea al final.

Prompt de arranque:

Planifica estas features como tareas independientes sin solapamiento de archivos. Define la branch, los archivos que toca cada una y un test de aceptación simple.

📋 CLAUDE.md por proyecto

Un CLAUDE.md en cada proyecto con estructura, stack, field names de Airtable y targets de deploy. Claude lo lee automáticamente al iniciar la sesión.

Prompt de arranque:

Escanea el codebase y genera un CLAUDE.md que incluya: propósito, stack, estructura de directorios, integraciones API con field names, variables de entorno, comandos de deploy y gotchas comunes.

Claudia opera este sitio en tiempo real

Esto ya está en producción.

Todo lo que aprendí en estas 66 horas está aplicado en Claudia — mi primera empleada de IA. Gestiona SEO, contenido, WordPress y el frontend. No pide vacaciones.

Newsletter · El CEO agéntico

Una táctica de IA cada viernes.

Una táctica que puedes aplicar, una herramienta real y un caso concreto de negocio.