저희 회사(Joinclass LLC, 직원: CEO 1명)에서는 개발, 출판, 마케팅 등 여러 부서의 Claude Code 에이전트를 launchd로 구동하고 있습니다. 처음에는 '매분 기동 및 전 부서 상시 가동' 방식이었습니다. 업무는 진행되었지만, 같은 파일을 여러 에이전트가 동시에 수정하여 충돌하거나, 1회 차이(diff)가 너무 커서 사람이 읽을 수 없어 승인되지 못한 채 쌓이는 문제가 발생했습니다.
과거에는 AI가 git push --force를 실행하여 브랜치가 사라진 적도 있습니다. 차이가 커서 내용을 추적할 수 없으면, 이런 사고를 인지하는 것도 늦어집니다.
그래서 2026년 11월 16일에 운영 방식을 변경했습니다. 아침에 '일일 계획표'를 작성하고, 각 부서는 이 표의 단 한 줄만 받아 움직이는 방식입니다. 본문에서는 그 시스템 구현과, 태스크를 '사람이 검토 가능한 단위'로 분할하는 규칙을 소개합니다.
본문에서 알 수 있는 것:
- 태스크의 세분화 기준 3가지 (차이의 크기가 아닌 '접근 파일' 기준으로 분할)
- Markdown 표를 작업 큐(Work Queue)로 만들어 한 줄씩 받아 처리하는 구현 방법 (Python)
- 같은 부서를 중복으로 기동하지 않도록 하는 배타적 제어(Exclusive Lock, Shell)
- 착수 전에 '파일이 겹치는 태스크'를 찾아내는 검사
제가 시행착오를 거쳐 결정한 기준은 다음 세 가지입니다.
| 기준 | 내용 | 이유 |
|---|
| 결과물이 하나일 것 | 1태스크로 만들거나 수정하는 것은 단 하나여야 함. 결과란에 경로(Path)를 한 개만 적을 수 있어야 함 | 결과를 한 줄로 적지 못하는 태스크는 너무 큼 |
| ... | | |
핵심은 두 번째입니다. '줄 수로 작게 나누기'보다 '접근 파일(touching file)로 나누는 것'이 충돌에 직접적으로 영향을 줍니다. 작은 태스크가 10개 있어도, 전부가 STATE.md를 수정한다면 충돌합니다. 반대로 공유 파일(상태 파일/로그)은 에이전트가 직접 접근하게 하지 않고 작업 주체(Job side)가 마지막에 모아서 작성하도록 했습니다.
계획표는 사람이 읽을 수 있는 것을 최우선으로 하여 일반 Markdown 표로 만들었습니다. .company/daily-plan/2026-11-19.md의 형태는 다음과 같습니다.
| # | 부서 | 상태 | 업무 | 결과 |
|---|---|---|---|---|
| 1 | dev | 완료 | Qiita 배포 작업 리트라이 판정 수정 | .company/scripts/qiita-publish.sh |
...
상태는 미착수 / 진행 중 / 완료 / 승인 대기 / 보류 / 미완료의 6가지뿐입니다. 저는 아침에 이 표만 보면 그날 무슨 일이 일어날지 전부 알 수 있습니다. 검토 대상은 '완료'와 '승인 대기' 행만 확인하면 되고, 결과란의 경로를 열어보면 됩니다.
각 부서의 작업(Job)은 이 표에서 '자신의 부서에 해당하는 첫 번째 미착수'를 단 하나 가져가고, 그 자리에서 '진행 중'으로 수정합니다. 실제로 작동하는 코드를 발췌했습니다 (.company/scripts/lib/daily-plan.py에서 발췌).
import datetime as dt
import sys
from pathlib import Path
...
사용법:
$ python3 .company/scripts/lib/daily-plan.py next dev
1 Qiita 배포 작업 리트라이 판정 수정
$ echo $?
...
설계상 효과를 본 부분은 finish의 동작입니다. 에이전트가 상태를 작성하지 않고 끝났을 경우, 자동으로 재시도하지 않고 '미완료'로 멈춥니다. 자동 리트라이를 하면 같은 실패를 반복하여 차이(diff)만 불어날 뿐이기 때문입니다. 멈춘 행은 다음 날 아침 계획에서 사람이 (또는 계획 담당 에이전트가) 다시 할당합니다.
호출 측의 쉘 스크립트입니다 (.company/scripts/idle-work.sh에서 발췌).
label="idle-$dept"
log="$SCRIPT_DIR/logs/$label.log"
# 같은 부서로 중복 실행되지 않도록 함 (mkdir은 존재하면 실패함 = 원자적 잠금)
...
그리고 에이전트에게 주는 프롬프트에서, 계획에 없는 업무를 처리하지 않을 것을 명시했습니다.
common="
작업을 마치면 계획표 ${plan_rel}의 #${num} 행 상태를 '완료 / 승인 대기 / 보류 / 미완료' 중 하나로 수정하고, 결과란에 한 줄(결과물의 경로)을 작성해 주세요.
계획표의 다른 행이나, 계획에 없는 업무에는 손대지 마세요.
...
‘이왕 하는 김에 이것도 고쳐 놓았습니다’라는 문구를 금지하는 것이 검토 가능한 차이점(diff)을 유지하는 가장 저렴한 방법이었습니다.
. flock
macOS에는 기본적으로 제공되지 않는 mkdir 기반의 락(lock)을 사용합니다. 추가 설치가 필요 없지만, 만약 kill -9로 프로세스가 종료되면 trap이 작동하지 않아 락 파일이 남게 됩니다. 따라서 로그에 “건너뜀(skip)” 메시지가 계속 나타나면 /tmp/one-ceo-*.lock 파일을 확인합니다.
- 에이전트가 공유 파일에 직접 쓰지 못하게 한다. 당사에서는 부서의
STATE.md 업데이트를 별도의 작업(job)이 취합하여 작성합니다. 모든 에이전트가 동일한 파일을 건드리는 구조는, 아무리 세밀하게 작업을 분할해도 충돌을 일으킵니다.
- 푸시(push) 충돌은 ‘수정하지 않고 중단’시킨다. 개발 부서만
git push를 허용하고 있지만, 프롬프트에는 “원격 저장소(remote)가 먼저 진행된 경우 fetch하여 rebase 하고, 충돌이 발생하면 push 하지 않고 ‘미완료’로 표시하며 이유를 작성하라”고 지시합니다. AI에게 충돌 해결을 맡기면 검토되지 않은 변경 사항들이 섞여 들어옵니다.
세분화 기준 2(접근하는 파일이 중복되지 않음)는 계획을 수립하는 단계에서 확인하고 싶습니다. 아래는 이 글을 위해 작성한 간단한 검사로, 계획표의 '업무' 칸에 적힌 경로를 가져와 같은 경로가 포함된 줄이 2개 이상이면 경고합니다.
#!/usr/bin/env python3
"""계획표에서 동일한 파일을 건드리는 태스크를 감지한다. 사용법: plan-overlap.py <계획표.md>"""
import re
...
$ python3 plan-overlap.py .company/daily-plan/2026-11-19.md
중복: .company/scripts/qiita-publish.sh ← #4, #7
$ echo $?
...
종료 코드 1일 때는, 둘 중 하나를 다음 날로 미루거나 두 가지 작업을 한 줄에 합칩니다. 업무 칸에 경로를 작성하는 습관이 없으면 잡아낼 수 없으므로, '업무 칸에는 접근할 파일을 작성한다' 자체를 규칙으로 만드는 것이 전제입니다.
운영 방식을 바꾼 후, 다음 세 가지로 효과를 확인하고 있습니다.
# 1) 오늘의 계획 상태별 건수 (미완료가 많을수록 = 세분화 정도가 너무 크다)
grep -E '^\| [0-9]+ ' .company/daily-plan/$(date +%F).md | awk -F'|' '{gsub(/ /,