La ironía de la IA: los programadores tendremos que hacer justo lo que menos nos gustaba

Durante años existió una especie de consenso silencioso entre muchos desarrolladores:

• Documentar era aburrido
• Escribir pruebas era algo que se hacía cuando había tiempo.

La parte divertida era construir funcionalidades. Crear productos. Resolver problemas. Escribir código.

Las dos habilidades que más valor están ganando son precisamente documentar y escribir pruebas.

Cuando el programador era la memoria del sistema

Durante décadas gran parte del conocimiento de los proyectos vivía dentro de las cabezas de los desarrolladores. Y actualmente sigue siendo así en casos concretos, ejemplo COBOL.

Sabíamos…

• …por qué una función estaba escrita de cierta manera.
• …qué endpoints no se debían tocar.
• …qué módulo era delicado.
• …cuáles eran las reglas de negocio que nunca aparecían en ningún documento.

El problema es que ese conocimiento no escala ni para equipos ni para agentes.

La IA no puede leer tu mente

Los agentes actuales son impresionantes.

Claude Code, OpenCode, Codex, Cursor y otras herramientas pueden generar miles de líneas de código en minutos.

Pero tienen una limitación fundamental:

• No pueden leer la mente del equipo.
• No conocen las decisiones arquitectónicas que se tomaron hace dos años.
• No saben qué convenciones son obligatorias.
• No entienden qué partes del sistema son especialmente sensibles (para el negocio).

Solo conocen el contexto que les proporcionamos: Por eso la documentación deja de ser un lujo y se convierte en infraestructura. Ya no documentamos únicamente para futuros desarrolladores.

Documentamos para los agentes que están generando código hoy.

El surgimiento de una nueva documentación

No es casualidad que estén apareciendo estándares como AGENTS.md o propuestas más completas como Agent OS.

Ambos parten de la misma idea: proporcionar contexto estructurado para que los agentes trabajen de forma consistente dentro de un proyecto. La documentación ya no sirve solamente para onboarding o transferencia de conocimiento. Ahora también sirve para guiar a los agentes que generan código.

Lo interesante es que estas iniciativas no intentan enseñar a programar a la IA.

Intentan enseñarle cómo programamos nosotros.

La documentación se convierte en contexto ejecutable

Antes un documento podía quedar olvidado durante meses sin generar grandes problemas.

Ahora una buena documentación puede influir directamente en miles de líneas de código generadas por IA.

La documentación dejó de ser pasiva. Se convirtió en una herramienta operativa.

Los tests también cambiaron de función

Los tests protegen conocimiento del negocio cuando la IA modifica el código.

El nuevo perfil del desarrollador

La programación no está desapareciendo.

Está evolucionando.

Cada vez dedicaremos menos tiempo a escribir código repetitivo y más tiempo a definir contexto, reglas, restricciones y criterios de aceptación.

En otras palabras:

• Menos tiempo escribiendo implementaciones.
• Más tiempo describiendo sistemas.
• Menos tiempo creando funciones.
• Más tiempo definiendo comportamientos.
• Menos tiempo produciendo código.
• Más tiempo produciendo conocimiento.
• Más tiempo validando.

---

Ejemplos:

# AGENTS.md

- Usa TypeScript strict
- No uses any
- Ejecuta tests antes de cada PR
- Nunca usar float para cálculos monetarios

// implementación...

import Decimal from 'decimal.js';

export function calculateTotal(
  amount: Decimal,
  taxRate: Decimal
): Decimal {
  return amount.plus(amount.mul(taxRate));
}

// test

it('does not allow withdrawing more money than the available balance', () => {
  const account = new Account(100);

  expect(() => account.withdraw(150)).toThrow(
    InsufficientFundsError
  );
});

---

"Porque escribir código ya no es el recurso más escaso. La claridad sí."

Referencias

• AGENTS.md: https://agents.md/
• Agent OS: https://buildermethods.com/agent-os