CONSTRUIR SOFTWARE CON CLAUDE

Construir software en 2026 con Claude como colaborador de ingeniería principal cambia la curva de costos y la estructura del equipo, no el oficio subyacente. Las partes que requieren criterio en software (qué construir, por qué, cómo debe comportarse bajo fallas) siguen requiriendo atención humana. Las partes de ejecución (escribir código, refactorizar, generar código repetitivo, ejecutar migraciones) se comprimen dramáticamente. Saber cuál es cuál es toda la habilidad en 2026.

Esta guía es el flujo que realmente uso para lanzar productos personalizados en Seahawk Media y en proyectos personales como HostList.io, gautamkhorana.com, y Deluxe Astrology. No es un tutorial de Claude, ni un manual de ingeniería de prompts. La disciplina de proceso que produce software implementable con Claude como el ingeniero principal.

Etapa 1: brainstorm estructurado

Antes de escribir cualquier código, realizo una lluvia de ideas estructurada con Claude. El prompt: describe el problema en lenguaje simple, pídele a Claude que identifique cinco preguntas cuyas respuestas cambiarían el diseño, respóndelas, luego pídele que resuma la especificación del producto resultante en 200 palabras. Esta etapa toma entre 30 y 60 minutos y produce una especificación escrita que guía el resto del trabajo.

Etapa 2: decisiones técnicas

Con la especificación en mano, le pido a Claude que identifique las decisiones arquitectónicas que tienen el mayor impacto aguas abajo. Forma de la base de datos, superficie de la API, estrategia de renderizado, modelo de despliegue. Para cada una, Claude propone dos o tres opciones y sus compensaciones. Yo elijo. Las decisiones se escriben en el mismo documento para que la fase de construcción tenga una única fuente de verdad.

Etapa 3: implementación guiada por la especificación

La generación de código es la última etapa, y es la más rápida porque la especificación ya está completa. Claude escribe el esquema, las consultas, los componentes, las rutas, las pruebas, más o menos en ese orden. Reviso cada commit. La mayoría de revisiones revelan un pequeño refactor o un caso extremo faltante; las reescrituras completas son raras cuando la especificación fue clara.

Excelente en

Código nuevo en patrones bien conocidos: APIs REST, paneles admin CRUD, flujos de autenticación, motores de blog, sitios de marketing. Refactorización de código existente donde la forma objetivo está claramente definida. Generación de pruebas para código que tiene entradas y salidas claras. Escritura de scripts de migración cuando la diferencia de esquema es inequívoca. Redacción de documentación. Depuración de código donde el síntoma es reproducible y el seguimiento está en contexto.

Menos excelente en

Decisiones arquitectónicas en dominios desconocidos. Código de integración donde la API de terceros está mal documentada o ha cambiado recientemente. Optimización de rendimiento donde el cuello de botella no es obvio. Generación de código en lenguajes o frameworks obscuros donde los datos de entrenamiento son escasos. Cualquier cosa donde los requisitos son ambiguos y el LLM completa con valores por defecto plausibles pero incorrectos para tu caso específico.

La brecha de juicio

Claude es consistentemente mejor que el ingeniero promedio escribiendo la siguiente línea de código. Claude es consistentemente peor que un ingeniero senior decidiendo si la siguiente línea de código debe existir. La capa de juicio senior es lo que tú aportas. La velocidad de ejecución es lo que Claude aporta. La combinación supera a cualquiera por separado.

Claude Code como interfaz principal

Claude Code es el IDE para desarrollo asistido por IA. Contexto del proyecto cargado una vez, acceso a terminal, acceso al sistema de archivos, integración de herramientas MCP. La herramienta de mayor apalancamiento que agregué a mi stack en 2025. La mayoría del trabajo de ingeniería ahora ocurre en Claude Code en lugar de directamente en VS Code o Cursor.

Cursor para ediciones directas en el editor

Cursor sigue siendo la mejor experiencia de editor para trabajar junto a IA en un archivo único. Completación de pestañas, ediciones en línea, diff lado a lado. Uso Cursor cuando el trabajo se concentra en uno o dos archivos; cambio a Claude Code cuando el trabajo abarca todo el proyecto.

Claude Sonnet vía API para trabajo en lotes

Cuando necesito generar o reescribir cientos de páginas programáticamente (el pipeline de blog automático, humanización de contenido, generación de esquemas), llamo a la API de Claude directamente vía Sonnet. Menor latencia que la interfaz de chat, costo predecible, scriptable. La herramienta adecuada para pipelines de contenido específicamente.

OpenAI GPT-4o para ingeniería de prompts

Mi descubrimiento a finales de 2025 fue que los prompts para Kimi, Minimax, o cualquier otro agente se escriben mejor con Claude o GPT, no a mano. Describo el objetivo, le pido a GPT-4o que escriba el prompt, y luego ejecuto ese prompt contra el ejecutor. La calidad del resultado es materialmente mejor que los equivalentes escritos a mano.

Kimi Researcher y Minimax Agent

Investigación profunda y mockups de diseño de aplicación completa respectivamente. El post /blog/kimi-minimax-deep-research-design-mockups/ cubre el flujo de trabajo completo. Ambas son herramientas críticas en Seahawk para investigación de clientes y prototipado rápido.

