Todo el contenido
Arquitectura IATécnico y arquitectos14 min

Cómo usar Claude Code para crear arquitectura de IA a nivel empresa

Claude Code no es el problema. El problema es la arquitectura. Sin documentación de ingeniería debajo, un proyecto de IA se vuelve inmanejable por muy potente que sea la herramienta.

Suscríbete en YouTube

De qué va

El vibecoding funciona hasta que el proyecto crece. Entonces el código se vuelve inmanejable, nadie recuerda por qué se tomó cada decisión y cada cambio rompe otra cosa. No es culpa de la herramienta: es que no había arquitectura debajo.

En este video desgloso los documentos de ingeniería con los que trabajo antes de escribir el primer prompt: el RFC para definir el problema, el ADR para dejar registrada cada decisión técnica, el PRD para saber qué se construye, el Tech Spec para el stack, el System Design para escalabilidad y seguridad, el Runbook para operar, el Post-Mortem para aprender y el System Prompt Spec para los agentes.

Ese es el salto: de programador de prompts a arquitecto de soluciones. La herramienta la aprende cualquiera. El criterio para ordenarla, no.

Código con Claude CodeLO VISIBLERFC¿Cuál es el problema?ADR¿Por qué se decidió así?PRD¿Qué se construye?Tech Spec¿Con qué stack?System Design¿Escala? ¿Es seguro?Runbook¿Cómo se opera?Sin esta base, el 90% de los proyectos se vuelve inmanejable.
Debajo del código va una pila de decisiones escritas

Lo que te llevas

  • Por qué el 90% de los proyectos con IA falla sin documentación de base.
  • Qué documento resuelve cada pregunta: RFC, ADR, PRD, Tech Spec, System Design, Runbook.
  • Qué es un System Prompt Spec y por qué un agente sin él es impredecible.
  • Cómo estructurar el trabajo con Claude Code para que aguante un entorno corporativo.

Capítulos

  1. 00:00El caos del vibecoding
  2. 01:12Por qué los proyectos de IA fallan sin arquitectura
  3. 02:02RFC: define el problema antes de codear
  4. 03:06ADR: registrar decisiones técnicas para el futuro
  5. 04:27PRD: el documento de QUÉ construir
  6. 05:22Tech Spec: la hoja de ruta del stack
  7. 06:35System Design: escalabilidad y seguridad
  8. 07:41Runbook: operar y gestionar cambios en vivo
  9. 09:17Post-Mortem: la filosofía de aprendizaje
  10. 10:13System Prompt Spec: el estándar para agentes
  11. 11:13El framework de Arquitectura IA
  12. 12:27Ejemplo práctico: un PRD con Mermaid

Sigue por acá

José Andonaire

Sobre el autor

José Andonaire

Ayudo a empresas de Latinoamérica y España a identificar, priorizar e implementar oportunidades de inteligencia artificial que generen resultados reales para el negocio. Lo que publico sale de implementaciones reales, no de teoría.