Tu Hoja de Ruta de 90 Días: De Developer a ATLAS Architect

El Problema

Ocho artículos. Dos frameworks. Seis proyectos prácticos.

Has aprendido ATLAS y GOTCHA. Los has visto aplicados a una API de usuarios, un servicio de notificaciones, un pipeline de CI/CD. Has leído los anti-gotchas. Tienes 20 plantillas de prompts.

Pero saber y hacer son cosas diferentes. Leer sobre natación no te convierte en nadador. Los frameworks solo funcionan si los usas — de forma constante, en proyectos reales, bajo presión real.

El problema con la mayoría de técnicas que aprendes de artículos es que las pruebas una vez, funcionan razonablemente bien, y luego las olvidas. Dos semanas después vuelves a escribir prompts de una línea porque en el momento es más rápido.

ATLAS + GOTCHA tiene que convertirse en un hábito. No una técnica que recuerdas usar — una forma de trabajar en la que ya no tienes que pensar. Las 5 preguntas de ATLAS se vuelven automáticas. Las 6 capas de GOTCHA se convierten en el formato por defecto para cada prompt.

Este artículo te da un plan concreto para conseguirlo en 90 días.

La Solución

Una autoevaluación, una hoja de ruta de 90 días y una imagen clara de cómo se ve un “ATLAS Architect” en la práctica.

Autoevaluación: ¿Dónde Estás Ahora?

Responde con honestidad. No hay respuestas incorrectas — esto es un punto de partida, no una nota.

Level 0 — Sin estructura

Escribes prompts de IA como párrafos sueltos
Obtienes resultados inconsistentes y pasas tiempo arreglando el código generado
Casi nunca piensas en arquitectura antes de ponerte a programar
Has leído sobre ATLAS + GOTCHA pero no los has usado en un proyecto real

Level 1 — Consciente

Conoces las fases de ATLAS y las capas de GOTCHA por nombre
Has probado los frameworks en una o dos tareas
A veces te saltas fases porque “es obvio” o “es muy pequeño”
Tus prompts GOTCHA están incompletos — normalmente les falta Context o Args

Level 2 — Practicando

Usas ATLAS + GOTCHA en la mayoría de tareas importantes
Tienes las plantillas abiertas en una pestaña mientras trabajas
Detectas errores de la IA durante el paso de revisión (la parte de “lo que ajustamos”)
Todavía te cuesta con Trace y Link — las fases de integración

Level 3 — Fluido

Las preguntas de ATLAS son automáticas: las piensas antes de tocar cualquier herramienta
Escribes prompts GOTCHA en 5–10 minutos sin necesitar la plantilla
Reconoces a qué anti-gotchas eres más propenso y te proteges contra ellos
Has adaptado los frameworks al stack y convenciones de tu equipo

Level 4 — Architect

Usas ATLAS para diseñar sistemas, no solo servicios individuales
Enseñas a compañeros de equipo sobre prompts GOTCHA
Mantienes una librería de prompts específica del proyecto
Detectas la diferencia entre “lo que generó la IA” y “lo que necesita el sistema” de inmediato
Sabes cuándo NO usar IA — cuando la tarea necesita juicio humano, no generación de código

La mayoría de developers leyendo esta serie están en Level 1 o Level 2. El plan de 90 días está diseñado para llevarte a Level 3. El Level 4 llega con práctica durante meses.

La Hoja de Ruta de 90 Días

Mes 1: Construir el Hábito

Objetivo: Usar ATLAS + GOTCHA en cada tarea de IA, incluso las pequeñas. La velocidad no importa todavía — lo que importa es completarlo.

Semana 1–2:

Imprime el checklist de ATLAS y la plantilla de GOTCHA. Ponlos al lado de tu pantalla.
Para cada tarea de IA esta semana, completa al menos 3 fases de ATLAS antes de hacer el prompt.
No te saltes Trace y Link. Son las fases que vas a querer saltarte.

Semana 3–4:

Empieza a llevar un registro de prompts. Cuando escribas un prompt GOTCHA, guárdalo. Anota qué acertó la IA y qué falló.
Después de cada tarea de IA, haz la revisión de 6 capas: Goals ✓, Orchestration ✓, Tools ✓, Context ✓, Heuristics ✓, Args ✓.
Identifica qué anti-gotcha te ocurre más a menudo. Escríbelo en un post-it.

Objetivo del fin del Mes 1: Has usado ATLAS + GOTCHA en al menos 10 tareas. Sabes qué fases te saltas por defecto. Tienes un registro de prompts creciendo.

Mes 2: Aplicar a un Proyecto Real

