The Architect

Que es esto

Antes de construir una casa, necesitas un plano. Sin el, los constructores no saben que hacer.

The Architect hace eso para software.

Abris el proyecto en Claude Code, le decis que queres construir, y el agente:

1. Te hace preguntas inteligentes sobre tu idea
2. Diseña todo el sistema — base de datos, API, frontend, auth, pagos, todo
3. Genera un archivo blueprint tan detallado que otra instancia de Claude Code puede construir el proyecto entero sin hacerte una sola pregunta

Vos: "Quiero construir una app de gestion de proyectos como Trello"
         ↓
The Architect: hace preguntas, diseña todo
         ↓
Blueprint.md: stack completo, schema de base de datos,
              rutas API, jerarquia de componentes, orden de construccion...
         ↓
Claude Code: lee el blueprint → construye toda la app

git clone https://github.com/benjaminromero5631/the-architect.git
cd the-architect
claude

---

Para que sirve

Construir proyectos reales sin improvisar

Sin The Architect, Claude Code empieza a construir sin entender bien el sistema completo — y terminas en medio de una arquitectura que no escala. Con el blueprint, el agente sabe exactamente que construir y en que orden.

Separar el diseño de la ejecucion

Pensar la arquitectura y escribir codigo al mismo tiempo es el origen de la mayoria de los problemas. The Architect los separa: primero el plano, despues la construccion.

Iterar antes de escribir codigo

Cambiar una decision arquitectonica en el blueprint cuesta segundos. Cambiarla cuando ya tenes 3.000 lineas de codigo cuesta dias.

---

Como funciona

The Architect sigue 4 fases:

Fase 1: Descubrimiento

Hace 2-3 preguntas para entender tu idea y clasifica el proyecto en uno de 6 arquetipos (SaaS, landing page, app movil, API, herramienta interna, plataforma de contenido).

Fase 2: Profundizacion

Hace preguntas especificas para tu tipo de proyecto. Necesitas cuentas de usuario? Pagos? Funciones en tiempo real? Tambien investiga mejores practicas con /deep-research.

Fase 3: Arquitectura

Presenta el tech stack completo con razon para cada decision. Vos confirmas o ajustas. Para proyectos con frontend, diseña el sistema visual completo (colores, fuentes, espaciado) con /ui-ux-pro-max.

Fase 4: Generacion

Produce el blueprint final en output/<nombre-proyecto>-blueprint.md.

---

El blueprint: 16 secciones

#	Seccion	Contenido
1	Vision del Proyecto	Objetivos y metricas de exito
2	Tech Stack	Cada tecnologia con su razon
3	Estructura de Directorios	Arbol completo de archivos
4	Modelo de Datos	Entidades, relaciones, schema SQL
5	Diseño de API	Rutas, endpoints, request/response
6	Arquitectura Frontend	Paginas, componentes, estado
7	Sistema de Diseño	Colores, fuentes, espaciado
8	Auth y Autorizacion	Flujo de login, roles, permisos
9	Orden de Construccion	Que construir primero, segundo, tercero
10	Setup del Entorno	Variables de entorno, comandos iniciales
11	Dependencias	Cada paquete con su proposito
12	Despliegue	Hosting, CI/CD, dominios
13	Testing	Que testear, que herramientas, cuando
14	Skills a Usar	Skills de Claude Code para el build
15	CLAUDE.md	Instrucciones listas para pegar en el proyecto nuevo
16	Reglas	Restricciones no negociables para el build

La seccion 9 (Orden de Construccion) es la mas importante. Le dice a Claude Code exactamente que construir y en que orden para que trabaje de forma autonoma.

---

Tipos de proyecto soportados

Tipo	Ejemplos	Stack por defecto
SaaS / Web App	Trello, Notion, Slack	Next.js + Supabase + Clerk + Stripe + Vercel
Sitio de Marketing	Landing pages, portfolios	Astro + Tailwind + Sanity + Vercel
App Movil	iOS/Android	Expo (React Native) + Supabase + NativeWind
API / Backend	REST APIs, microservicios	Hono + Drizzle + PostgreSQL + Railway
Herramienta Interna	Admin panels, dashboards	Next.js + shadcn/ui + Prisma + Recharts
Plataforma de Contenido	Blogs, docs, CMS	Next.js + Sanity + Algolia + Vercel

---

Uso rapido

Paso 1: Decile que queres construir

Quiero construir un SaaS para manejar reservaciones de restaurante
con cuentas de equipo, pagos con Stripe y pagina de reservas para clientes.

Paso 2: Responde las preguntas (2-3 a la vez, conversacional).

Paso 3: Revisa la arquitectura. Confirma o ajusta.

Paso 4: The Architect genera el blueprint en output/.

Paso 5: Usa el blueprint para construir

mkdir ~/mi-proyecto
cp output/mi-proyecto-blueprint.md ~/mi-proyecto/CLAUDE.md
cd ~/mi-proyecto
claude

Modo rapido

No queres responder muchas preguntas? Deci:

Hazme un SaaS para reservaciones de restaurante. Solo construyelo.

The Architect hace 3 preguntas esenciales y usa defaults inteligentes para todo lo demas.

---

Descarga el proyecto

# Opcion 1 — clonar desde GitHub
git clone https://github.com/benjaminromero5631/the-architect.git

# Opcion 2 — descargar el ZIP desde esta pagina

Abris la carpeta en Claude Code y el agente toma el control.