Agents Never Sleep (ANS)은(는) 무엇을 하나요?
질문 없이 백로그를 무인으로 완료까지 실행합니다. 어려운 점은 작업 자체가 아니라 상태 내구성 + 구체적인 park-vs-continue 시맨틱스 + 기아 방지입니다. 따라서 이 스킬은 이를 중심으로 구축되었습니다. 신뢰성 기반이 먼저 제공되었고(BUILD-PLAN.md 참조), 그 위에 더 무거운 다중 모델 검토 깔때기가 추가되었으며 지금은 구축되었습니다(아래 "스파인 위에 구축된 품질 기계" 참조).
전체 근거:
agents-never-sleep-design.md(13개 설계 스레드 + 3번의 위원회 검토). MVP 기반은agents_never_sleep/아래에 작은 Python 패키지로 구현되었으며(이전 가져오기 이름harness는 1.x 전체에서 하위 호환성을 위해 여전히 작동합니다),acceptance/run_acceptance.py로 검증되었습니다(이는 "중간 실행 중단"이라는 고통에 매핑되는 유일한 테스트입니다).
자율성 계약 — 세 가지 별개 상태, 절대 병합하지 않음
실행은 불확실성에 대해 정확히 세 가지 응답을 가집니다. 이를 분리하세요; 병합하는 것은 실행이 예방하려는 바로 그 지연으로 역전되는 방법입니다.
- ASK — 인간에게 질문합니다. 무인 상태에서는 금지.
AskUserQuestion을 내보내지 마십시오; 오전 2시에는 아무도 응답할 수 없으며, 단 하나의 질문이 전체 실행을 낭비합니다. 이는 규율이 아니라 구조적으로 강제됩니다:deny_ask.shPreToolUse 훅(matcherAskUserQuestion, env-gatedCLAUDE_UNATTENDED=1)은 도구를 거부하고 PARK/PROCEED로 다시 안내합니다 — 절대 중단되지 않음 보장의 반영입니다. - PARK — 이 결정 또는 티켓을 연기하고 다음 독립적인 티켓으로 실행을 계속합니다. 파킹은 정상적이고 건강하며, 중단이 아닙니다.
- HALT — 전체 실행을 중단합니다. 훅 계층이 어차피 차단할 진정으로 되돌릴 수 없는 위험, 또는 되돌리기 가능성 안전망이 전혀 없는 경우(읽기 전용 파일 시스템, VCS 없음 및 생성 불가능)에만 해당됩니다.
무인 상태에서는 PROCEED, PARK 또는 HALT만 선택합니다. 절대 ASK를 선택하지 않습니다.
PROCEED vs PARK 결정: 폭발 반경 기준 (따라서 "확실하지 않음"은 드뭅니다)
계층을 구체적으로 만드세요 — 폭발 반경이 큰 항목을 추측하고 전체 실행에 대해 자신 있게 틀리는 것이 최악의 결과이며, 파킹보다 더 나쁩니다.
Hard-PARK (절대 추측 금지): DB 스키마 / 마이그레이션 방향, 공개 또는 공유 API 계약, 보안 / 인증 / 테넌트 격리 경계, 금전 / 청구 / 가격 책정, 다른 항목이 구축하는 크로스 티켓 인터페이스, 그리고 요구사항 의미 (무엇을 구축해야 하는지 실제로 모르는 경우) — 단, 로컬에서 되돌릴 수 있고 격리된 경우는 예외입니다. 이 경우 플래그 / 드래프트 변경 뒤에 되돌릴 수 있도록 구축하고 결정을 PARK(하이브리드)합니다.
Proceed (가정 + 기록 + 계속): 이름 지정, 내부 구조, 로그 / 주석 / 오류 문구, 테스트 픽스처, 두 개의 동등한 로컬 구현 간의 선택, 쉽게 전환 가능한 기본값.
정말로 분류할 수 없는 경우 → PARK. 잘못 파킹된 작은 항목은 이후 5초 결정으로 해결됩니다; 잘못 가정된 큰 항목은 잘못된 작업 실행으로 이어집니다.
각 PROCEED 가정을 커밋하여 되돌릴 수 있도록 합니다. 스냅샷 커밋을 만들 수 없는 경우(git lock / timeout / read-only object store), 티켓을 되돌릴 수 없게 편집하는 대신 BLOCKED_ENV로 처리합니다. 모든 PARK은 다음을 기록해야 합니다: 이유, 후보 해석, 정확한 인간의 다음 조치, 그리고 그 오염 범위.
티켓별 루프 (harness가 강제하는 것)
- Preflight가 능력을 측정합니다 (
agents_never_sleep/preflight.py) — VCS/되돌리기 가능성, 플랫폼, 게이트, 실행 모드, tokonomix/Vault/Paperclip. 누락된 기능은 실행을 중단시키지 않으며, 예상 수확량을 낮추고 보수성을 높입니다. VCS 없음 → 위험한 편집 전에 안전망(git init / 타임스탬프 백업)을 설정합니다; 불가능한 경우 → 비파괴적 작업만 허용합니다. - 결정 티켓에 대해 ASK/PARK/HALT(위 참조). 무인 상태: ASK→PARK.
- 구현 PROCEED 티켓 — 당신, 에이전트가 작업자입니다: harness가 건네준 티켓을 읽고 파일을 편집합니다. 아래 두 하위 명령어를 통해 한 번에 하나의 티켓을 처리합니다; harness는 스케줄링, 파킹, 스냅샷/되돌리기 및 절대 중단되지 않음 센티널을 담당합니다.
- 게이트 결정론적으로 (
agents_never_sleep/gates.py) — BACKBONE. 실패 분류: diff에 의해 도입됨 → 하드 블록(마지막 그린으로 되돌리고 park/fail); 기존 / 불안정 / 환경 → 신뢰도 낮추고, 계속하거나 park(절대 "티켓 실패"로 보고하지 않음); 타임아웃/환경 → BLOCKED_ENV. 모든 게이트는 단계별 타임아웃과 비대화형 환경으로 실행되어 TTY 프롬프트에서 멈추지 않습니다. 그린을 만들기 위해 실패하는 테스트를 절대 삭제하거나 건너뛰지 마십시오 — 이는 차단되는 맹점입니다. - 기록 정확히 하나의 내구성 있는 결과 (
agents_never_sleep/state.py): DONE, DONE_LOW_CONFIDENCE, PARKED_DECISION, PARKED_FOUNDATIONAL, BLOCKED_ENV, FAILED_RETRYABLE, FAILED_BUG_IN_AGENT — 필수 필드와 함께. 원자적 쓰기; 재개 시 안전. - 다음 티켓. 시도 + 루프 제한(
agents_never_sleep/ledger.py)은 교차 재개 시도 제한을 초과하거나 루핑이 입증된 티켓을 강제로 park하여, 실행이 하나의 저주받은 항목에 소진되지 않도록 합니다. 낮은 수확량 회로 차단기는 대부분의 작업이 park되거나 차단된 경우 중단하고 경고합니다.
실행 방법 — 에이전트가 작업자입니다 (이 루프를 실행하세요)
대화형 세션에서 시작하기 전에, 사용자에게 채팅에서 한 번만 질문하십시오: 백로그를 이 세션에서 실행할지(포그라운드 — 터미널을 닫으면 중단됨), 아니면 bin/ans-run을 통해 로그아웃 후에도 유지되는 분리된 실행을 시작할지? 이는 설정/라우팅 결정이지, 실행 중 질문이 아닙니다 — 절대 ASK 계약을 위반하지 않으며, 당신이 묻는 유일한 질문입니다.
tokonomix 컨센서스 모드가 구성된 경우(PROCEED 페이로드의 council 블록 또는 tokonomix_* MCP 도구 사용 가능): 실행 시작 시:
- 무인 (
CLAUDE_UNATTENDED=1): 하나의 로그 라인을 내보내고 즉시 진행합니다 — 절대 차단하거나 묻지 않음:ℹ️ Tokonomix consensus active — auto-rating each council call via tokonomix_rate_consensus. - 대화형 (
CLAUDE_UNATTENDED없음): 계정에 저장된 평가 선호도가 아직 없는 경우(즉,review_feedback_opt_in이 아직 설정되지 않음 —feedback_invite가 첫 번째 컨센서스 응답에 없어서 감지 가능), 사용자에게 채팅에서 한 번 질문:"Tokonomix consensus is active. After each council call I can auto-submit a usefulness rating (score + findings) to improve model scores. Enable this? (yes/no)" 답변을
.unattended/state/consensus_rating_pref.json에 저장하여 세션 간에 한 번만 묻게 합니다. 예: 자동 평가 진행. 아니오: 평가 호출을 완전히 건너<0xC3><0xB5>니다.
첫 번째 평가 시도에서 consensus_rating_endpoint_enabled가 404를 반환하면, 한 번 맹점으로 기록하고 이 실행의 모든 후속 평가 호출을 건너<0xC3><0xB5>니다.
harness는 Python 루프 내에서 당신을 호출할 수 없으므로, 당신이 루프를 실행합니다. 백로그가 소진될 때까지 이 두 하위 명령을 번갈아 사용하십시오. 각 명령은 stdout에 하나의 JSON 객체를 출력합니다.
# 1. harness에 다음에 할 작업을 요청합니다. 모호하거나 폭발 반경이 큰 티켓을 자동으로 park하고,
# 구현 준비가 된 티켓 하나 또는 종료 신호만 전달합니다.
python3 -m agents_never_sleep.run next --repo <project> --tickets <dir-of-.md-tickets>
JSON status를 읽으십시오:
-
PROCEED→ 저장소의 파일을 편집하여ticket.body만 구현합니다(다른 티켓은 건드리지 말고, 중단하지 말고, 질문하지 마십시오). 그런 다음complete를 호출:python3 -m agents_never_sleep.run complete --repo <project> --attempted "수행한 작업에 대한 한 줄 요약"정말로 할 수 없는 경우
--cannot-implement(--attempted와 함께 이유 설명)를 사용하십시오 — harness가 부분 편집을 되돌리고 BLOCKED_ENV를 기록합니다.complete후에 다시next를 호출하십시오.PROCEED페이로드가council또는specialists블록을 전달한 경우, 검토를 실행한 것입니다 — 반드시complete에 결과를 다시 제공해야 합니다. 그렇지 않으면 자문 신뢰 게이트가 조용히 발동되지 않습니다:... complete --attempted "…" [--council-verdict pass|concerns|error --council-cost <€>] \ [--specialist-concerns architect,security,… --specialist-cost <€>] [--review-coverage "<실행한 사람>"]. 그러한 검토를 실행하지 않은 경우에만 플래그를 생략하십시오. (자세한 내용은 아래 Council 및 Specialist 섹션을 참조하십시오.) -
PARK_CONSENSUS_ELIGIBLE→ 티켓이 모호한 요구사항 의미에 대해서만 PARK(절대 hard-PARK 범주 아님)를 할 것입니다. 페이로드의prompt가 요청하는 grounded tokonomix 컨센서스를 실행하십시오(병렬 + 블라인드 제안자, 분리된 판정자) — 절대 "진행해야 합니까?"와 같은 자유 형식 텍스트를 묻지 마십시오. 이는 프롬프트가 명시적으로 금지하는 위험한 프레이밍입니다. 그런 다음 구조화된 평결을 보고하고, 오퍼 페이로드의attempt_id를 다시 에코하십시오:... resolve-park --ticket-id <id> --attempt-id <오퍼 페이로드의 attempt_id> --resolved \ --chosen-reading "<해석>" --evidence "<인용된 정확한 증거>" --dissent-count <N> \ --synthesis-text "<판정자 종합>"또는 컨센서스가 인용된 증거로 구별할 수 없는 경우
--not-resolved를 사용하십시오. harness의 결정론적 게이트가 유일한 중재자입니다 — 해결된 평결은 일반PROCEED흐름(구현 후 평소대로complete)으로 라우팅됩니다; 거부된 평결은 감사 추적과 함께 티켓을 park하고 다음으로 넘어갑니다. 동일한 티켓에 대한 중복resolve-park는 항상 안전한 no-op입니다(ALREADY_RESOLVED). (자세한 내용은 아래 F5 섹션을 참조하십시오.) -
DRAINED/HALTED/LOW_YIELD→ 실행이 종료되었습니다; 실행 보고서가 작성되었습니다. 중단하십시오. -
NON_DESTRUCTIVE→ 저장된 구성 없이 무인; 먼저 대화형 구성 실행을 수행하십시오.
자체 루프를 발명하거나 조기에 중단하지 마십시오. next는 Stop-훅이 조기 중단을 차단하는 데 사용하는 .unattended/run-incomplete 센티널을 소유합니다; 종료 상태를 반환할 때까지 next를 계속 호출하십시오. harness는 스냅샷-전-편집, 게이트-후-편집, 빨간불 시 되돌리기, 시도 제한, 루프 감지 및 낮은 수확량 차단기를 처리합니다 — 당신의 유일한 작업은 편집입니다.
센티널 경로 계약(중요, 강제됨). Stop-훅은
${UE_RUN_INCOMPLETE:-$PWD/.unattended/run-incomplete}를 확인하고 드라이버는 동일한 경로를 씁니다. 이것들은 에이전트가 저장소 루트에서 실행될 때만 자동으로 일치합니다($PWD == --repo;--repo .사용). CWD가--repo(cron /claude-run)와 다를 수 있는 무인 실행의 경우, 시작 시UE_RUN_INCOMPLETE=<repo>/.unattended/run-incomplete를 내보내십시오. 절대 중단되지 않음이 조용히 깨지는 것을 방지하기 위해,next는 무인 + CWD ≠--repo+UE_RUN_INCOMPLETE설정되지 않음일 때 하드 실패(status:"ERROR", exit 2)합니다 — 저장소로 cd하거나 환경 변수를 설정하여 시작을 수정하십시오.
첫 번째 대화형 실행은 최소한의 프로젝트별 마법사(.claude/agents-never-sleep.json)를 트리거합니다. 스킬은 스스로 예약하지 않습니다 — 무인 실행(cron / claude-run)은 항상 사용자의 명시적 행위이므로, 마법사가 항상 먼저 실행됩니다. 구성 없는 무인 → 비파괴적 전용 + 보고서에 큰 메모.
밀폐된 승인 데모(
acceptance/run_acceptance.py)는 결정론적DemoWorker로 루프를 프로세스 내에서 구동하여 자체 테스트만 수행합니다 — 프로세스 내run하위 명령은 없습니다. 실제 실행은 항상 위의next/complete흐름을 사용합니다.
실행 시작 — bin/ans-run (사전 토큰 사전 점검 + 작업 트리 잠금)
agents_never_sleep/preflight.py는 에이전트 세션이 부팅된 후에 능력을 측정합니다 — 그때까지 첫 번째 토큰은 이미 사용되었고 실패할 실행은 이미 비용이 발생했습니다. 헤드리스/cron 실행의 경우, 대신 launcher를 통해 시작하십시오:
bin/ans-run [--repo <project>] [--agent <preset>] [--fg] [--check] [--trust] "<프롬프트>"
이는 에이전트 CLI가 부팅되기 전에 실행되는 결정론적 GO/NO-GO 게이트입니다:
- config trust (TOFU) —
.claude/agents-never-sleep.json은 저장소와 함께 이동하며 launcher가 실행하는 명령(에이전트 argv, 호스트 검사)을 설명합니다. 새로 추가되거나 변경된 구성은 사용자당 한 번 신뢰되어야 합니다 — 프롬프트에서 대화식으로, 또는 검토 후ans-run --trust를 명시적으로 사용합니다. 헤드리스 + 신뢰되지 않음 = NO-GO. 신뢰는 저장소 외부에 기록됩니다(~/.config/agents-never-sleep/trusted.json, 구성의 SHA-256을 키로 사용) — 저장소는 스스로를 보증할 수 없습니다.make install보다 덜 신뢰하는 저장소에서 ans-run을 절대 실행하지 마십시오. - 신원 — 구성 가능한
launcher.target_user+ 루트 가드: 대상 사용자가 구성된 상태에서 루트로 시작 → 해당 사용자로 재실행; 구성되지 않은 루트로 시작 → NO-GO (무인 실행은 절대 루트로 실행되어서는 안 됨), - 에이전트 선택 —
launcher.agents아래의 명명된 프리셋,--agent또는launcher.default_agent로 선택됨. 시작 시 플랫폼 감지는 없습니다(세션 환경 마커는 스푸핑 가능하고 cron 아래에서는 사라짐); 마법사가 감지 — 사전 채움 힌트로서 — 및 인간 결정이 있는 곳입니다. 프리셋당 세 가지 게이트: argv[0]은 알려진 에이전트 CLI(claude/codex/gemini/copilot)여야 함(신뢰된 구성의launcher.allow_custom_agent로만 재정의 가능), 바이너리는 5초--version능력 프로브(토큰이 소비되기 전에 플래그 표류를 포착)를 통과해야 함, 그리고autonomy_confirmed가 true여야 함(아래 참조), - 자격 증명 —
launcher.credentials_paths는 구성된 경우 차단하고, 구성되지 않은 경우 경고 전용(키체인 및 API 키 설정에는 자격 증명 파일이 없음), - 저장소 상태 — git 사용 가능(의심스러운 소유권 포착), 저장소 쓰기 가능, 디스크 공간(
launcher.min_disk_mb), 더티/스테이징된 트리가 경고로 표시됨, - 호스트 검사 — 서비스/DB 프로브는
launcher.checks에서만 비롯됨([{"name", "command", "blocking"}]); 사이트별 항목은 launcher에 하드코딩되지 않음.
종료 코드: 0 시작됨/GO · 64 NO-GO · 65 작업 트리 사용 중.
자율성 플래그는 명시적인 인간 결정입니다 — 절대 기본값이 아님
CLI의 권한 시스템이 완전히 켜진 상태에서 분리된 실행은 첫 번째 승인 프롬프트에서 멈춥니다(stdin은 닫혀 있고 아무도 보고 있지 않음); 이를 방지하는 플래그는 진정한 권한을 부여합니다. 제공된 맵(agents_never_sleep/agent_clis.py, 마법사 + launcher에 대한 단일 소스)은 두 변종을 분리하고, 마법사는 확인하도록 요청하기 전에 플래그가 부여하는 것을 보여줍니다 — 그런 다음에만 프리셋이 autonomy_confirmed를 기록하고 실행 가능해집니다...