Objetivo: Ejecutar ATLAS en una feature o servicio completo, de principio a fin.

Semana 5–6:

Elige un proyecto real — una nueva feature, un servicio que estás refactorizando, una nueva API. No un proyecto de juguete.
Rellena el checklist completo de ATLAS. Las cinco fases. Para un proyecto real esto toma 30–45 minutos.
Escribe el prompt GOTCHA. Las seis capas. Guárdalo en tu repositorio.

Semana 7–8:

Usa el prompt. Construye la feature con asistencia de IA.
Documenta qué generó la IA, qué ajustaste y por qué.
Actualiza el prompt GOTCHA para reflejar lo que cambiaste (el prompt ajustado ahora es mejor que el original).

Objetivo del fin del Mes 2: Tienes un documento ATLAS completo y un prompt GOTCHA refinado para un proyecto real. Conoces la diferencia entre un prompt de primer borrador y un prompt de producción.

Mes 3: Escalar y Compartir

Objetivo: Aplicar los frameworks a un proyecto multi-servicio. Enseñar a alguien más.

Semana 9–10:

Diseña un sistema con 2–3 servicios usando ATLAS. Un documento ATLAS para el sistema, un prompt GOTCHA por servicio.
Construye el mapa de integración (fase Link) con cuidado. Aquí es donde los diseños multi-servicio se rompen.
Presta atención a cómo cambia el Context de GOTCHA entre servicios — cada uno tiene dependencias diferentes.

Semana 11–12:

Enseña los frameworks a una persona de tu equipo. No necesitas ser un experto. Muéstrales ATLAS, muéstrales GOTCHA, haced una tarea juntos.
Enseñar te obliga a expresar lo que sabes. Las preguntas que no puedes responder con claridad son las lagunas que todavía tienes que rellenar.
Revisa la lista de anti-gotchas con ellos. Pregunta cuáles reconocen de su propia experiencia.

Objetivo del fin del Mes 3: Estás en Level 3. Los frameworks son un hábito, no una técnica. Los has aplicado a un sistema multi-servicio. Los has compartido con al menos una persona.

Lo Que Viene Después

ATLAS + GOTCHA son frameworks para pensar. Se aplican más allá de prompts de IA.

Revisiones de diseño de sistemas. Usa ATLAS como checklist de revisión. Cuando un compañero presenta una arquitectura, pásala mentalmente por las cinco fases: ¿Están definidos los límites? ¿Está documentado el flujo de datos? ¿Están mapeadas las integraciones? ¿Hay un plan de construcción? ¿Hay un plan de validación?

Entrevistas técnicas. Las preguntas de arquitectura en entrevistas siguen exactamente la estructura ATLAS. “Diseña un sistema de notificaciones” — eso es ATLAS. Define límites, traza el flujo, mapea las integraciones, decide el orden de construcción, valida bajo carga.

Revisiones de incidentes. La mayoría de incidentes en producción se remontan a un hueco en una de las cinco fases de ATLAS. Una dependencia circular que nadie trazó. Una integración sin modo de fallo definido. Un escenario de carga que nunca se probó bajo estrés. ATLAS también es un framework para post-mortems.

Escribir specs técnicos. Un buen spec técnico responde las mismas cinco preguntas que hace ATLAS. Úsalo como esquema: problema (Architect), flujo de datos (Trace), integraciones (Link), plan de implementación (Assemble), criterios de aceptación (Stress-test).

La Siguiente Serie

Esta serie cubrió los fundamentos: por qué fallan los prompts de IA, cómo ATLAS estructura tu pensamiento, cómo GOTCHA estructura las instrucciones para la IA, y cómo aplicar ambos a proyectos reales.

La siguiente serie es AI-Driven Cloud DevSecOps. Aprenderás a usar Claude CLI como interfaz conversacional para toda tu infraestructura — Terraform, Kubernetes, pipelines de CI/CD, escaneo de seguridad — todo a través de diálogo en vez de cambiar de pestaña. El mismo enfoque: pensamiento estructurado antes que herramientas, código real, honestidad sobre qué funciona y qué no. Y sí, ATLAS + GOTCHA estarán ahí también — como la capa de gobernanza para lo que la IA puede y no puede hacer.

Si quieres que te avise cuando empiece esa serie, suscríbete abajo.

Template

La referencia rápida completa de ATLAS + GOTCHA. Imprímela. Tenla contigo.

═══════════════════════════════
ATLAS — THINK BEFORE YOU PROMPT
═══════════════════════════════

[A] ARCHITECT
  What am I building? What are the boundaries?
  Who uses it? What are the constraints?
  What is explicitly OUT OF SCOPE?

