unlazy는 “구현했다”는 에이전트의 서술을 그대로 믿지 않고, 인수 조건을 실행 가능한 게이트로 만들어 확인하는 AI 에이전트 스킬이다. 큰 작업을 트리로 분해하고 각 말단 작업에 명령, 기대 출력, 증거를 붙여 재실행할 수 있게 한다. 긴 코딩 작업에서 완료 선언과 실제 검증 사이의 간극을 줄이려는 팀에 유용하다.
게이트는 체크리스트가 아니라 실행 계약이다
GATES.md의 각 항목에는 검증 명령(CHECK), 기대하는 성공 표시(EXPECT), 필요하면 작업 디렉터리(CWD)를 둔다.
- [ ] G1: 가격표 fixture가 예상 tier를 렌더링한다
CHECK: node scripts/verify-pricing.mjs
EXPECT: pricing verification passed
EVIDENCE: pending게이트는 프로세스 종료 코드가 0이고 출력이 EXPECT와 맞을 때만 통과한다. 실행한 shell·작업 디렉터리·종료 상태·핵심 출력도 증거로 기록한다. 이미 통과한 항목도 --reverify로 다시 실행할 수 있어 오래된 성공 기록을 최신 검증으로 오해하지 않게 한다.
사용 흐름
- 결과물을 읽는 검증 명령부터 설계한다.
- 일반 실행 전에는
--status로 ledger를 읽고, 실행할 명령과 호출 스크립트를 검토한다. - 정확한
CHECK·EXPECT·shell·경로 조합을 승인한 뒤 실행한다. - 큰 작업은
.unlazy/<scope>/아래에 계획과 말단 게이트를 두고 의존성이 풀린 작업만 진행한다. - 완료 보고 전에 모든 실행 가능한 게이트를 재검증한다.
병렬 실행과 보안의 한계
독립된 말단 작업은 OWNS 경로를 선언하고 claim한 뒤 병렬로 진행할 수 있다. 하지만 claim은 협업 충돌을 줄이는 장치일 뿐 파일시스템 격리가 아니다. 승인 기록도 샌드박스가 아니다. 승인된 CHECK는 현재 사용자 권한, 환경 변수, 네트워크를 그대로 쓰므로, 상속받은 ledger나 설치 훅을 실행하기 전에는 명령과 호출 경로를 읽어야 한다.
관련 문서
- agent-harness — 에이전트 실행 환경과 피드백 루프 설계
- agent-skills — 에이전트에 절차와 도구를 제공하는 스킬 시스템
- testsprite-cli — 코딩 에이전트 산출물을 자동 테스트로 검증하는 도구
라이선스
저장소의 라이선스와 릴리스 상태를 설치 전에 확인해야 한다. README 기준 소스는 2.1.0을 대상으로 하며, 불변 설치가 필요하면 정확한 commit을 고정하는 편이 안전하다.
참고 자료
- Leonxlnx/unlazy — GitHub 공식 저장소