AI-translated from English; not yet reviewed by a fluent editor.

# Configura AI-DLC 2.11.0 para detenerse y pedir aprobación del plan

> Guía basada solo en documentación y fijada a una versión para activar y comprobar la aprobación humana del plan en AI-DLC 2.11.0 antes de generar código.

By BIG CHANGE Editorial

Published: 2026-10-15T18:54:16.360Z
Updated: 2026-10-15T18:54:16.360Z
Canonical: https://bigchange.ai/blog/aidlc-2-11-plan-approval-guide

![Conceptual charcoal illustration of one developer reading abstract plan-like lines on an unbranded desktop monitor while the keyboard sits untouched.](https://bigchange.ai/api/media/file/aidlc-human-plan-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual AI-DLC interface, user session or observed test result is depicted.

AI-DLC 2.11.0 puede detener un flujo de Codex CLI antes de generar código para que un desarrollador lea el plan propuesto y lo apruebe. Esta guía sigue la [versión v2.11.0 del 8 de octubre de 2026](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0) y sus instrucciones versionadas de [Codex CLI](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md), [perfiles de flujo de trabajo](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/workflow-profiles.md) y [Plan Approval](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/13-customization.md#plan-approval). BIG CHANGE examinó esos documentos y la referencia de comandos de la etiqueta. No instalamos ni ejecutamos AI-DLC; todos los pasos siguientes se basan únicamente en la documentación.

El lector previsto es un desarrollador con un proyecto Git que quiere examinar un plan de código antes de que un asistente de programación con IA genere archivos. El resultado esperado es una pregunta de Plan Approval que identifica el plan, permite pedir cambios y deja la compilación esperando hasta recibir respuesta. AI-DLC tiene comprobaciones posteriores; esta barrera se refiere específicamente al plan de código.

## Antes de empezar

La [guía de Codex de la etiqueta](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md) exige Codex CLI 0.145.0 o posterior, un repositorio Git para los hooks del proyecto y un proveedor de modelos configurado. La versión nativa de AI-DLC no requiere Bun ni Node.js. Usa un proyecto cuyo código y plan estés autorizado a enviar al proveedor configurado. Revisa por separado sus condiciones de tratamiento de datos y facturación; el repositorio de AI-DLC no establece un precio único de uso del proveedor para este flujo.

Prepara una tarea concreta de desarrollo como entrada. Este recorrido elige el perfil **Feature** porque v2.11.0 documenta que Plan Approval está activado en Feature. **Express** y **Proof of concept** comienzan con Plan Approval desactivado, aunque una persona puede pedir revisar un plan concreto. El perfil importa más que la expectativa general de que toda ejecución de AI-DLC se detendrá.

## 1. Instala y verifica la versión fijada

En macOS, Linux o WSL, la versión v2.11.0 proporciona este comando de instalación específico:

```bash
curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/download/v2.11.0/install.sh | sh -s -- --version 2.11.0
```

La versión también ofrece un [instalador de Windows específico de esa versión](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0) para PowerShell. Examina el instalador y elige la vía adecuada para tu equipo antes de ejecutarlo. Después comprueba desde tu proyecto la versión instalada y el entorno:

```bash
aidlc --version
aidlc doctor
codex --version
```

Se espera que `aidlc --version` indique 2.11.0. `aidlc doctor` informa de problemas de configuración y ejecución, mientras que `codex --version` permite comprobar la versión mínima de Codex CLI. Si la instalada es distinta, detente aquí y usa las instrucciones de instalación o actualización de v2.11.0; los pasos siguientes están fijados a esa versión.

## 2. Configura Codex y confía en los hooks del proyecto

Desde la raíz del proyecto Git, utiliza la [vía de configuración de Codex de la etiqueta](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md#install):

```bash
aidlc config --harness codex
aidlc doctor
codex
```

Codex pregunta si confías en los hooks del proyecto. Revisa el proyecto y los hooks generados antes de elegir **Trust all and continue (Confiar en todos y continuar)**. La guía de la etiqueta indica que puedes reabrir un diálogo descartado con `/hooks`, después `t` y Esc. Ejecuta `$aidlc --doctor` en Codex tras otorgar confianza. Si los hooks no se ejecutan, sigue la recuperación de confianza de la guía del entorno de integración; que el instalador termine correctamente no demuestra que los hooks estén activos. El proveedor de modelos y sus credenciales se configuran en los ajustes de usuario de Codex; AI-DLC no los proporciona.

## 3. Inicia un flujo Feature y examina sus ajustes

Primero ejecuta `$aidlc --status` en Codex y comprueba que no haya ningún flujo activo. La [referencia de comandos de la etiqueta](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md) indica que un comando de alcance sin más opciones continúa el trabajo existente cuando hay un flujo activo. Para este recorrido, usa un proyecto sin flujo activo.

En ese proyecto de Codex configurado, escribe `$aidlc feature` y responde a la solicitud de la tarea que quieres construir. La entrada debe describir la funcionalidad y sus restricciones; de ese trabajo se genera el plan final. Antes de crear el plan de código, examina los controles efectivos mediante la [referencia de comandos de v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md):

```text
$aidlc --status
$aidlc config get plan-approval
$aidlc config get guard-policy
```

Busca Plan Approval **on (activado)** y el origen indicado del ajuste. Si está desactivado para esta intención, `$aidlc --plan-approval on` activa la pregunta para el siguiente plan. Un ajuste a nivel de máquina puede forzar su desactivación y una regla de memoria del equipo de trabajo puede exigir su activación; la línea de estado identifica el valor efectivo. Para este recorrido, configura Guard Policy en modo estricto con `$aidlc --guard-policy strict` si también quieres que un plan ya aprobado que se edite, o sus instrucciones de prueba modificadas, requieran otra aprobación. Plan Approval activado controla la primera pregunta; Guard Policy controla qué sucede cuando cambia un plan aprobado.

## 4. Revisa el plan de código en el punto de aprobación

Continúa el flujo hasta que Code Generation tenga un plan listo. Con Plan Approval activado, el motor v2.11.0 presenta el resumen y la ruta del plan, con opciones para **Approve Plan (Aprobar el plan)**, **Request Changes (Pedir cambios)** o **I'll edit the files (Editaré los archivos)**. Abre el archivo `code-generation-plan.md` indicado y lee los archivos propuestos, la secuencia y las instrucciones de prueba. Revisa los comandos, el acceso a datos del proyecto y las acciones que podrían modificar el repositorio antes de aprobar.

Elige **Request Changes (Pedir cambios)** si el plan necesita otra implementación o prueba. Si editas los archivos tú mismo, usa la opción del motor **I'll edit the files (Editaré los archivos)** en vez de considerar la edición una aprobación. Solo tu respuesta autoriza el plan; un modelo no puede aprobarlo por ti. Con la barrera activada, la generación de código espera esa respuesta. Las notas de versión indican que una revisión, un ajuste, un commit u otra solicitud permitida pueden avanzar mientras la compilación espera.

## 5. Aprueba, comprueba el registro y gestiona un plan modificado

Cuando el plan sea aceptable, responde **Approve Plan (Aprobar el plan)** en la pregunta abierta. El motor registra la aprobación de ese plan y reanuda la compilación mediante su flujo normal `next`. Según las notas de versión, un plan aprobado sin cambios se recuerda aunque se compacte o aparque la conversación. La [referencia de comandos de la etiqueta](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md#read-earlier-questions-and-the-audit-timeline) documenta el comando de solo lectura `aidlc engine audit history` para examinar la cronología registrada, y `$aidlc --status` muestra la posición del flujo. Estos registros sirven para comprobar el resultado junto con la aparición visible de la barrera antes del código generado.

Si el plan o sus instrucciones de prueba cambian antes de la compilación, Guard Policy estricto vuelve a pedir aprobación. Con una política relajada o desactivada, el cambio se comunica y registra, pero el flujo puede continuar sin una nueva aprobación obligatoria. La documentación de la etiqueta distingue también los cambios de archivos fuente no relacionados tras aprobar: se comunican, mientras que la aprobación sigue centrada en el plan y las instrucciones de prueba. La persona puede decir «vuelve al plan aprobado» para restaurar el plan anterior antes de compilar. Un plan sin cambios no debería volver a preguntar solo porque se compactó la conversación.

## Si no aparece la pausa

Primero lee `$aidlc --status` y `$aidlc config get plan-approval`. Comprueba el alcance elegido, el ajuste efectivo y su origen. Express y Proof of concept están desactivados por defecto; activa Plan Approval para esa intención o inicia un flujo Feature si su ciclo completo encaja con la tarea. Si la configuración o los hooks parecen fallar, ejecuta `aidlc doctor` y sigue la [recuperación del entorno de integración de Codex](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md#refresh-and-version-skew). Comprueba posibles diferencias de versión antes de cambiar el entorno de ejecución de un proyecto activo. No supongas que la ausencia de pregunta demuestra una aprobación registrada: con el ajuste desactivado, AI-DLC escribe una fila `PLAN_APPROVAL_SKIPPED`, que la documentación de la etiqueta distingue expresamente de la aprobación de una persona.

## El gran cambio

- AI-DLC 2.11.0 sitúa la pregunta del plan en su motor, que registra la decisión y conserva un plan aprobado sin cambios durante una sesión aparcada o compactada.
- En una ejecución Feature de Codex CLI, el desarrollador puede comprobar el ajuste efectivo de Plan Approval, leer el plan antes de generar código y pedir cambios en el punto de aprobación.
- La reaprobación tras editar un plan depende de Guard Policy. El desarrollador puede elegir el modo estricto para detenerse otra vez cuando cambien el plan o las instrucciones de prueba.

### Fuentes y lecturas adicionales

- [Versión AI-DLC 2.11.0](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0) — versión fechada, instaladores fijados y comportamiento declarado de Plan Approval. Las notas describen la función; no demuestran que BIG CHANGE ejecutara esta guía.
- [Guía de Codex CLI en v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md) — versión de Codex, requisitos de Git y proveedor, configuración del proyecto, confianza en hooks e invocación.
- [Perfiles de flujo de trabajo en v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/workflow-profiles.md) — valores predeterminados de perfiles y diferencia entre Feature y Express/Proof of concept.
- [Plan Approval y Guard Policy en v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/13-customization.md#plan-approval) — primera barrera de aprobación, registros omitidos y comportamiento cuando cambia un plan aprobado.
- [Referencia de comandos en v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md) — comandos de estado, configuración e historial de auditoría.

## Sources

- [Versión AI-DLC 2.11.0](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0) — Instaladores fijados y descripción del proyecto sobre Plan Approval en el motor; BIG CHANGE no lo ejecutó.
- [README de AI-DLC en v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/README.md) — Resumen del entorno de integración y la configuración en la etiqueta del 8 de octubre. Se omite deliberadamente el instalador genérico de la última versión.
- [Guía de Codex CLI de AI-DLC en v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md) — Requisitos de Codex, configuración del proyecto, confianza en hooks y recuperación ante diferencias de versión en la etiqueta del 8 de octubre.
- [Perfiles de flujo de trabajo de AI-DLC en v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/workflow-profiles.md) — Comportamiento de los alcances Feature, Express y Proof of concept y valores predeterminados de aprobación en la etiqueta del 8 de octubre.
- [Plan Approval y Guard Policy de AI-DLC en v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/13-customization.md) — Pregunta del plan, registro de omisión y reaprobación tras cambios de plan o instrucciones de prueba en la etiqueta del 8 de octubre.
- [Referencia de comandos CLI de AI-DLC en v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md) — Comandos de versión, estado, configuración e historial de auditoría en la etiqueta del 8 de octubre; BIG CHANGE no ejecutó comandos.