야간 무인 세션에서 Claude Code 드리프트 없이 실행하는 3단계 패턴

체인 러너

N번의 반복 동안 고정된 스킬 시퀀스를 실행합니다:

bin/skill-chain.py --chain dev-cycle-with-review-looped --loop 10

각 반복: 개발 스킬이 docs/TODO.md에서 다음 항목을 선택하고, 이를 배포(코드 + 테스트 + 문서를 한 번의 커밋으로)한 후, 리뷰 스킬이 배포된 내용을 비판하고 TODO에 후속 작업을 추가합니다. 표준 에이전트 루프를 명시적으로 만든 것입니다.

세션 종료 시 감독자

루프가 끝난 후, 별도의 스킬이 실행 기록을 읽고 각 스킬을 명시된 작업에 대해 평가한 후, 스킬 텍스트 자체의 재작성을 제안합니다. 자동 승인이 켜져 있으면 해당 재작성이 적용됩니다. 자동 승인이 꺼져 있으면 사람의 검토를 위해 SKILL.patch.md 사이드카 파일로 작성됩니다.

단일 핸드오프 계약

모든 스킬은 시작 시 docs/SPEC.md(표준 계획)와 docs/TODO.md(진행 중 / 방금 배포 / 다음 예정)를 읽고, 코드 변경과 동일한 커밋에서 이를 업데이트합니다. 사이드 채널, 두 번째 TODO 형식, 스킬별 계획 문서가 없습니다. 프레임워크는 자체 개발에서 이 계약을 자체적으로 활용합니다. 이 계약이 드리프트 억제의 대부분을 수행합니다.

추가 기능

독점/이전 가능 분할: skills/framework/ 아래의 스킬은 이전 가능하며, 각 프로젝트는 독점 스킬을 .claude/skills/에 유지합니다. 정리 스킬이 해당 경계를 넘는 승격을 확인하여 비밀 정보가 유출되지 않도록 합니다.
스키마 검증: bin/validate-frontmatter.py가 schema/skill-set.schema.json 및 schema/skill-chain.schema.json에 대해 잘못된 스킬을 체인 실행 전에 잡아냅니다.
선택적 Telegram 제어: 세션 시작, 각 반복 경계, 속도 제한 일시 중지/재개 시, 세션 종료 시 상태 메시지를 보냅니다. /cmd를 통해 명령을 다시 큐에 넣어 다음 반복에서 처리합니다.
야간 체인: 실패, 예산 한도 또는 Ctrl-C까지 반복하며, 5분에서 2시간 사이의 무작위 지연을 두어 커밋 주기가 인간스럽게 유지됩니다.