The Architect: el plano antes de que Claude Code construya

Qué es The Architect: el plano antes de construir

Antes de levantar una casa hace falta un plano: dónde va cada pared, cada puerta, cada cañería. Sin plano, el constructor improvisa. The Architect es ese plano, pero para software. Lo explica así su propio autor, y es una buena imagen.

Le describes tu idea con tus palabras, te hace preguntas y te devuelve un documento con todo lo que Claude Code necesita para construirlo: qué tecnologías usar, cómo encaja cada parte, qué entra en la primera versión y qué queda fuera, y el orden de construcción. Lo importante: no escribe el código de tu app. Diseña, y deja el plano listo para que lo construya otra sesión de Claude Code que no sabe nada de tu conversación. (README del repositorio)

Sirve para proyectos nuevos y también para cambios sobre código que ya existe: con /architect-brownfield primero lee tu repositorio, te muestra lo que entendió para que lo corrijas, y después diseña el cambio sin proponer reescribir lo que funciona.

Cómo funciona y qué te entrega

Son cuatro fases. Tú hablas, él diseña, él escribe:

Los dos controles. Antes de escribir nada, el plano no puede tener decisiones abiertas: cada duda se responde, se acepta una opción por defecto o queda escrita como «esto no se hace». Y pasa un examen de «qué podría matar este proyecto» desde ocho ángulos (premisas falsas, competencia, costos, ejecución…); lo que sobrevive se anota como riesgo.

Lo que recibes es un plano de 20 secciones, todo en archivos de texto, dentro de una carpeta blueprints/ en la carpeta donde estés trabajando. La sección que manda es la 9, el orden de construcción: cada paso trae qué hacer (Do), cuándo está terminado (Done when), un comando para comprobarlo (Verify) y un punto de guardado (Checkpoint). Si el proyecto tiene 12 pasos o más, lo reparte en varios archivos; si tiene 11 o menos, va en uno solo.

Un detalle que conviene saber: la fase 4 tarda, según el autor, de 10 a 15 minutos para un archivo y de 20 a 30 para varios, y no muestra nada mientras trabaja. No está colgado.

Fuente: README de the-architect (secciones «Cómo funciona», «Los dos gates» y «Qué obtienes»).

Cómo instalar The Architect en Claude Code

La forma recomendada es como plugin: así funciona en cualquier carpeta y trae sus comandos. Dentro de una sesión de Claude Code, pega estos dos comandos, uno por vez:

Si prefieres no instalar un plugin, también funciona clonando el repositorio y abriendo Claude Code dentro. Así corre la misma entrevista, pero sin los comandos con barra y los planos quedan dentro de la carpeta clonada:

Fuentes: README de the-architect (Instalación) · Install and manage plugins · Claude Code Docs

¿Modo rápido o completo?

Hay dos puertas de entrada y la diferencia es real. Elige antes de empezar:

Las 3 preguntas del modo rápido son: qué es (en una o dos frases), quién lo va a usar y más o menos cuántos, y qué tecnología tienes que usar o evitar. Si escribes «just build it» o «hazlo ya» en plena entrevista, pasa a este mismo modo rápido. Ojo: sigue haciendo esas 3 preguntas y sigue pidiendo tu visto bueno antes de escribir el plano; la versión anterior prometía cero preguntas.

Además trae cuatro comandos para después:

• /architect-brownfield → diseña un cambio sobre un proyecto que ya existe.
• /architect-next → en un proyecto largo, te dice cuál es el siguiente paso pendiente y cómo comprobarlo.
• /architect-refresh → revisa si las versiones de un plano viejo siguen vigentes.
• /architect-audit → vuelve a pasar el control de calidad a un plano que ya tienes.

Fuentes: README (Elige tu camino · Comandos) · commands/architect-quick.md · CLAUDE.md del repositorio (vía rápida con «just build it» / «hazlo ya»)

Del plano al proyecto

Cuando termina, The Architect te dice la ruta del plano, las tecnologías elegidas, cuántos pasos tiene y el primer comando a correr. Desde ahí:

1. Lee la sección 9 antes que nada. Es el orden de construcción; si un paso no se entiende, pídele que lo aclare ahora, no a mitad del proyecto.
2. Si el plano vino en varios archivos, trae una carpeta workspace/ con la configuración para Claude Code del proyecto nuevo (CLAUDE.md, skills y permisos). Se copia entera a la carpeta del proyecto. Revísala antes (ver «Lo honesto»).
3. Abre una sesión nueva de Claude Code en la carpeta del proyecto, pásale el plano y pídele que construya siguiendo los pasos en orden, corriendo el Verify de cada uno antes de pasar al siguiente.
4. Si el trabajo dura varios días y tienes el plugin, /architect-next retoma donde quedaste: lee la lista de tareas y te dice la siguiente, con su forma de comprobarla.

¿Qué modelo conviene para construir? Depende del tamaño del proyecto; lo explicamos en qué modelo de Claude usar y en los niveles de esfuerzo.

Fuente: README de the-architect (Formato de salida · Comandos).

2 prompts: preparar tu idea y revisar el plano

Son nuestros, no del autor. El primero te ahorra idas y vueltas en la entrevista; el segundo es una segunda opinión antes de dejar a Claude Code construir solo.

Lo que revisamos antes de recomendarlo

Antes de listar un repositorio ajeno lo revisamos: quién lo hizo, si es seguro y si sirve. Lo revisamos el 10-07-2026 y volvimos a hacerlo hoy sobre la versión 2.5.0:

Fuentes: repositorio · SECURITY.md. La revisión es nuestra, sobre el código publicado el 29-09-2026.

Lo honesto