검증과 게이트Review gates

agent-pipeline-resume-log

여러 단계 에이전트 실행의 재개 지점을 찾고, 몰래 낮춘 모델 등급을 잡아내는 텍스트 규약입니다.

어떤 문제를 푸나The problem

긴 에이전트 파이프라인은 중간에 끊깁니다. 단계마다 [ENTER]와 [DONE] 줄을 남기면 다음 세션이 어디서 이어야 하는지 계산할 수 있습니다. 같은 기록에 모델 등급을 유지·상향·하향했는지와 그 이유를 남기게 하면 비용 판단도 감사할 수 있습니다.

검사기는 기록을 읽어 'RESUME AT: 단계' 한 줄을 알려 주고, 프로토콜을 어긴 곳을 실패로 보고합니다.

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

여러 단계 에이전트 작업을 돌리다 끊긴 뒤 이어서 시작해야 하는 사람, 단계별 모델 선택을 기록으로 남기고 싶은 사람.

무엇을 하나What it does

등급 판정(tier)이 없거나 이유가 없으면 실패합니다.
고정된 역할의 등급을 낮추면 항상 실패합니다.
keep이라고 적고 다른 모델을 쓰면 실패합니다. 이유 문장 속의 model=도 셉니다.
key=value는 reason: 앞에서만 읽고 같은 키가 두 번 나오면 오류입니다.
--stages-with-artifacts와 --defaults를 함께 넘겨야 산출물과 모델 검사가 동작합니다.

직접 돌려 본 출력Real output

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

$ bash examples/demo.sh
# An interrupted run: where do I resume?
$ python3 scripts/resume_point.py examples/run-interrupted.md --pinned designer,judge
protocol honoured
RESUME AT: 2-build
[exit 0]

# A pinned role (judge) was quietly downgraded to save cost:
$ python3 scripts/resume_point.py examples/run-bad.md --pinned designer,judge
stage 1-plan: downgrade on pinned role 'judge' is never allowed
RESUME AT: 1-plan
[exit 1]

알아둘 한계Limits

기록을 검증할 뿐 단계를 실행하거나 재시작하지 않습니다. 스크립트는 디스크를 읽지 않습니다.

받아서 쓰기Get it

# 저장소를 받습니다
git clone https://github.com/Kein-chronicle/agent-pipeline-resume-log.git

# Claude Code 스킬로 쓰려면 이 폴더 이름으로 받습니다
git clone https://github.com/Kein-chronicle/agent-pipeline-resume-log.git ~/.claude/skills/resumable-stage-log

정보Info

분류Category: 검증과 게이트Review gates
형태Type: 명령줄 도구Command-line tool
라이선스License: MIT
필요한 것Requires: Python 3.10 이상
저장소Repository: agent-pipeline-resume-log
토픽Topics: ai-agents agent-skills claude-code claude-skills workflow resumability pipeline logging

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