Las descripciones de PR con AI mejoran cuando una persona recorta la entrada

Simon Willison utiliza el pull request como unidad básica de trabajo con Claude Code y Codex. En vez de borrar la larga descripción de la máquina, la coloca dentro de un elemento desplegable y deja delante unas frases aprobadas por una persona.

GitHub puede ocultar el detalle automático sin perderlo

GitHub Markdown admite los elementos HTML details y summary en descripciones de pull requests y comentarios. Willison coloca dentro la explicación generada por el agente. Quedan visibles una introducción breve, a veces una imagen y una etiqueta con el modelo o el nivel de esfuerzo.

Muestra cinco pull requests concretos. Una entrada explica el problema de una tabla con 46 columnas. Otra señala la carga innecesaria de un archivo de unos 220 KB. El registro detallado de la implementación y las pruebas sigue disponible al desplegarlo.

Escribir se ha abaratado y ahora el cuello de botella es leer

Un coding agent puede producir una descripción precisa y completa con un coste mínimo para quien la crea. La persona que revisa sigue pagando con su tiempo. Cuando cada pull request llega con varios párrafos igual de minuciosos, la exhaustividad dificulta orientarse.

Willison separa dos tareas. La entrada breve responde si el cambio merece atención. La parte plegada conserva decisiones, detalles de implementación y pruebas para cuando alguien los necesite. El trabajo humano pasa de redactar a seleccionar.

Un desplegable no sustituye el criterio ni la revisión

El patrón no garantiza que el código o la descripción sean correctos. Una mala entrada puede ocultar un riesgo con la misma facilidad que oculta relleno. El texto largo del interior también sigue siendo largo, aunque ya no bloquee el primer vistazo.

La convención funciona si el equipo comparte una promesa clara: el párrafo visible refleja prioridades aprobadas por una persona y no otro resumen automático. Sin esa responsabilidad, el desplegable se convierte en un armario digital que todos llenan y nadie abre.

La velocidad de decisión dirá más que la longitud del texto

La señal útil será tardar menos hasta la primera revisión y pasar por alto menos riesgos, no contar palabras detrás de una flecha. Los equipos deberían comprobar si la entrada expresa de forma constante el propósito, el alcance y el principal riesgo del cambio.

Si el patrón se extiende, el cambio parecerá modesto. El agente aporta el expediente completo, una persona elige la portada y quien revisa decide si abre el resto.

El veredicto de Lilith

El agente lleva a la revisión una caja llena de expedientes. Una persona aún debe escribir en la tapa por qué alguien debería abrirla.