Commits pequeños, mensajes descriptivos

El desarrollo asistido por IA tiende a producir diffs grandes porque es fácil enviar 800 líneas de código generado en un commit. Disciplínate para hacer commits más pequeños. Un mensaje de commit que diga qué cambió y por qué es el único artefacto que tu yo futuro tendrá para debuggear una regresión. Hazlo legible.

Tests como contrato

Claude puede escribir código que compila y corre pero viola silenciosamente una restricción que era implícita en la especificación. Los tests que codifican esas restricciones como contratos ejecutables detectan las violaciones. La disciplina de test-first importa más en la era asistida por IA que cuando los humanos escribían cada línea.

Revisión de código solo para humanos por ahora

No le permito a Claude aprobar sus propios pull requests. La puerta de revisión es el control de calidad más importante que queda para los humanos, y externalizar eso al mismo modelo que escribió el código anula el propósito. El SDK de Anthropic y los flujos de Claude Code hacen fácil la revisión asistida por IA, pero la aprobación final es mía.

Dependencias versionadas y archivos de bloqueo

Fija cada dependencia. Usa archivos de bloqueo. Ejecuta npm audit en cada compilación. La superficie de ataque de la cadena de suministro es real y el desarrollo asistido por IA tiende a agregar más dependencias que los equivalentes escritos por humanos porque agregar un paquete es rápido. La disciplina de archivos de bloqueo mantiene la superficie auditable.

Cinco categorías de decisión donde Claude es la herramienta incorrecta:

Qué construir en absoluto. La decisión de producto es pesada en juicio, depende del contexto del usuario que Claude no tiene, y es la decisión más consecuente en cualquier producto. Los fundadores y PMs son dueños de esto; la IA asiste como máximo.

Qué lanzar y qué cortar. Las decisiones de alcance durante una compilación siempre se reducen a restricciones que el modelo no ve. Presión de tiempo, moral del equipo, relaciones con socios, posicionamiento de marketing. Decide como humano, documenta el razonamiento, luego pídele a Claude que ejecute el alcance decidido.

Diseño de modo de fallo. Cómo debe comportarse el sistema cuando las cosas salen mal rara vez se especifica por adelantado y es donde origina la mayoría de los incidentes de producción. Dedica tiempo desproporcionado a los modos de fallo; no emergerán naturalmente de la generación de código de ruta feliz.

La capa de ética. Lo que construyes tiene implicaciones. Privacidad, residencia de datos, accesibilidad, costo ambiental. Estas son decisiones humanas, no resultados de optimización. Haz la pregunta explícitamente en el momento del diseño.

Mantenibilidad a largo plazo. Tu futuro yo leyendo a Claude futuro leyendo el código de Claude presente es la versión más profunda de deuda técnica. Optimiza el código presente para ser legible por humanos primero, IA segundo.

Ejemplos concretos de los últimos doce meses en Seahawk y personalmente:

HostList.io (28,000 páginas programáticas en Next.js + Supabase): scaffolded con Claude Code en cinco días, pipeline de contenido escrito por Claude con integración de investigación Tavily, generación de hero vía FAL, schema markup auto-generado. El tiempo de ingeniería total fue aproximadamente un tercio de lo que habría estimado hace tres años.

gautamkhorana.com (este sitio, en Astro + Supabase): reconstruido en un fin de semana de 24 horas con Claude Code como colaborador principal. Surface del editor de sitios, sistema de blog, capa de schema, i18n, todo generado, revisado, refactorizado. El costo de construir un sitio personal de esta calidad bajó a un fin de semana de trabajo enfocado.

Pipeline auto-blog y traducción de Deluxe Astrology: el loop de Tavily-research-a-Claude-draft-a-Winston-check-a-FAL-hero-a-Supabase-publish se ejecuta diariamente en 30 idiomas en 91,000+ páginas. El pipeline mismo tiene aproximadamente 800 líneas de código que Claude escribió en cerca de 12 horas de trabajo enfocado, gran parte de lo cual habría tomado una semana con un equipo solo humano.

Dashboards admin internos en Seahawk: Minimax Agent genera el primer prototipo a partir de una descripción de seis líneas, Claude lo refina, el resultado es deployable en una hora. El tiempo desde "necesitamos una herramienta interna" hasta "estamos usando la herramienta interna" bajó de días a menos de un día de trabajo.

Construir software personalizado en 2026 es un oficio que se ha comprimido en un orden de magnitud en velocidad de ejecución y se ha mantenido aproximadamente constante en complejidad de juicio. Los equipos que se adaptan son los que aportan más juicio (mejores specs, mejores decisiones arquitectónicas, mejor diseño de modos de fallo) y externalizan más ejecución a IA. Los equipos que no se adaptan producen software a velocidad competitiva pero pierden en calidad, o viceversa.

No necesitas usar cada herramienta en esta guía. Necesitas saber cuáles decisiones son tuyas y cuáles pueden ser delegadas. La habilidad es el límite, no el conjunto de herramientas.

Si quieres ayuda para entregar un proyecto de software personalizado a esta curva de costo, ejecutamos product builds en Seahawk Media. La conversación es gratis; los precios del proyecto reflejan la realidad de costo asistido por IA, no la realidad de costo horario de 2018.