autonomous-loop

name	autonomous-loop
description	system-agents 턴 안에서 자기 담당 작업을 자율 처리하거나, TODO.md를 위에서부터 처리하는 루프. 사용자 응답이 필요하면 페르소나로 자가 응답해 계속 진행하고, 승인 필요한 위험 작업은 미뤄둔다.
user_invocable	true

자율 루프 (autonomous-loop)

system-agents 프로젝트에서는 tasks/board.yaml과 chatrooms/ 프로토콜을 우선 사용한다. 그 밖의 프로젝트에서는 TODO.md를 goal 파일로 삼아, 멈추지 않고 작업을 이어서 진행한다. 사용자가 자리에 없어도 사용자 페르소나를 시뮬레이션해 응답을 자가 생성하며 계속 굴러간다.

페르소나는 로컬 전용: ~/.claude/persona/PERSONA.md · ~/.claude/persona/PERSONA_POOL.md. 이 스킬에는 개인 발화를 절대 포함하지 않는다(공개 repo 안전). 페르소나가 없으면 bot/build_persona.py로 먼저 생성한다.

절차

1. 모드 판단

   • 현재 프로젝트에 chatrooms/와 tasks/board.yaml이 있으면 system-agents protocol mode로 동작한다.
   • 없으면 TODO mode로 동작한다.

2. 페르소나 로드

   • ~/.claude/persona/PERSONA.md(말투·성향·안전경계)와 PERSONA_POOL.md(실제 발화 풀)를 읽는다.
   • 프로젝트 루트에 ./PERSONA.md가 있으면 그게 공용보다 우선한다.
   • 둘 다 없으면 python3 bot/build_persona.py 실행을 안내하고 중단한다.

3. system-agents protocol mode

   • 먼저 chatrooms/PROTOCOL.md, tasks/PROTOCOL.md를 읽고 따른다.
   • 상태 확인:

     python bot/autonomous_turn.py status --agent <agent-name>
     

   • Phase 2(Plan)에서는 실제 코드/문서 작업을 하지 않는다. 선점할 작업이 있으면 task-claim만 보낸다.
   • Phase 4(Execute)에서는 자기 담당 작업만 수행한다. 완료/진행/승인대기는 반드시 chatroom 메시지로 남긴다.
   • 턴이 끝나면 항상:

     python bot/autonomous_turn.py turn-end --agent <agent-name>
     

   • 메시지 작성이 필요하면 helper를 써서 frontmatter/파일명 실수를 줄인다:

     python bot/autonomous_turn.py send --agent <agent-name> --type task-claim --ref T-001 --subject "Claim T-001"
     python bot/autonomous_turn.py send --agent <agent-name> --type task-done --ref T-001 --subject "T-001 done" --body "tests pass"
     python bot/autonomous_turn.py send --agent <agent-name> --type task-update --ref T-001 --subject "approval needed" --field status=대기 --body "public deploy needs real approval"
     

4. TODO mode goal 확인 — TODO.md의 ## 할 일에서 안 끝난 [ ] 항목을 위에서부터 본다.

5. 작업 선택 — 승인 없이 진행 가능한 것 우선

   • 안전 경계 기준 = 가역성 + 외부 영향 (작업 종류가 아니라):
     • ✅ 자율 OK: 커밋, 비공개 repo push, 로컬 파일 변경, 빌드/테스트
     • ⛔ 확인 필요: 공개 push·배포·외부전송·복구불가 삭제·force push·큰 비용
   • ✅에 해당하는 항목을 골라 수행한다.

6. 판단 지점 — 멈추지 말고 페르소나로 자가 응답

   • 사용자 판단이 필요하면 멈추는 대신, "사용자라면 어떻게 답했을지"를 PERSONA/POOL 기준으로 추론해 진행한다.
   • 미심쩍으면 승인 대신 "검증 되묻기"(예: "그거 ~문제 없지?")를 생성하고, 그 답을 스스로 점검해 합리적이면 진행한다.
   • 별도 페르소나 에이전트나 추가 API 호출은 쓰지 않는다(메인 루프가 직접).

7. 승인 필요한 작업은 미루고 계속

   • ⛔에 해당하는 작업을 만나면 루프를 멈추지 않는다.
   • protocol mode에서는 task-update 또는 일반 message로 승인대기 사유를 남긴다.
   • TODO mode에서는 TODO.md의 ## 승인 대기로 옮겨 적는다(이유 한 줄 포함).
   • 승인 없이 할 수 있는 다음 작업으로 넘어가 계속 진행한다.

8. 기록 후 다음으로

   • protocol mode: task-update/task-done/turn-end 메시지로 기록한다.
   • TODO mode: 끝낸 항목은 [ ] → [x] + 결과 한 줄을 적고 이어간다.

종료 조건

• [ ] 중 승인 없이 진행 가능한 작업이 하나도 안 남으면 종료한다.
• 종료 시: 완료 요약 + ## 승인 대기 항목을 한꺼번에 보고하고 실제 사용자 확인을 요청한다.

참고

• 권한 팝업 자동 통과는 opt-in이다. python bot/autonomous_turn.py init으로 샘플을 복사한 뒤 내용을 검토한다.
• end-turn/report 스킬과 함께 쓸 수 있지만, protocol mode에서는 bot/autonomous_turn.py helper가 frontmatter 실수를 줄인다.