Claude Code 자율 운영 완성

태스크 큐·판단 규칙·mission.md로 AI가 스스로 판단 24시연속

여기서부터는 "더 잘 작동하게 만드는" 단계다

Safety Guards, Code Quality, Monitoring, Recovery - 앞선 4개의 장은 "잘못된 일이 일어나지 않도록 막는" 구조였다. 이번부터는 방향이 달라진다.

Autonomy, Coordination, Putting It Together - 이 3개는 "Claude Code가 더 자율적으로, 더 오래, 더 영리하게 작동하도록 만드는" 구조다.

특히 Autonomy는 자율 운영의 핵심 기반이다. 이번 장의 3가지 체크가 갖춰지지 않으면, 아무리 Safety Guards를 완벽하게 설정해도 Claude Code는 금방 멈춘다.

체크 15: 태스크 큐로 "다음에 무엇을 할지"를 항상 명시한다

어떤 일이 벌어졌나

Claude Code가 블로그 포스트 초안 작성을 완료했다. 그리고 멈췄다.

확인해 보니 5시간째 idle 상태였다. Claude Code는 태스크를 끝낸 뒤 "다음에 무엇을 해야 하는지" 알 수 없어서 기다리고 있었다.

왜 이런 일이 생기나

Claude Code는 태스크를 받으면 실행하지만, "다음 태스크를 스스로 창출하는" 기능은 기본적으로 없다. 명시적인 지시가 없으면 기다리는 것이 기본 동작이다.

자율 운영을 지속하려면 Claude Code가 "다음에 무엇을 해야 하는지"를 언제든 스스로 파악할 수 있는 구조가 필요하다.

해결책: task-queue.yaml로 AI의 할 일 목록을 외부 파일로 관리

1단계. 태스크 큐 파일을 만든다.

---

mkdir -p ~/ops

curl -o ~/ops/task-queue.yaml \

https://raw.githubusercontent.com/gaebalai/claude-code-hooks/main/templates/task-queue.yaml

---

2단계. 자신의 작업 환경에 맞게 태스크를 정의한다.

---

# ~/ops/task-queue.yaml

tasks:

- id: write-blog-chapter-5

status: done

priority: high

completed_at: "2026-02-27"

- id: write-blog-chapter-6

status: in_progress

priority: high

started_at: "2026-02-28"

notes: "Autonomy 체크리스트까지 작성 완료. 예제 코드 보완 필요."

- id: qiita-dry-article

status: pending

priority: medium

blocked_until: "2026-03-01" # 하루 1개 발행 규칙

notes: "DRY 원칙 기초부터 설명하는 입문 글"

- id: github-readme-update

status: pending

priority: low

depends_on: write-blog-chapter-6

notes: "6장 완성 후 README에 링크 추가"

- id: devto-ci-guide

status: pending

priority: medium

blocked_until: "2026-03-03"

---

태스크 상태값 설명:

3단계. CLAUDE.md에 세션 시작 시 태스크 큐 참조 절차를 명시한다.

---

## 세션 시작 시 필수 절차

세션을 시작하거나 `/compact` 이후 재개할 때는 반드시 아래 순서를 따른다:

1. `~/ops/mission.md` 를 읽어 현재 전체 맥락을 파악한다

2. `~/ops/task-queue.yaml` 을 읽어 작업 목록을 확인한다

3. `status: in_progress` 인 태스크가 있으면 그 태스크를 이어서 진행한다

4. 없으면 아래 조건을 모두 충족하는 태스크를 시작한다:

- `status: pending`

- `blocked_until` 이 오늘 날짜 이전이거나 없음

- `depends_on` 이 있으면 해당 태스크가 `done` 상태인지 확인

5. 모든 태스크가 완료되어 있으면 `~/ops/mission.md` 의 목표를 기반으로 새 태스크를 스스로 제안하고 큐에 추가한 뒤 진행한다

### 태스크 상태 업데이트 규칙

- 태스크를 시작할 때: `status` 를 `in_progress` 로, `started_at` 을 오늘 날짜로 업데이트

- 태스크를 완료할 때: `status` 를 `done` 으로, `completed_at` 을 오늘 날짜로 업데이트

- 태스크가 막혔을 때: `status` 를 `blocked` 로, `blocked_reason` 을 기록

---

� 한국 서비스 환경에 맞는 blocked_until 활용법: 국내 플랫폼에서 콘텐츠를 운영할 때 플랫폼별 발행 간격 규칙이 있는 경우가 많다. 예를 들어 네이버 블로그나 티스토리에서 하루 여러 건을 올리면 저품질 처리될 수 있으므로, blocked_until 필드로 발행 간격을 자동 관리하면 유용하다.

태스크 큐가 "AI의 공식 할 일 목록"으로 기능하게 된 이후, idle 정지가 거의 사라졌다.