[T] TRACE
  Follow one request from start to finish.
  Every step is a decision point.

[L] LINK
  How do components talk to each other?
  What's the protocol? The contract?
  What happens when a dependency fails?

[A] ASSEMBLE
  What gets built first? In what order?
  What depends on what?

[S] STRESS-TEST
  How do I know it works?
  Load scenario. Failure scenario. Data integrity scenario.

═══════════════════════════════════
GOTCHA — PROMPT FOR THE AI
═══════════════════════════════════

=== GOALS (from Architect) ===
What must the AI achieve? Measurable outcomes.

=== ORCHESTRATION (from Trace + Assemble) ===
What gets built first? What depends on what?

=== TOOLS (from Link — technology names) ===
Frameworks, libraries, APIs. Specific versions.

=== CONTEXT (from Link + Trace — environment) ===
Your system. Your conventions. Your constraints.

=== HEURISTICS (from Assemble — rules) ===
DO:
DON'T:

=== ARGS (from Stress-test — concrete values) ===
Numbers, names, connection strings, limits.

═══════════════════════════════
THE MAPPING
═══════════════════════════════

Architect → Goals
Trace     → Orchestration
Link      → Tools + Context
Assemble  → Heuristics
Stress    → Args

Prueba de Que Funciona: ScraperAgent

Todo en esta serie viene de trabajo real. Y la mejor prueba es un proyecto real construido con ATLAS + GOTCHA desde el día uno.

ScraperAgent es una plataforma de inteligencia de mercado con IA que construí usando exactamente el workflow descrito en estos artículos. Hace scraping de cuentas expertas de Twitter/X de mercados financieros y crypto, ejecuta análisis de sentimiento a través de Azure OpenAI, y entrega informes diarios estructurados a suscriptores por email.

El stack técnico es exactamente lo que has visto en esta serie: ASP.NET Minimal API, Channel<T> + BackgroundService para jobs asíncronos, Entity Framework Core con PostgreSQL, Next.js frontend, QuantumID para autenticación, y Kubernetes en Scaleway Kapsule para deployment. La carpeta goals/ en el repo contiene los documentos ATLAS reales y los prompts GOTCHA usados para construir cada feature — no versiones limpiadas para el artículo, los reales.

Lo que lo hace un buen ejemplo es que no es un proyecto de juguete. Gestiona suscripciones con pagos de Mollie, tiene un cron scheduler para ejecuciones de análisis automatizadas, y almacena informes como JSONB en PostgreSQL. Cada componente fue diseñado con ATLAS y generado con GOTCHA. Los ajustes hechos después de la generación con IA — el paso de “lo que ajustamos” de los Artículos 5 y 6 — son visibles en el historial de commits.

Si quieres ver cómo se ve ATLAS + GOTCHA aplicado a un producto real, no solo a una API de tutorial, explora el repo. Haz fork, lee los prompts, e intenta extenderlo con tu propio prompt GOTCHA.

Palabras Finales

Cuando empecé a usar IA para desarrollo, mis prompts eran tan vagos como los de cualquiera. “Crea una API para gestión de usuarios.” “Añade autenticación.” “Escribe un pipeline.”

Los resultados eran frustrantes. No porque la IA fuera mala — porque yo no había hecho mis deberes. Estaba pidiendo resultados deterministas a un sistema probabilístico, sin darle suficiente información para reducir el espacio de probabilidades.

ATLAS son los deberes. GOTCHA es el formato. Juntos, no eliminan la naturaleza probabilística de los modelos de IA — nada lo hace. Pero reducen drásticamente el espacio de respuestas posibles al ser precisos sobre lo que necesitas.

Soy un cloud architect trabajando con Azure, Kubernetes y sistemas distribuidos. Estos frameworks vienen de experiencia real — de la frustración de obtener respuestas erróneas y la satisfacción de obtener las correctas. Funcionan en el tipo de proyectos en los que trabajo cada día: plataformas multi-servicio, deployments enterprise, entornos regulados.

Van a funcionar en los tuyos también. Empieza con el checklist. Rellena las cinco fases, incluso cuando parezca obvio. Escribe el prompt en seis capas, incluso cuando parezca trabajo extra. Revisa el output contra el prompt, incluso cuando el código parezca correcto.

Hazlo diez veces. Entonces empieza a sentirse natural. Hazlo treinta veces. Entonces es un hábito. Hazlo cien veces. Entonces eres un ATLAS Architect.

Nos vemos en la siguiente serie.

Victor

Si esta serie te ha ayudado, considera invitarme a un café.