LLMs y código: la documentación se vuelve un problema

A medida que los equipos de desarrollo integran modelos de lenguaje grandes (LLM) para la generación de código, la gestión de la documentación se ha convertido en un desafío creciente. El artículo de Jim Yagmin en yagmin.com describe cómo la acumulación de documentación en directorios como /docs, a menudo creada de forma orgánica y sin una planificación estratégica (siguiendo un enfoque similar al de OpenAI internamente), genera problemas de descubribilidad, mantenimiento y consistencia. La documentación extensa, aunque útil inicialmente, puede degradar la calidad del código generado por los LLM debido a inconsistencias sutiles y falta de observabilidad. El artículo advierte que los LLM no resolverán este problema por sí solos, ya que la gestión del contexto es un desafío fundamental distinto a la generación de código. La solución propuesta implica una revisión profunda de cómo se gestiona el contexto, incluyendo la propiedad organizacional, la navegabilidad, la composabilidad, la conciencia del código y la adopción de un enfoque de Desarrollo Impulsado por el Contexto (CDD) para alinear la documentación con el código y mantener una fuente de verdad confiable.