Mise en Place for Agentic Coding: Deliberate Preparation as Context Engineering Methodology

Resumen Técnico: Mise en Place para la Codificación Agente

Declaración del Problema
El documento identifica un "problema de alineación" sistémico en el flujo de trabajo dominante actual de la codificación asistida por IA, a menudo denominado "codificación por vibración" (vibe coding). En este patrón, los desarrolladores priorizan la implementación rápida describiendo intenciones a agentes y corrigiendo iterativamente los desajustes. Los autores argumentan que este enfoque crea un cuello de botella no en la generación de código, sino en la alineación entre la intención del desarrollador y la salida del agente. Los agentes que operan sin suficiente contexto producen código lleno de fallos de seguridad (citando la cifra del 45% de Veracode) y desalineaciones arquitectónicas, lo que conduce a una depuración y refactorización extensas que consumen tiempo significativo de desarrollo. El problema central es que los agentes carecen del conocimiento tácito y del contexto de dominio que los colaboradores humanos llevan naturalmente, y no pueden iterar de forma económica sin una regeneración costosa.

Metodología: Mise en Place (MEP)
Basándose en el concepto culinario de mise en place ("todo en su lugar"), los autores proponen una metodología de preparación de tres fases diseñada para externalizar el conocimiento tácito y estructurar el entorno informativo antes de que los agentes comiencen a escribir código. Este enfoque se fundamenta en el diseño inverso y la externalización del conocimiento tácito (Polanyi).

1. Aterrizaje Contextual: La primera fase implica externalizar la experiencia de dominio y el conocimiento tácito en documentos estructurados legibles por máquinas (por ejemplo, archivos markdown). Esto incluye análisis competitivo, filosofía de diseño y restricciones específicas de dominio. El objetivo es crear una capa de contexto persistente a la que los agentes puedan hacer referencia, convirtiendo efectivamente "lo que sabemos pero no podemos decir" en instrucciones explícitas.
2. Especificación Colaborativa: En esta fase, un diálogo estructurado entre humano y agente produce artefactos de diseño detallados. El humano codifica juicios de valor y restricciones (definir qué excluir es tan crítico como qué incluir), dando como resultado una especificación que captura el "por qué" detrás del "qué". Esto permite a los agentes tomar microdecisiones alineadas durante la implementación sin intervención humana constante.
3. Descomposición de Tareas: La fase final de preparación convierte las especificaciones en registros de tareas estructurados y conscientes de las dependencias (denominados "cuentas" o "beads"). Estos registros ligeros, respaldados por control de versiones, definen prioridades, dependencias y criterios de aceptación. Esta descomposición permite la ejecución paralela por múltiples agentes, desplazando la carga de coordinación del tiempo de ejecución al tiempo de preparación.

Estudio de Caso y Resultados
La metodología se aplicó durante un hackathon competitivo de cinco horas para construir una plataforma educativa de pila completa.

• Preparación: El investigador-práctico dedicó aproximadamente dos horas a las tres fases de MEP, generando 10 documentos de planificación (9.386 palabras) y 64 registros de tareas estructurados.
• Ejecución: Cuatro agentes de IA paralelos implementaron el proyecto basándose en estos artefactos. La fase de implementación duró aproximadamente 184 minutos, con los agentes cerrando registros de tareas a una tasa mediana de 5,9 minutos por tarea.
• Resultados: La base de código final consistió en 8.496 líneas a través de 43 archivos. Crucialmente, la implementación no requirió ninguna refactorización estructural; los errores se limitaron a problemas de integración y estilo en lugar de desalineaciones arquitectónicas. La relación preparación-ejecución fue de aproximadamente 5,7:1.
• Comparación: En un campo de 12 equipos, la mayoría utilizó flujos de trabajo "por vibración" o mixtos con bucles de agente único. El equipo MEP (T12) fue el único que utilizó subagentes paralelos derivados de un plan descompuesto. Aunque el documento señala la falta de un grupo de control, la reestructuración arquitectónica casi nula sugiere que un contexto inicial rico reduce el desajuste de los agentes.

Contribuciones Clave

1. Metodología MEP: Un proceso de preparación formalizado de tres fases (Aterrizaje Contextual, Especificación Colaborativa, Descomposición de Tareas) que integra el diseño inverso y la externalización del conocimiento tácito en la codificación agente.
2. Evidencia del Estudio de Caso: Datos cuantitativos de un hackathon competitivo que demuestran que dos horas de preparación permitieron una implementación rápida y paralela con una reestructuración arquitectónica mínima.
3. Fluidez de Contexto: La introducción de la "fluidez de contexto" como una habilidad emergente del desarrollador. Definida como la capacidad de crear contextos ricos, estructurados y legibles por máquinas sobre los cuales los agentes puedan actuar, esta habilidad abarca la descomposición, la especificación, la definición de restricciones y la codificación de dominio.
4. Agenda de Investigación: Una propuesta de cinco preguntas de investigación (RQ1–RQ5) para validar empíricamente las metodologías de preparación, incluidos estudios comparativos frente a flujos de trabajo iterativos y estudios longitudinales sobre la escalabilidad.

Significado y Afirmaciones
El documento posiciona a MEP no como una solución universal derivada de un único estudio de caso, sino como una formalización de prácticas a las que convergen independientemente los practicantes experimentados. Los autores argumentan que el problema de alineación en la codificación agente es fundamentalmente un problema de preparación. Al tratar la preparación como una disciplina de ingeniería de primer nivel, la metodología busca desplazar el cuello de botella desde la generación de código hacia la creación de contexto de alta calidad.

El significado radica en redefinir el papel del desarrollador: pasar de la ingeniería de prompts iterativa a la "ingeniería de contexto". El documento afirma que, si bien la "codificación por vibración" acelera la salida, aumenta la superficie de exposición para defectos. Por el contrario, la preparación deliberada (MEP) y la habilidad de fluidez de contexto permiten a los agentes actuar con mayor autonomía y alineación, reduciendo la necesidad de costosas iteraciones correctivas. Los autores concluyen que las futuras herramientas y la educación deben priorizar la infraestructura de la preparación (especificaciones, descomposición, andamiajes de contexto) en lugar de solo la ejecución de la generación de código.