Markdown 버전

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

# 코드 계획 승인 전 멈추도록 AI-DLC 2.11.0 설정하기

> 코드 생성 전에 AI-DLC 2.11.0의 사람에 의한 계획 승인 관문을 켜고 확인하는 가이드. 특정 버전에 고정했으며 문서만을 근거로 작성했다.

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은 코드 생성 전에 Codex CLI 워크플로를 멈춰 개발자가 제안된 계획을 읽고 승인하게 할 수 있다. 이 가이드는 [2026년 10월 8일의 v2.11.0 릴리스](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0)와 해당 버전의 [Codex CLI](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md), [워크플로 프로필](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/workflow-profiles.md) 및 [Plan Approval](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/13-customization.md#plan-approval) 지침을 따른다. BIG CHANGE는 이 문서와 릴리스 태그의 명령 참조를 검토했다. AI-DLC를 설치하거나 실행하지 않았으며 아래의 모든 단계는 문서에만 근거한다.

이 글은 AI 코딩 도우미가 파일을 생성하기 전에 코드 계획을 확인하려는 Git 프로젝트 개발자를 대상으로 한다. 기대하는 결과는 계획을 명시하고 변경을 요청할 수 있게 하며 개발자가 답할 때까지 빌드를 기다리게 하는 Plan Approval 질문이다. AI-DLC에는 이후 검사도 있으며, 이 관문은 특히 코드 계획에 관한 것이다.

## 시작하기 전에

해당 태그의 [Codex 가이드](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md)는 Codex CLI 0.145.0 이상, 프로젝트 훅을 위한 Git 저장소, 설정된 모델 제공업체를 요구한다. 네이티브 AI-DLC 릴리스에는 Bun이나 Node.js가 필요하지 않다. 코드와 계획을 설정된 모델 제공업체에 보낼 권한이 있는 프로젝트를 사용한다. 제공업체의 데이터 처리 및 요금 조건은 따로 검토한다. AI-DLC 저장소는 이 워크플로에 대한 단일 제공업체 이용 가격을 명시하지 않는다.

입력으로 쓸 구체적인 개발 작업을 준비한다. 이 안내에서는 **Feature** 프로필을 선택한다. v2.11.0 문서에 Feature의 Plan Approval이 켜져 있다고 명시되어 있기 때문이다. **Express** 및 **Proof of concept**는 Plan Approval이 꺼진 상태로 시작하지만 사람이 특정 계획의 검토를 요청할 수 있다. 모든 AI-DLC 실행이 멈출 것이라는 막연한 기대보다 프로필이 더 중요하다.

## 1. 고정된 릴리스를 설치하고 확인하기

macOS, Linux, WSL에서는 v2.11.0 릴리스가 다음 버전별 설치 명령을 제공한다.

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

릴리스는 PowerShell용 [버전별 Windows 설치 프로그램](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0) 역시 제공한다. 실행하기 전에 설치 프로그램을 살펴보고 자신의 컴퓨터에 적합한 방법을 선택한다. 그런 다음 프로젝트에서 설치 버전과 환경을 확인한다.

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

예상 결과는 다음과 같다. `aidlc --version` 명령이 2.11.0을 표시해야 한다. `aidlc doctor`는 설정 및 런타임 문제를 보고하고, `codex --version`으로 Codex CLI 최소 버전을 확인할 수 있다. 설치 버전이 다르면 여기서 멈추고 v2.11.0 릴리스의 설치 또는 갱신 지침을 따른다. 아래 단계는 해당 릴리스에 고정되어 있다.

## 2. Codex를 설정하고 프로젝트 훅 신뢰하기

Git 프로젝트 루트에서 [해당 태그의 Codex 설정 절차](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는 프로젝트 훅을 신뢰할지 묻는다. 다음을 선택하기 전에 프로젝트와 생성된 훅을 검토한다. **Trust all and continue (모두 신뢰하고 계속)**. 해당 태그의 가이드는 이미 닫은 대화상자를 `/hooks`, 이어서 `t`와 Esc를 사용해 다시 열 수 있다고 설명한다. 신뢰를 설정한 후 `$aidlc --doctor`를 Codex에서 실행한다. 훅이 실행되지 않으면 통합 실행 환경 가이드의 신뢰 복구 절차를 따른다. 설치 프로그램이 성공했다는 사실만으로 프로젝트 훅이 활성화됐다고 볼 수 없다. 모델 제공업체와 인증 정보는 Codex의 사용자 수준 설정에 있으며 AI-DLC가 제공하지 않는다.

## 3. Feature 워크플로를 시작하고 설정 확인하기

먼저 `$aidlc --status`를 Codex에서 실행하고 활성 워크플로가 없는지 확인한다. [해당 태그의 명령 참조](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md)는 활성 워크플로가 있으면 별도 옵션 없는 범위 명령이 기존 작업을 이어간다고 설명한다. 이 안내에는 활성 워크플로가 없는 프로젝트를 사용한다.

설정한 Codex 프로젝트에서 `$aidlc feature`를 입력하고 만들려는 작업을 묻는 질문에 답한다. 입력에는 기능과 제약을 설명해야 하며, 최종 계획은 그 작업에서 생성된다. 코드 계획을 만들기 전에 다음 자료로 실제 적용되는 제어 설정을 확인한다. [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
```

Plan Approval의 **on (켜짐)** 상태와 명시된 설정 출처를 확인한다. 이 작업 의도에서 꺼져 있으면 `$aidlc --plan-approval on`이 다음 계획의 질문을 켠다. 컴퓨터 수준 스위치가 강제로 끌 수 있고 팀 메모리 규칙이 켜짐을 요구할 수 있다. 상태 줄이 실제 적용 값을 알려준다. 이미 승인된 계획이나 그 테스트 지침을 수정할 때도 다시 승인받고 싶다면, 이 안내에서는 `$aidlc --guard-policy strict`로 Guard Policy를 엄격하게 설정한다. Plan Approval 켜짐은 첫 질문을 제어하고, Guard Policy는 승인된 계획이 바뀐 뒤의 동작을 제어한다.

## 4. 승인 관문에서 코드 계획 검토하기

Code Generation에 계획이 준비될 때까지 워크플로를 진행한다. Plan Approval이 켜져 있으면 v2.11.0 엔진은 계획 요약과 경로를 보여주고 다음 선택지를 제시한다. **Approve Plan (계획 승인)**, **Request Changes (변경 요청)** 또는 **I'll edit the files (직접 파일 수정)**. 지정된 `code-generation-plan.md` 파일을 열고 제안된 파일, 순서, 테스트 지침을 읽는다. 승인하기 전에 명령, 프로젝트 데이터 접근, 저장소를 바꿀 수 있는 동작을 검토한다.

계획에 다른 구현이나 테스트가 필요하면 **Request Changes (변경 요청)**를 선택한다. 직접 파일을 수정한다면 수정을 승인으로 취급하지 말고 엔진의 **I'll edit the files (직접 파일 수정)** 경로를 이용한다. 오직 사용자의 답변만 계획을 승인하며 모델이 대신 승인할 수는 없다. 관문이 켜져 있으면 코드 생성은 그 답을 기다린다. 릴리스 노트에 따르면 빌드가 기다리는 동안 검토, 설정, 커밋 또는 다른 허용된 요청은 진행할 수 있다.

## 5. 승인하고 기록을 확인하며 변경된 계획 처리하기

계획이 수용할 만하면 열린 질문에 **Approve Plan (계획 승인)**으로 답한다. 엔진은 해당 계획에 승인을 기록하고 일반적인 `next` 흐름으로 빌드를 재개한다. 릴리스 노트에 따르면 변경 없는 승인된 계획은 대화가 압축되거나 보류되어도 기억된다. [해당 태그의 명령 참조](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md#read-earlier-questions-and-the-audit-timeline)에는 기록된 타임라인을 확인하는 읽기 전용 명령 `aidlc engine audit history`가 설명되어 있고, `$aidlc --status`는 워크플로 위치를 보여준다. 코드 생성 전에 관문이 실제로 나타나는지와 함께 이 기록이 성공 여부를 확인하는 근거다.

빌드 전에 계획이나 테스트 지침이 바뀌면 엄격한 Guard Policy는 다시 승인을 요청한다. 완화되거나 꺼진 정책에서는 변경을 알리고 기록하지만 의무적인 새 승인 없이 워크플로가 이어질 수 있다. 해당 태그의 문서는 승인 후 관련 없는 소스 파일이 바뀌는 경우도 구분한다. 그 변경은 보고되지만 계획 승인은 계속 계획과 테스트 지침에 관한 것이다. 사용자는 ‘승인된 계획으로 돌아가’라고 말해 빌드 전에 이전 계획을 복원할 수 있다. 계획이 그대로라면 대화 압축만을 이유로 두 번째 질문을 해서는 안 된다.

## 일시 정지가 나타나지 않는 경우

먼저 `$aidlc --status`와 `$aidlc config get plan-approval`를 읽는다. 선택한 범위, 적용 중인 설정과 그 출처를 확인한다. Express와 Proof of concept는 기본적으로 꺼져 있다. 해당 작업 의도에 Plan Approval을 켜거나 전체 수명주기가 작업에 맞으면 Feature 워크플로를 시작한다. 설정이나 훅이 고장 난 것처럼 보이면 `aidlc doctor`를 실행하고 [Codex 통합 실행 환경 복구](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md#refresh-and-version-skew)를 따른다. 활성 프로젝트의 런타임을 바꾸기 전에 버전 불일치를 확인한다. 질문이 없다는 사실이 승인이 기록됐다는 증거라고 가정하지 않는다. 설정이 꺼져 있으면 AI-DLC는 `PLAN_APPROVAL_SKIPPED` 행을 기록하며, 해당 태그의 문서는 이를 사람의 승인과 명확히 구분한다.

## 큰 변화

- AI-DLC 2.11.0은 엔진에 계획 질문을 두며, 엔진은 결정을 기록하고 세션이 보류되거나 압축되어도 변경 없는 승인된 계획을 유지한다.
- Codex CLI Feature 실행에서 개발자는 Plan Approval의 적용 설정을 확인하고 코드 생성 전에 계획을 읽으며 승인 관문에서 변경을 요청할 수 있다.
- 계획 수정 후 재승인은 Guard Policy에 달려 있다. 개발자는 계획이나 테스트 지침이 바뀔 때 다시 멈추도록 엄격한 정책을 선택할 수 있다.

### 출처와 더 읽을거리

- [AI-DLC 2.11.0 릴리스](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0) — 날짜가 명시된 릴리스, 고정 설치 프로그램, 명시된 Plan Approval 동작. 릴리스 노트는 기능을 설명할 뿐 BIG CHANGE가 이 가이드를 실행했다는 증거가 아니다.
- [v2.11.0의 Codex CLI 가이드](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md) — Codex 버전, Git 및 제공업체 요건, 프로젝트 설정, 훅 신뢰, 호출 방법.
- [v2.11.0의 워크플로 프로필](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/workflow-profiles.md) — 프로필 기본값 및 Feature와 Express/Proof of concept의 차이.
- [v2.11.0의 Plan Approval 및 Guard Policy](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/13-customization.md#plan-approval) — 첫 승인 관문, 생략 기록, 승인된 계획이 변경됐을 때의 동작.
- [v2.11.0 명령 참조](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md) — 상태, 설정, 감사 이력 명령.

## Sources

- [AI-DLC 2.11.0 릴리스](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0) — 고정 설치 프로그램과 엔진 Plan Approval에 대한 프로젝트 설명. BIG CHANGE는 실행하지 않았다.
- [v2.11.0의 AI-DLC README](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/README.md) — 10월 8일 릴리스 태그의 통합 실행 환경 및 설정 개요. 일반 최신 버전 설치 프로그램은 의도적으로 사용하지 않았다.
- [v2.11.0의 AI-DLC Codex CLI 가이드](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md) — 10월 8일 릴리스 태그의 Codex 사전 요건, 프로젝트 설정, 훅 신뢰, 버전 불일치 복구.
- [v2.11.0의 AI-DLC 워크플로 프로필](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/workflow-profiles.md) — 10월 8일 릴리스 태그의 Feature, Express, Proof of concept 범위 동작과 승인 기본값.
- [v2.11.0의 AI-DLC Plan Approval 및 Guard Policy](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/13-customization.md) — 10월 8일 릴리스 태그의 계획 질문, 생략 기록, 계획 및 테스트 지침 변경 시 재승인 동작.
- [v2.11.0의 AI-DLC CLI 명령 참조](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md) — 10월 8일 릴리스 태그의 버전, 상태, 설정, 감사 이력 명령. BIG CHANGE는 명령을 실행하지 않았다.