Question 1

AI-DLC 'log review' 오류 해결 방법: "the reviewer appendix must contain exactly one Reviewer line matching the requested reviewer"?

Accepted Answer

이는 AI-DLC v2.11.0의 알려진 버그로, v2.11.1에서 수정되었습니다(#2221을 통해). 2.11.0에서는 `core/tools/aidlc-lib.ts`의 reviewer-authority 검사가 모든 `**Reviewer:**` 줄을 카운트했기 때문에, 리뷰 파일이 에이전트의 아이덴티티 마커(예: `**Reviewer:** aidlc-product-lead-agent`)로 시작하고 verdict 블록 자체에도 Reviewer 줄이 있는 경우 두 개로 카운트되어 리뷰를 거부했습니다. 해결 방법: AI-DLC를 v2.11.1 이상으로 업그레이드하세요(또는 고정된 프레임워크 버전을 업데이트하세요). 2.11.1부터는 Verdict, Reviewer 또는 Iteration 줄이 단어 그대로 반복되면 하나의 줄로 카운트되므로, 아이덴티티 마커로 시작하는 리뷰 파일도 정상적으로 기록되며 모든 findings가 gate에 표시됩니다. *다른* 에이전트를 지정하는 두 번째 Reviewer 줄은 여전히 올바르게 거부됩니다. 2.11.0에서 벗어날 수 없는 경우의 우회 방법: 리뷰 에이전트에게(dispatch brief에서) 리뷰 파일을 `## Review`로 시작하고 Reviewer 줄을 파일의 첫 줄이 아닌 verdict 블록 안에 하나만 포함하도록 지시하세요. 참고: 거부 후 `--retry-pending`을 사용하면 재시도는 의도적으로 클린 슬롯에서 시작하여 거부된 리뷰의 findings를 가져오지 않으므로, Major findings를 잃지 않으려면 첫 번째 리뷰의 findings를 gate에 수동으로 제시하세요.

Question 2

aidlc engine state unit start 실행 시 발생하는 "could not resolve the current routed unit (no diagnostic)" 오류를 해결하는 방법은?

Accepted Answer

이 오류는 `unit start`와 `unit complete` 내부의 라우팅 검사가 자식 `orchestrate next` 프로세스를 생성한 후 약 30초 뒤에 이를 강제 종료하기 때문에 aidlc 2.10.0에서 발생합니다. `next`가 이보다 오래 걸리면(대규모 워크스페이스에서 흔하며, 예를 들어 49,000개 이상의 파일이 있는 경우 20–125초 동안 실행될 수 있음), 오해를 불러일으키는 "no diagnostic" 메시지와 함께 시작이 거부됩니다.

**해결 방법:** aidlc 2.11.0 이상으로 업그레이드하세요. PR #1369에서 라우팅 검사 타임아웃이 약 30초에서 5분으로 늘어났으므로, 느린 `next`(20–125초)가 더 이상 거부를 유발하지 않습니다. 이는 issue #1547을 해결한 것과 동일한 수정입니다.

**즉시 업그레이드할 수 없는 경우의 우회 방법(Windows):**
1. 리소스를 많이 사용하는 프로세스(Chrome, 다른 Claude Code 세션, Visual Studio)를 종료하세요.
2. 프런트엔드 `node_modules` 폴더를 일시적으로 제거하세요.
3. `aidlc engine orchestrate next`를 연속으로 2–3회 실행하여 파일 캐시를 예열하세요.
4. `Start-Process`를 통해 `unit start`를 실행한 다음, 약 6초 동안 300ms 간격으로 마커 프로세스와 그 자식 `next` 프로세스의 PriorityClass를 High로 설정하세요.

참고: 이러한 우회 방법은 예열된 `next`가 약 30초 이내에 완료되는 경우에만 도움이 됩니다. 2.11.0+에서도 여전히 거부가 발생하면, 일반 `aidlc engine orchestrate next` 실행에 걸리는 시간을 측정하여 보고해 주세요.

Question 3

왜 Kiro CLI subagent는 /model로 선택한 모델과 다른 모델에서 실행되나요?

Accepted Answer

Kiro CLI 하위 에이전트(composer, developer, reviewers와 같이 디스패치된 AI-DLC 에이전트)는 `/model` 또는 `kiro-cli chat --model`로 선택한 세션 모델을 상속하지 않습니다. Kiro 하위 에이전트는 스티어링 파일, MCP 서버, 워크스페이스 접근, 스펙 상태, 권한만 상속할 뿐 모델은 상속하지 않기 때문에, 항상 저장된 기본 모델(`~/.kiro/settings/cli.json`의 `chat.defaultModel`)로 시작합니다. `/model` 전환은 저장하기 전까지 현재 채팅에만 영향을 미칩니다.

해결 방법: Kiro CLI에서 `/model set-current-as-default`를 실행하거나, 에이전트를 디스패치하기 전에 `aidlc config models --session-model <model-id> --yes`를 실행하여 `chat.defaultModel`이 의도한 모델과 일치하도록 하세요. 이렇게 하면 conductor가 계속 작동하는 동안 저장된 기본 모델을 사용할 수 없게 되는 경우("model is unavailable, retrying now")에 발생하는 디스패치 실패도 방지할 수 있습니다.

AI-DLC v2.11.1(PR #2405)에서는 문서, `aidlc config models --show`, `aidlc doctor`가 에이전트가 세션 모델을 상속한다고 안내하는 대신 Kiro 설정에 저장된 모델로 시작한다고 명시하도록 수정되었습니다.

Question 4

플러그인 빌드가 15분 동안 멈출 때 "could not acquire plugin build output lock" 오류를 해결하는 방법

Accepted Answer

이 멈춤 현상은 잠금 경합이 아니라 권한 문제입니다. 공유 잠금 폴더 `/tmp/aidlc-plugin-build-locks`는 가장 먼저 빌드를 실행한 사용자(예: CI의 root)에 의해 모드 0700으로 생성되므로, 다른 사용자는 `EACCES` 오류를 받게 되며, 이 오류는 900000ms(15분) 타임아웃에 도달할 때까지 25ms 간격으로 조용히 재시도됩니다. 해결 방법 — 빌드를 실행하기 전에 각 사용자에게 고유한 임시 디렉터리를 지정하세요: ```sh mkdir -p "$HOME/.tmp" export TMPDIR="$HOME/.tmp" TMP="$HOME/.tmp" TEMP="$HOME/.tmp" bun /aidlc-plugin-build.ts ``` 이전 단계는 root로 실행되고 이후 단계는 권한 없는 사용자로 실행되는 CI에서는, 권한 없는 단계에 대해 `TMPDIR`/`TMP`/`TEMP`를 해당 job의 스크래치 디렉터리 내부 폴더로 설정하세요. 또는 폴더 소유자가 sticky bit를 사용해 공유 잠금 디렉터리를 모든 사용자가 접근할 수 있도록 만들 수 있습니다: `chmod 1777 /tmp/aidlc-plugin-build-locks`. `ls -ld /tmp/aidlc-plugin-build-locks`로 확인하세요 — 모드가 `drwx------`이고 소유자가 다른 사용자로 표시된다면 이것이 원인입니다.

Question 5

"Refusing to complete feasibility" / SUMMARY_QUESTIONS_MISSING 오류가 발생하는 t242 테스트 실패를 해결하는 방법은?

Accepted Answer

`tests/unit/t242-state-transition-guard.test.ts` 테스트가 실패하는 이유는 해당 bare fixture에 stage-questions 파일이 없어서 엔진의 `gate-start`가 `"reason_codes":["SUMMARY_QUESTIONS_MISSING"]`으로 거부하기 때문입니다. 이는 로직이 손상된 것이 아니라, 나중에 추가된 사전 조건에 대해 테스트가 오래되어 맞지 않게 된 것입니다. 두 가지 해결 방법이 있습니다:

1. **권장:** 테스트가 생성하는 환경에 `AIDLC_SKIP_SUMMARY_CONFIRMATION_GUARD=1`을 설정하세요. 이는 `tests/unit/t-guard-refusal-actionable.test.ts`의 선례와 일치하며, 테스트가 gate words에 집중하도록 유지합니다. 다음 명령으로 확인하세요:
```bash
AIDLC_SKIP_SUMMARY_CONFIRMATION_GUARD=1 bun test tests/unit/t242-state-transition-guard.test.ts
# → 56 pass, 0 fail
```

2. **대안:** fixture에 `feasibility-questions.md` 파일을 시드하여 실제 가드 경로가 실행되도록 하세요. 더 충실한 방법이지만, 테스트를 summary-confirmation 흐름에 결합시킵니다.

참고: 이 실패는 `CLAUDE_CODE_SESSION_ID` 유출로 인한 것이 아닙니다(그것은 별도의 t265 이슈입니다). 해당 변수를 해제해도 이 문제는 해결되지 않습니다.

aidlc-workflows

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트