Ir al contenido
Entender el sistema

¿Qué tiene usted realmente?

Un producto construido deprisa con agentes de código con IA casi nunca está documentado y a menudo nadie lo entiende del todo, incluida la persona que lo hizo aparecer a base de prompts. Empezamos por aquí.

Qué incluye

Llegar a una descripción en la que confiar

Un inventario de lo que se ejecuta

Servicios, trabajos en segundo plano, tareas programadas, dependencias externas y lo que nadie recuerda haber desplegado.

Una descripción de la arquitectura

Cómo se relacionan las partes, dónde viven los datos, qué habla con qué y cuáles de esas conexiones sostienen el edificio.

Cómo se despliega

Dónde se ejecuta, cómo llega un cambio a producción y qué pasa hoy cuando algo falla.

Dónde es frágil

Las partes cuyo fallo dolería más, nombradas antes de que fallen y no después.

Cómo va

De «no estoy seguro» a una descripción sobre papel

  1. Usted cuenta lo que cree que tiene

    Con sus palabras, incluidas las partes de las que no está seguro. No estarlo es la posición de partida normal.

  2. El sistema se lee, no se adivina

    Lo hago yo, o un agente de IA con un prompt escrito exactamente para esto, con las exigencias de evidencia que lo mantienen honesto.

  3. Recibe una descripción que puede entregar a cualquiera

    Lo bastante corta para leerla, lo bastante concreta para actuar y lo bastante correcta para discutirla.

Cuándo merece la pena

Probablemente aún no, si

El producto tiene dos semanas y lo hizo usted entero este mes

Ya tiene documentación de arquitectura actual en la que confía

Lo único que necesita es arreglar un error concreto

Merece la pena si

Los agentes escribieron casi todo y nadie lo leyó entero

Desde el inicio ha entrado y salido gente del proyecto

Va a tomar una decisión que depende de cómo funciona

Tiene que explicar el sistema a un inversor, un comprador o un desarrollador nuevo

Empiece por el área que más le preocupa

Elija el nivel de implicación que encaje, describa su producto y empezamos por ahí.