검증과 게이트Review gates

agent-definition-of-done-gate

AI 에이전트의 완료 판정 규칙입니다. 측정 도구가 있는 게이트는 사람 승인으로 닫을 수 없습니다.

어떤 문제를 푸나The problem

'사람 확인 대기'를 완료로 세면 테스트용 광고 ID가 빌드에 남은 채 파이프라인이 끝났다고 보고합니다. 이 모듈은 사람 판정(HUMAN)이 측정 계기가 없는 게이트만 닫게 하고, 면제와 해당 없음에는 반드시 사유를 요구합니다.

에이전트가 일을 중간에 접으려 할 때도 이유, 시도별 증거 지문, 재개 조건이 갖춰졌는지 빠진 항목을 알려 줍니다.

이런 분께 맞습니다Who it is for

여러 단계 게이트로 에이전트 작업의 완료를 판단하는 사람, '끝났다'는 보고를 믿어도 되는지 확인하고 싶은 팀.

무엇을 하나What it does

status 함수는 DONE, BLOCKED, AWAITING_<대기 중인 것> 가운데 하나를 돌려줍니다.
게이트 목록이 비어 있으면 아무것도 재지 않은 것이므로 BLOCKED입니다.
계기가 있는 게이트에서 HUMAN은 닫히지 않고 남은 사람 몫의 이름을 붙여 알려 줍니다.
EXEMPT와 NA는 사유가 있어야만 게이트를 닫습니다.
validate_park는 접으려는 이유, 증거, 재개 조건 중 빠진 것을 목록으로 돌려줍니다.

직접 돌려 본 출력Real output

저장소의 examples 폴더를 실행한 결과입니다.

$ python3 examples/quickstart.py
all pass              -> DONE
nothing declared      -> BLOCKED: no gates declared (measured nothing is not done)
HUMAN on measured gate-> AWAITING_CONSOLE: next -> real-ad-id (1 open)
HUMAN on judgment gate-> DONE
bare exemption        -> AWAITING_UNCLAIMED: next -> legacy (1 open)
reasoned exemption    -> DONE
one FAIL              -> BLOCKED: fix b

park without evidence -> ['park needs evidence per attempt (what was tried + fingerprint of the artifact)', 'park needs resume conditions (what would make this go again)']
park with a way back  -> []

알아둘 한계Limits

증거가 참인지는 검증하지 못하고, 증거가 있는지만 확인합니다.
판정 규칙만 담은 순수 함수라서 게이트 목록은 직접 연결해야 합니다.

받아서 쓰기Get it

# 저장소를 받습니다
git clone https://github.com/Kein-chronicle/agent-definition-of-done-gate.git

# Claude Code 스킬로 쓰려면 이 폴더 이름으로 받습니다
git clone https://github.com/Kein-chronicle/agent-definition-of-done-gate.git ~/.claude/skills/done-state-honesty

정보Info

분류Category: 검증과 게이트Review gates
형태Type: 라이브러리Library
라이선스License: MIT
필요한 것Requires: Python 3.10 이상
저장소Repository: agent-definition-of-done-gate
토픽Topics: ai-agents agent-skills claude-code claude-skills definition-of-done quality-gates workflow

2026-10-18 기준: 저장소의 테스트를 로컬에서 실행해 통과했고, 예제 출력은 저장소의 examples 폴더를 실제로 실행한 결과입니다.