AI-DLC 2.11.0은 코드 생성 전에 Codex CLI 워크플로를 멈춰 개발자가 제안된 계획을 읽고 승인하게 할 수 있다. 이 가이드는 2026년 10월 8일의 v2.11.0 릴리스와 해당 버전의 Codex CLI, 워크플로 프로필 및 Plan Approval 지침을 따른다. BIG CHANGE는 이 문서와 릴리스 태그의 명령 참조를 검토했다. AI-DLC를 설치하거나 실행하지 않았으며 아래의 모든 단계는 문서에만 근거한다.

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

시작하기 전에

해당 태그의 Codex 가이드는 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 릴리스가 다음 버전별 설치 명령을 제공한다.

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

릴리스는 PowerShell용 버전별 Windows 설치 프로그램 역시 제공한다. 실행하기 전에 설치 프로그램을 살펴보고 자신의 컴퓨터에 적합한 방법을 선택한다. 그런 다음 프로젝트에서 설치 버전과 환경을 확인한다.

Terminal
aidlc --version
aidlc doctor
codex --version

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

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

Git 프로젝트 루트에서 해당 태그의 Codex 설정 절차를 사용한다.

Terminal
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에서 실행하고 활성 워크플로가 없는지 확인한다. 해당 태그의 명령 참조는 활성 워크플로가 있으면 별도 옵션 없는 범위 명령이 기존 작업을 이어간다고 설명한다. 이 안내에는 활성 워크플로가 없는 프로젝트를 사용한다.

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

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 흐름으로 빌드를 재개한다. 릴리스 노트에 따르면 변경 없는 승인된 계획은 대화가 압축되거나 보류되어도 기억된다. 해당 태그의 명령 참조에는 기록된 타임라인을 확인하는 읽기 전용 명령 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 통합 실행 환경 복구를 따른다. 활성 프로젝트의 런타임을 바꾸기 전에 버전 불일치를 확인한다. 질문이 없다는 사실이 승인이 기록됐다는 증거라고 가정하지 않는다. 설정이 꺼져 있으면 AI-DLC는 PLAN_APPROVAL_SKIPPED 행을 기록하며, 해당 태그의 문서는 이를 사람의 승인과 명확히 구분한다.

큰 변화

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

출처와 더 읽을거리