Edição Markdown

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

# Configure o AI-DLC 2.11.0 para pausar e pedir aprovação do plano

> Um guia com versão fixa, baseado apenas na documentação, para ativar e verificar a aprovação humana do plano no AI-DLC 2.11.0 antes de gerar 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.

O AI-DLC 2.11.0 pode parar um fluxo do Codex CLI antes da geração de código para que um programador leia e aprove o plano proposto. Este guia segue o [lançamento v2.11.0 de 8 de outubro de 2026](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0) e suas instruções versionadas de [Codex CLI](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md), [perfis de fluxo de trabalho](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/workflow-profiles.md) e [Plan Approval](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/13-customization.md#plan-approval). A BIG CHANGE examinou esses documentos e a referência de comandos da tag. Não instalamos nem executamos o AI-DLC; todas as etapas abaixo se baseiam apenas na documentação.

O leitor previsto é um programador com um projeto Git que quer examinar um plano de código antes que um assistente de programação com IA gere ficheiros. O resultado esperado é uma pergunta de Plan Approval que identifica o plano, permite solicitar mudanças e deixa a construção à espera até o programador responder. O AI-DLC ainda tem verificações posteriores; essa etapa de aprovação trata especificamente do plano de código.

## Antes de começar

O [guia do Codex na tag](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md) exige Codex CLI 0.145.0 ou mais recente, um repositório Git para os hooks do projeto e um fornecedor de modelos configurado. A versão nativa do AI-DLC não requer Bun nem Node.js. Utilize um projeto cujo código e plano esteja autorizado a enviar ao fornecedor configurado. Verifique separadamente as condições de tratamento de dados e cobrança do fornecedor; o repositório do AI-DLC não informa um preço único de uso do fornecedor para esse fluxo.

Prepare uma tarefa concreta de desenvolvimento como entrada. Este passo a passo escolhe o perfil **Feature** porque a documentação da v2.11.0 informa que Plan Approval está ativado para Feature. **Express** e **Proof of concept** começam com Plan Approval desativado, embora uma pessoa possa pedir a revisão de um plano específico. O perfil importa mais que uma expectativa genérica de que toda execução do AI-DLC vai pausar.

## 1. Instale e verifique a versão fixa

No macOS, Linux ou WSL, o lançamento v2.11.0 fornece este comando de instalação específico da versão:

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

O lançamento também oferece um [instalador do Windows específico da versão](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0) para PowerShell. Examine o instalador e escolha o caminho adequado para sua máquina antes de executá-lo. Depois verifique a versão instalada e o ambiente a partir do projeto:

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

Espere que `aidlc --version` informe 2.11.0. `aidlc doctor` relata problemas de configuração e execução, enquanto `codex --version` permite conferir a versão mínima do Codex CLI. Se a versão instalada for diferente, pare aqui e use as instruções de instalação ou atualização da v2.11.0; as etapas abaixo estão fixadas nessa versão.

## 2. Configure o Codex e confie nos hooks do projeto

Na raiz do projeto Git, use o [caminho de configuração do Codex na tag](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
```

O Codex pergunta se confia nos hooks do projeto. Examine o projeto e os hooks gerados antes de escolher **Trust all and continue (Confiar em todos e continuar)**. O guia da tag diz que uma caixa de diálogo já fechada pode ser reaberta com `/hooks`, depois `t` e Esc. Execute `$aidlc --doctor` no Codex após conceder confiança. Se os hooks não estiverem a funcionar, siga a recuperação de confiança do guia do ambiente de integração; um instalador bem-sucedido, por si só, não comprova que os hooks do projeto estão ativos. O fornecedor de modelos e suas credenciais são configurados nas definições de utilizador do Codex, e não fornecidos pelo AI-DLC.

## 3. Inicie um fluxo Feature e verifique as configurações

Primeiro execute `$aidlc --status` no Codex e confirme que não há fluxo ativo. A [referência de comandos da tag](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md) diz que um comando de âmbito sem outras opções continua o trabalho existente quando há um fluxo ativo. Use um projeto sem fluxo ativo neste passo a passo.

Nesse projeto do Codex configurado, digite `$aidlc feature` e responda à solicitação sobre a tarefa que quer construir. A entrada deve descrever a funcionalidade e suas restrições; o plano final é gerado desse trabalho. Antes de criar o plano de código, examine os controlos efetivos com base na [referência de comandos da 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
```

Procure Plan Approval **on (ativado)** e a origem indicada da configuração. Se estiver desativado para essa intenção, `$aidlc --plan-approval on` ativa a pergunta para o próximo plano. Um controlo no nível da máquina pode forçar sua desativação, e uma regra de memória da equipa pode exigir que fique ativado; a linha de estado identifica o valor efetivo. Neste passo a passo, configure Guard Policy como estrita com `$aidlc --guard-policy strict` se também quiser exigir nova aprovação quando um plano já aprovado ou suas instruções de teste forem editados. Plan Approval ativado controla a primeira pergunta; Guard Policy controla o que acontece depois de uma mudança no plano aprovado.

## 4. Revise o plano de código na etapa de aprovação

Continue o fluxo até Code Generation ter um plano pronto. Com Plan Approval ativado, o mecanismo v2.11.0 mostra o resumo e o caminho do plano, incluindo as opções **Approve Plan (Aprovar plano)**, **Request Changes (Solicitar mudanças)** ou **I'll edit the files (Vou editar os ficheiros)**. Abra o ficheiro `code-generation-plan.md` indicado e leia os ficheiros propostos, a sequência e as instruções de teste. Verifique comandos, acesso aos dados do projeto e ações que possam alterar o repositório antes de aprovar.

Escolha **Request Changes (Solicitar mudanças)** se o plano precisar de outra implementação ou teste. Se editar os ficheiros por conta própria, use o caminho do mecanismo **I'll edit the files (Vou editar os ficheiros)** em vez de considerar uma edição como aprovação. Só sua resposta autoriza o plano; um modelo não pode aprová-lo por si. Com essa etapa ativada, a geração de código aguarda essa resposta. As notas de lançamento dizem que uma revisão, configuração, commit ou outra solicitação permitida pode prosseguir enquanto a construção aguarda.

## 5. Aprove, verifique o registo e trate um plano alterado

Quando o plano estiver aceitável, responda **Approve Plan (Aprovar plano)** na pergunta aberta. O mecanismo regista a aprovação para aquele plano e retoma a construção pelo fluxo normal `next`. Segundo as notas de lançamento, um plano aprovado sem alterações é lembrado mesmo após a conversa ser compactada ou suspensa. A [referência de comandos da tag](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md#read-earlier-questions-and-the-audit-timeline) documenta o comando somente de leitura `aidlc engine audit history` para examinar a cronologia registada, e `$aidlc --status` mostra a posição do fluxo. Esses registos são a verificação de sucesso, junto com a aparição visível da etapa de aprovação antes do código gerado.

Se o plano ou suas instruções de teste mudarem antes da construção, Guard Policy estrita pede aprovação novamente. Com uma política relaxada ou desativada, a mudança é relatada e registada, mas o fluxo pode continuar sem nova aprovação obrigatória. A documentação da tag também distingue alterações de ficheiros de código-fonte não relacionados depois da aprovação: elas são relatadas, enquanto a aprovação continua a tratar do plano e das instruções de teste. A pessoa pode dizer “volte ao plano aprovado” para restaurar o plano anterior antes da construção. Um plano sem mudanças não deve perguntar de novo só porque a conversa foi compactada.

## Se a pausa não aparecer

Primeiro leia `$aidlc --status` e `$aidlc config get plan-approval`. Verifique o âmbito escolhido, a configuração efetiva e sua origem. Express e Proof of concept ficam desativados por predefinição; ative Plan Approval para essa intenção ou inicie um fluxo Feature se seu ciclo completo servir à tarefa. Se a configuração ou os hooks parecerem avariados, execute `aidlc doctor` e siga a [recuperação do ambiente de integração do Codex](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md#refresh-and-version-skew). Verifique incompatibilidades de versão antes de alterar o ambiente de execução de um projeto ativo. Não presuma que a ausência da pergunta comprova uma aprovação registada: com a opção desativada, o AI-DLC grava uma linha `PLAN_APPROVAL_SKIPPED`, que a documentação da tag diferencia expressamente da aprovação de uma pessoa.

## A grande mudança

- O AI-DLC 2.11.0 coloca a pergunta do plano em seu mecanismo, que regista a decisão e preserva um plano aprovado sem mudanças durante sessões suspensas ou compactadas.
- Numa execução Feature no Codex CLI, o programador pode conferir a configuração efetiva de Plan Approval, ler o plano antes de gerar código e solicitar mudanças na etapa de aprovação.
- A reaprovação depois de editar um plano depende de Guard Policy. O programador pode escolher a política estrita para parar de novo quando o plano ou as instruções de teste mudarem.

### Fontes e leituras adicionais

- [Lançamento do AI-DLC 2.11.0](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0) — versão datada, instaladores fixados e comportamento declarado de Plan Approval. As notas descrevem a funcionalidade; não demonstram que a BIG CHANGE executou este guia.
- [Guia do Codex CLI na v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md) — versão do Codex, requisitos de Git e fornecedor, configuração do projeto, confiança em hooks e invocação.
- [Perfis de fluxo de trabalho na v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/workflow-profiles.md) — predefinições dos perfis e distinção entre Feature e Express/Proof of concept.
- [Plan Approval e Guard Policy na v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/13-customization.md#plan-approval) — primeira etapa de aprovação, registos de omissão e comportamento quando um plano aprovado muda.
- [Referência de comandos na v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md) — comandos de estado, configuração e histórico de auditoria.

## Sources

- [Lançamento do AI-DLC 2.11.0](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0) — Instaladores fixados e descrição do projeto sobre Plan Approval no mecanismo; a BIG CHANGE não executou.
- [README do AI-DLC na v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/README.md) — Visão geral do ambiente de integração e configuração na tag de 8 de outubro. O instalador genérico mais recente foi deliberadamente evitado.
- [Guia do Codex CLI do AI-DLC na v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md) — Requisitos do Codex, configuração do projeto, confiança em hooks e recuperação de incompatibilidades de versão na tag de 8 de outubro.
- [Perfis de fluxo de trabalho do AI-DLC na v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/workflow-profiles.md) — Comportamento dos âmbitos Feature, Express e Proof of concept e predefinições de aprovação na tag de 8 de outubro.
- [Plan Approval e Guard Policy do AI-DLC na v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/13-customization.md) — Pergunta do plano, registo de omissão e comportamento de reaprovação após mudanças no plano ou nas instruções de teste na tag de 8 de outubro.
- [Referência de comandos CLI do AI-DLC na v2.11.0](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md) — Comandos de versão, estado, configuração e histórico de auditoria na tag de 8 de outubro; a BIG CHANGE não executou comandos.