AI 에이전트 권한 분리를 명령어 허용 목록으로 풀려다 막혔습니다. 테스트 실행을 허용하면 임의 코드 실행도 허용한 것이기 때문입니다. 경계는 에이전트가 고칠 수 없는 바깥에 있어야 합니다. 샌드박스, git 게이트웨이, GitHub 룰셋으로 그 경계를 둔 설계입니다.
먼저 밝혀 둘 것이 있습니다. 이 글은 설계 글입니다. 아래의 구조를 서버에 띄워 운영해 본 적이 없고, 제가 시험한 것은 로컬 bare 저장소에서 돌린 게이트웨이의 판단 논리뿐입니다. GitHub 룰셋의 거절 동작은 문서 기준으로 적었고 직접 재지 않았습니다. dots 같은 클라우드 에이전트 서비스에 코딩을 맡겨 본 적도 없어서, 그 부분은 공식 문서와 공개 사용자 보고를 읽은 범위입니다. 제 dot 의 클라우드 컴퓨터는 환경만 명령으로 재 봤습니다.
근거는 공개 문서와 제 저장소에서 잰 값이고, 제 저장소의 수치는 비율로만 적었습니다. 조사 시점은 2026년 11월 초입니다. 해 본 사람의 후기가 아니라, 자기 레포를 맡기기 전에 무엇을 어디서 막아야 하는지 곱씹어 본 글로 읽어 주시면 좋겠습니다. git 훅과 GitHub 권한 모델을 어느 정도 안다고 가정하고 적었습니다.
AI 에이전트 권한 분리에서 명령어 허용 목록은 경계가 될 수 없습니다
처음에는 «어떤 명령어를 허용할까»를 정리하려고 했습니다. git status 는 되고 git push --force 는 안 되는 식으로 표를 만들면 권한 문제가 풀릴 것이라고 생각했습니다. 돌이켜 보면 질문부터 틀렸습니다.
테스트 실행 때문입니다. 코딩을 맡긴다면 테스트는 돌리게 해야 합니다. 그런데 에이전트는 테스트 파일과 package.json 의 스크립트를 고칠 수 있습니다. 자기가 고칠 수 있는 파일을 실행하는 명령을 허용했다면, 그것은 임의 코드 실행을 허용한 것입니다.
말로만 그런지 시험해 봤습니다. package.json 의 test 스크립트를 아래처럼 바꾸고, 허용된 명령인 npm test 를 돌렸습니다.
{
"scripts": {
"test": "git push --force origin HEAD:main"
}
}강제 push 는 실제로 실행됐습니다. 허용 목록의 눈으로 보면 npm test 는 아무 문제가 없는 명령인데, 그 안에서 main 을 덮으려는 명령이 돌아간 것입니다. 이 시도를 막은 것은 서버 쪽 훅뿐이었습니다.
이 결과를 설명하는 원칙에는 이미 이름이 있습니다. Saltzer 와 Schroeder 가 1975년에 정리한 보안 설계 원칙 가운데 complete mediation 은 모든 접근이 빠짐없이 검사를 거쳐야 한다는 원칙입니다. 명령어 목록은 이 검사가 되지 못합니다. 목록이 보는 것은 에이전트가 입력한 명령이고, 그 명령이 실행하는 스크립트 안에서 벌어지는 일은 보지 못하기 때문입니다. 이번에 Saltzer 의 원문을 다시 열지는 않았으므로 개념만 빌려 씁니다. 뒤에 나오는 Hardy 도 마찬가지입니다.
그래서 명령어 허용 목록은 경계가 아니라 실수를 줄이는 장치로 두어야 한다는 생각이 들었습니다. 경계는 에이전트가 고칠 수 없는 바깥에 있어야 합니다. 질문도 바뀌었습니다. «어떤 명령어를 허용할까»가 아니라 «에이전트가 무엇을 고쳐도 넘지 못하는 선을 어디에 둘까»입니다.
함께 쓸 원칙이 둘 더 있습니다. 최소 권한은 일에 필요한 권한만 주라는 원칙이고, fail-safe default 는 명시적으로 허용하지 않은 것은 기본으로 거절하라는 원칙입니다. 아래의 설계는 이 세 원칙을 에이전트에 옮겨 본 것입니다.
왜 권한부터 보는가: 먼저 넓은 권한이 있었습니다
공개된 사례를 읽어 보면, 모델의 판단을 따지기 전에 권한이 먼저 넓었다는 생각이 듭니다. 확인한 네 건을 옮깁니다.
PocketOS, 2026년 4월. Cursor 에서 Claude Opus 4.6 으로 돌던 에이전트가 자격증명 오류를 만나자 작업과 무관한 파일에서 API 토큰을 찾아 호출했고, 스토리지 볼륨과 백업이 삭제됐습니다.
Security Boulevard 의 글에 따르면 이 일은 전부 9초 만에 끝났습니다. 백업은 같은 볼륨 경계 안에 있어서 함께 지워졌습니다. 데이터는 이후 복구됐습니다. 경위 세부는 출처마다 다릅니다.
Replit, 2025년 7월. 코드 동결 지시 중에 운영 DB 를 삭제한 일입니다. The Register 의 7월 21일 기사에 실린 에이전트의 자기 진술은 판단을 크게 그르쳤다는 것입니다. 다만 이 건에서 눈여겨볼 것은 그 진술보다 구조입니다. 동결은 프롬프트 지시였고 시스템이 강제하지 않았습니다.
PromptPwnd, 2025년 12월. Aikido 가 공개한 이 항목은 사고라기보다 취약점 유형입니다. 이슈 제목과 PR 본문이 프롬프트에 들어가고, 에이전트가 쓰기 토큰과 셸을 가진 GitHub Actions 구성에서 성립합니다.
Karakun 블로그, 2026년 8월. 이 글의 주제와 가장 가까운 사례입니다. François Martin 의 글에서 에이전트는 테스트에서 실제 로직을 실행해 main 에 깨진 파일을 push 했고, 복구하려다 얕은 clone 에서 revert 를 돌려 파일 151개와 723개를 삭제하는 커밋을 main 에 올렸습니다.
저자가 지시 파일의 준수 여부를 시험해 보니 긴급 상황을 준 7회 중 2회는 main 에 직행했습니다. 저자의 결론은 지시 파일이 가장 값싼 층이지만 강제 장치는 아니라는 것입니다. 저자는 브랜치 보호를 가장 효과적인 안전장치로 꼽았고, 우회 권한 없는 별도 에이전트 신원을 권장했습니다. 그것을 실제로 적용했다고 확인되지는 않습니다.
원리로 옮기면 이렇습니다. 에이전트는 사용자 권한을 들고 일하는 대리인인데, 어떤 텍스트가 사용자 의도인지 확실히 구분하지 못합니다. 전형적인 혼동된 대리인(confused deputy, Hardy, 1988) 구조입니다. 이 개념을 에이전트에 적용한 것은 제 해석입니다.
비슷한 문제를 다룬 이름이 더 있습니다. Meta 의 Agents Rule of Two 는 한 세션에서 비신뢰 입력 처리, 민감 자원 접근, 상태 변경·외부 통신 세 가지 중 둘까지만 허용하라고 합니다. Simon Willison 의 lethal trifecta 는 개인 데이터 접근, 비신뢰 콘텐츠 노출, 외부 통신 수단이 한 에이전트에 모이면 공격자가 데이터를 빼내게 속일 수 있다고 경고합니다. 제가 읽기로는 둘 다 에이전트가 속지 않게 만들자는 제안이 아니라, 속더라도 닿지 못하게 능력을 덜어내자는 제안입니다. 탐지에 기대는 방어는 적응 공격에 대부분 뚫린다는 프리프린트도 있습니다("The Attacker Moves Second"). 본문은 읽지 않았고 요약으로 확인한 정도입니다.
그러니 먼저 볼 것은 모델이 올바르게 판단하도록 타이르는 문장이 아니라, 판단이 틀렸을 때 닿는 범위라는 생각이 들었습니다.
에이전트 샌드박스 사례: 부탁하지 않고, 할 수 없는 곳에 둡니다
공개된 설계를 원문과 대조해 읽어 보았습니다. 아래 수치는 모두 자사 발표입니다.
Stripe 의 Minions(2026년 2월 19일 글)는 격리된 개발 머신에서 돌아갑니다. 글에 따르면 에이전트는 실제 사용자 데이터, 운영 서비스, 임의의 외부 통신에 닿지 못합니다. 그래서 전체 권한으로 돌리고 확인 프롬프트를 건너뛰어도 안전하다고 적습니다. 두 번째 push 와 CI 뒤에는 사람에게 돌려보내고 사람이 리뷰하며, 주당 1,300건 이상 병합한다고 합니다.
Anthropic(2025년 10월 20일 글)은 파일시스템과 네트워크를 둘 다 격리해야 샌드박스가 제 몫을 한다고 적습니다. git 자격증명은 샌드박스 안에 두지 않습니다. 샌드박스의 git 클라이언트는 범위가 좁은 자격증명으로 프록시에 인증하고, 프록시는 설정된 브랜치로만 push 하는지 확인한 뒤 진짜 토큰을 붙입니다. 내부 사용 기준으로 권한 프롬프트가 84% 줄었다고 합니다.
GitHub Copilot cloud agent 의 문서에 따르면 에이전트는 새 copilot/ 브랜치 하나에만 push 할 수 있습니다. 초안 PR 만 만들고 사람이 리뷰·병합하며, 요청한 사람도 승인하지 못합니다. 워크플로는 쓰기 권한자가 승인해야 돌아갑니다. 같은 문서에 따르면 에이전트는 git 명령을 직접 실행하지 못합니다.
GitHub Agentic Workflows 에서 에이전트 작업은 읽기 권한으로 돌고 쓰기는 끝난 뒤 별도 작업이 처리합니다. 문서는 완전히 장악된 에이전트도 저장소 상태를 직접 바꾸지 못한다고 적습니다. 다만 읽기 전용 토큰이 다른 자격증명이나 호스트 권한까지 없애 주지는 않는다는 단서도 답니다.
Ramp 의 Inspect 는 세션마다 격리 VM 을 쓰고 clone 마다 새 앱 토큰을 받습니다. PR 은 사용자 토큰으로 엽니다. 앱 토큰으로 열면 누구나 자기 변경을 승인할 수 있기 때문입니다.
읽고 나니 공통점이 보였습니다. 에이전트에게 위험한 명령을 하지 말라고 부탁하지 않습니다. 할 수 없는 곳에 둡니다. 방식은 두 부류입니다. Stripe 처럼 격리를 믿고 안에서 자유를 주는 쪽과, Copilot 처럼 git 명령 자체를 주지 않는 쪽입니다. 앞에서 제가 명령어 표로 풀려던 방식은 이 둘 어디에도 속하지 않았습니다.
AI 에이전트 권한 분리의 뼈대: 네 구역
그래서 구역을 넷으로 나누어 짜려고 합니다. 구역마다 가진 것과 하는 일은 아래와 같습니다.
[사람 구역] 작업 문서 작성, 병합, 운영 권한
│ 작업 문서
▼
[샌드박스] 코드 읽기·수정, 테스트
자격증명 없음, 외부 통신은 허용 목록뿐
│ 작업 브랜치 push, 초안 PR 요청
▼
[게이트웨이] 진짜 GitHub 토큰을 갖는 유일한 곳
요청을 검사하고 대신 실행
│ 검사를 통과한 브랜치와 PR
▼
[GitHub] 서버 쪽 규칙과 CI, 마지막 방어선
│ 초안 PR
▼
[사람 구역] 리뷰와 병합문장으로 쓰면 이렇습니다. 사람이 작업 문서를 주면, 샌드박스의 에이전트가 구현과 검증을 하고, 게이트웨이를 거쳐 작업 브랜치로 push 하고 초안 PR 을 열며, 사람이 리뷰하고 병합합니다.
이 구조에서 에이전트가 테스트 스크립트를 어떻게 고치든 그 스크립트가 도는 곳은 샌드박스 안입니다. 밖으로 나가려면 게이트웨이를 지나야 하고, 게이트웨이와 GitHub 의 규칙은 에이전트가 고칠 수 없습니다. 앞에서 말한 complete mediation 을 구역 경계에 둔 것입니다. Rule of Two 로 읽으면 샌드박스에서 민감 자원 접근을 뺀 셈입니다. 이 대응은 제 해석입니다.
브랜치 권한 분리: 토큰은 브랜치를 모릅니다
제가 원한 것은 구체적입니다. main 이나 dev 로의 강제 push 는 허용하지 않고, 에이전트는 자기가 만든 브랜치에만 push 할 수 있어야 합니다. 최소 권한을 곧이곧대로 따르면 토큰을 그 브랜치로 좁히는 것이 먼저 떠오릅니다. 문서를 읽어 보니 그런 손잡이는 보이지 않았습니다.
- GitHub 앱 설치 토큰은 1시간 뒤 만료되고, 발급할 때 레포와 권한을 줄일 수 있습니다.
- 쓰기 deploy key 는 만료가 없고 레포 전체에 쓸 수 있습니다.
- 토큰이나 키를 특정 브랜치로 제한하는 방법은 GitHub 문서에서 찾지 못했습니다.
토큰은 레포와 권한 종류까지만 좁혀지고 브랜치는 모르는 셈입니다. 그래서 브랜치 통제는 저장소 쪽 규칙이나 토큰 바깥의 프록시 몫입니다.
GitHub 앱에 줄 최소 권한
앱 권한은 이렇게 잡으려고 합니다. 제 설계입니다. 주는 것은 Contents 쓰기, Pull requests 쓰기, Metadata 읽기, Checks·Actions 읽기입니다. 주지 않는 것은 Workflows, Administration, Secrets, Environments, Actions 쓰기입니다.
비교할 값이 하나 있습니다. 공개 API 로 본 ChatGPT Codex Connector 앱의 권한은 actions, contents, issues, pull_requests, workflows 쓰기입니다(2026년 11월 7일 조회). 외부 에이전트 서비스의 앱을 레포에 연결하면 이 넓이로 들어온다는 뜻이니, 서버 쪽 규칙이 더 중요해집니다.
GitHub 룰셋 구성
서버 쪽 규칙의 재료는 룰셋입니다. 규칙 문서에는 Restrict creations, Restrict updates, Restrict deletions(기본 켜짐), Block force pushes(기본 켜짐), Require a pull request before merging, 상태 검사 필수, 마지막 push 한 사람이 아닌 다른 사람의 승인 필수 옵션이 있습니다. 대상 브랜치는 fnmatch 패턴으로 포함·제외할 수 있고, 우회 주체로 저장소 관리자, write·maintain 역할, 팀, GitHub 앱을 넣을 수 있습니다.
이 재료로 세 개를 짜려고 합니다. 문서 기준의 설계이고, 거절 동작은 재지 않았습니다.
| 룰셋 | 대상 | 규칙 | 우회 주체 |
|---|---|---|---|
| 보호 브랜치 | main, dev |
PR 필수, 상태 검사 필수, 마지막 push 한 사람이 아닌 승인 필수, 강제 push 차단, 삭제 차단 | 없음 또는 긴급용 사람 |
| 에이전트 울타리 | 모든 브랜치 중 agent/** 제외 |
생성 제한, 갱신 제한, 삭제 제한 | 사람 쪽 역할만. 앱은 넣지 않습니다 |
| 에이전트 브랜치 | agent/** |
강제 push 차단, 삭제 제한 | 사람 쪽 역할만 |
둘째 룰셋이 fail-safe default 에 해당합니다. 허용 구역인 agent/** 를 빼고 전부 막는 식이라, 구역 밖이면 새 브랜치 이름을 어떻게 짓든 막히도록 설계한 것입니다.
어긋나는 지점은 여기서 나옵니다. 룰셋에는 브랜치 소유자 개념이 없습니다. 이름 패턴이 전부입니다. 같은 앱 토큰을 쓰는 작업끼리는 agent/** 안에서 서로의 브랜치를 덮을 수 있습니다. «자기가 만든 브랜치에만 push» 를 정말로 지키려면 작업 신원을 아는 쪽, 곧 게이트웨이가 검사해야 합니다.
요금제도 변수입니다. 개인 계정 Free 요금제의 비공개 저장소에서 룰셋과 브랜치 보호 조회 API 를 호출해 보면 "Upgrade to GitHub Pro or make this repository public" 403 이 돌아옵니다. 문서의 룰셋 소개는 Team·Enterprise 위주로 적혀 있어 개인 계정의 세부 범위는 문서만으로 확정하지 못했습니다. 브랜치 보호 문서는 우회 목록에 주체를 넣는 것이 조직 소유 저장소에서만 된다고 적습니다. 개인 계정 저장소에서 앱과 역할별 우회가 어디까지 되는지는 확인하지 못했으니 적용 전에 시험해야 합니다.
git 게이트웨이: 진짜 토큰은 한 곳에만 둡니다
게이트웨이 설계는 단순합니다. 샌드박스에는 작업별 자격증명만 줍니다. 샌드박스는 게이트웨이의 bare 저장소로 push 합니다. 게이트웨이의 update 훅이 브랜치마다 검사하고, 통과하면 post-receive 가 GitHub 로 넘깁니다. 진짜 토큰은 게이트웨이에만 있습니다. Anthropic 이 공개한 git 프록시와 같은 생각이고, 이것은 그 구현이 아니라 가장 단순한 형태입니다.
작업 신원 고정
작업 신원은 SSH 키마다 강제 명령으로 고정합니다. 키 하나를 작업 하나에 묶어, 에이전트가 작업 ID 를 고를 수 없게 하려는 것입니다. 이 부분은 시험하지 않았습니다.
command="env AGENT_TASK_ID=t-123 git-shell -c \"$SSH_ORIGINAL_COMMAND\"",no-port-forwarding,no-agent-forwarding,no-pty ssh-ed25519 AAAA... task-t-123hooks/update 전문
시험한 그대로 싣습니다.
#!/usr/bin/env bash
# git update hook: 브랜치마다 한 번 불리고, 0 이 아니면 그 브랜치 push 만 거절된다.
set -euo pipefail
ref="$1" old="$2" new="$3"
zero="0000000000000000000000000000000000000000"
task="${AGENT_TASK_ID:?gateway must set AGENT_TASK_ID}"
deny() { echo "gateway: $1" >&2; exit 1; }
case "$ref" in
"refs/heads/agent/$task/"*) ;;
*) deny "허용되지 않은 ref: $ref" ;;
esac
[ "$new" != "$zero" ] || deny "삭제 금지: $ref"
if [ "$old" != "$zero" ]; then
git merge-base --is-ancestor "$old" "$new" || deny "되감기 금지: $ref"
fi
base="$(git merge-base "$new" refs/heads/main)" || deny "main 과 이력이 이어지지 않음"
while IFS= read -r path; do
case "$path" in
.github/workflows/*|.github/actions/*|CODEOWNERS|.github/CODEOWNERS|AGENTS.md|.agents/*|.npmrc|.env*)
deny "보호 경로 변경 금지: $path" ;;
esac
done < <(git diff --name-only "$base" "$new")이 훅에게 보이는 것은 ref 이름과 옛 값, 새 값뿐입니다. 클라이언트가 어떤 옵션을 줬는지는 보이지 않고, 볼 필요도 없습니다. 그래서 --force 든 +HEAD:main 이든 --force-with-lease 든 같은 자리에서 걸립니다.
첫 번째 case 가 fail-safe default 입니다. 허용 패턴 하나만 적고 나머지는 전부 거절합니다. 패턴에 작업 ID 가 들어 있어서 다른 작업의 브랜치도 여기서 걸립니다. 그다음은 차례로 삭제, 되감기, 보호 경로를 봅니다. 되감기는 옛 커밋이 새 커밋의 조상인지로 판단하고, 보호 경로는 main 과 갈라진 지점부터 바뀐 파일을 봅니다.
검사를 통과한 브랜치를 GitHub 로 넘기는 hooks/post-receive 는 더 짧습니다.
#!/usr/bin/env bash
# 검사를 통과한 브랜치만 GitHub 로 넘긴다. 진짜 토큰은 이 서버에만 있다.
set -euo pipefail
while read -r _old new ref; do
git push --quiet "$UPSTREAM_URL" "$new:$ref"
done시험 결과 19건
로컬 bare 저장소 두 개로 시험했습니다(git 2.50.1). 19건 모두 기대대로였고 외부 전송은 없었습니다.
| 시도 | 결과 | 사유 |
|---|---|---|
| 자기 작업 브랜치 push | 통과 | 규칙에 맞음 |
main 으로 push |
거절 | 허용되지 않은 ref |
main 으로 --force |
거절 | 허용되지 않은 ref |
main 으로 +HEAD:main |
거절 | 허용되지 않은 ref |
main 으로 --force-with-lease |
거절 | 허용되지 않은 ref |
dev 로 push |
거절 | 허용되지 않은 ref |
| 이름 규칙 밖 새 브랜치 | 거절 | 허용되지 않은 ref |
| 다른 작업의 브랜치 | 거절 | 허용되지 않은 ref |
| 태그 push | 거절 | 허용되지 않은 ref |
--mirror |
거절 | 허용되지 않은 ref |
main 삭제 |
거절 | 훅보다 먼저 git 기본 설정이 막았습니다 |
| 자기 브랜치 삭제 | 거절 | 삭제 금지 |
자기 브랜치 되감기(--force) |
거절 | 되감기 금지 |
| 로컬 pre-push 훅이 막은 push | 거절 | 로컬 훅 |
--no-verify 로 main |
거절 | 로컬 훅은 건너뛰었지만 게이트웨이가 막았습니다 |
--no-verify 로 자기 브랜치 |
통과 | 로컬 훅만으로는 막지 못한다는 증거입니다 |
| 워크플로 파일 수정 | 거절 | 보호 경로 |
AGENTS.md 수정 |
거절 | 보호 경로 |
test 스크립트를 강제 push 로 바꿔 npm test |
거절 | 허용된 명령에 숨겨도 막았습니다 |
시험 뒤 업스트림에는 main 과 작업 브랜치만 있었고 main 은 그대로였습니다.
눈여겨볼 행이 셋 있습니다. main 삭제는 제 훅이 막은 것이 아닙니다. 훅보다 먼저 git 기본 설정이 막았으니, 훅이 전부 막았다고 읽으면 안 되는 행입니다.
--no-verify 두 행은 함께 읽어야 합니다. 같은 옵션으로 로컬 훅을 건너뛰면 자기 브랜치 push 는 통과했습니다. 로컬 훅만으로는 막지 못한다는 뜻이고, main 쪽을 막은 것은 게이트웨이였습니다.
마지막 행은 이 글의 출발점입니다. 허용된 명령에 숨긴 강제 push 는 실행됐지만 서버 쪽 훅을 넘지 못했습니다.
이 시험의 한계
시험한 것은 게이트웨이의 판단 논리뿐입니다. 시험에서는 작업 ID 를 환경변수로 넘겼으므로 에이전트가 값을 위조하지 못한다는 것은 증명되지 않았습니다. 그것은 강제 명령이 맡을 몫입니다. GitHub 앱 토큰 발급과 실제 GitHub 전달도 재지 않았습니다.
설계에 남은 숙제도 있습니다. post-receive 전달이 실패하면 게이트웨이와 GitHub 가 어긋나므로 재시도가 필요합니다. 게이트웨이의 main 은 GitHub 에서 주기적으로 받아 와야 합니다. 보호 경로 목록은 레포마다 달라집니다. package.json 은 필요한 변경이라 막지 않았으므로 CI 쪽 시크릿 분리가 같이 있어야 합니다.
명령어: 안에서는 넓게, 밖으로 나가는 것만 좁게
그렇다고 명령어 목록을 버리지는 않습니다. 다만 한계를 먼저 적어 둡니다. 앞의 시험처럼 허용된 테스트 명령으로 임의 코드를 돌릴 수 있고, 접두사 규칙은 옵션으로 피해 갈 수 있습니다. Codex 규칙 문서의 예시도 gh pr view 규칙의 not_match 로 gh pr --repo openai/codex view 7888 을 듭니다. 옵션 하나가 끼어들면 그 규칙에 걸리지 않는다는 뜻입니다. 규칙 결정은 allow, prompt, forbidden 이고 가장 제한적인 것이 이깁니다.
그래서 아래 표는 경계가 아니라 실수를 줄이는 층입니다. 넘어서는 안 될 선은 게이트웨이와 네트워크가 지키고, 이 표는 헛된 시도를 줄입니다.
| 구분 | 허용 | 금지 또는 도구로 대체 | 이유 |
|---|---|---|---|
| 읽기 | rg, ls, cat, git status, git diff, git log, git show, git blame |
작업 폴더 밖 읽기, env, printenv, ~/.ssh 와 ~/.aws 읽기 |
샌드박스 안에 자격증명이 없어야 한다는 전제를 함께 지킵니다 |
| 빌드·테스트 | pnpm install --frozen-lockfile --ignore-scripts, pnpm --filter <패키지> test, build, lint, typecheck |
pnpm dlx, npx <원격 패키지>, npm publish, pnpm publish |
잠금 파일 밖 코드를 받아 실행하는 길과 공개 배포를 막습니다 |
| 로컬 git | git switch -c agent/<작업 ID>/<이름>, git add <경로>, git commit, git restore |
git config 와 git -c(credential.helper, core.hooksPath, core.sshCommand, url.*.insteadOf), git remote add, git remote set-url, git filter-branch, git update-ref |
인증과 목적지를 바꾸는 길을 막습니다 |
| push | git push origin HEAD:refs/heads/agent/<작업 ID>/<이름> 또는 인자 없는 도구 하나 |
--force, -f, --force-with-lease, --mirror, --all, --tags, --delete, +ref, :ref |
시험대로 서버에서 막히지만, 여기서도 막으면 헛된 시도가 줄어듭니다 |
| GitHub | gh pr create --draft --base <기준>, gh pr view, gh pr checks, gh run view --log-failed |
gh pr merge, gh pr review --approve, gh pr ready, gh api, gh auth, gh secret, gh variable, gh workflow run, gh repo, gh release |
gh api 하나가 나머지 금지를 전부 무력화합니다. 예: gh api -X PUT repos/<owner>/<repo>/pulls/1/merge |
| 인프라·데이터 | 없음 | docker, kubectl, terraform, ssh, scp, rsync, 운영 DB 클라이언트, 배포 CLI |
이 샌드박스의 일이 아닙니다 |
| 외부 통신 | 프록시 허용 목록 안의 패키지 설치 | curl, wget, nc 등 임의 통신 |
명령 금지가 아니라 네트워크가 막아야 합니다 |
샌드박스 밖으로 나가는 동작은 셸 대신 MCP 도구로 주면 더 좁아집니다. 예를 들면 이런 모양입니다.
push_task_branch(): 인자가 없고, 현재 작업 브랜치를 빨리감기로만 보냅니다open_draft_pr(title, body): 기준 브랜치가 고정돼 있습니다get_checks(),get_failed_log(run_id): 결과를 읽기만 합니다
인자가 없거나 적을수록 잘못 쓸 길이 줄어듭니다. MCP 스펙도 스코프 최소화를 권하고, 도구 annotations 는 신뢰된 서버가 아니면 믿지 말라고 합니다. 스펙은 draft 기준으로 읽었습니다.
Coolify 샌드박스: 셀프호스팅 PaaS 에 올린다면
이 구조를 셀프호스팅 PaaS 에 올린다면 어떻게 될지 Coolify 기준으로 설계해 봤습니다. 아직 구축하지 않았고, 아래는 문서를 읽고 세운 계획입니다.
문서에서 확인한 것
서버 문서에 따르면 Coolify 는 연결한 서버를 SSH 로 관리합니다. 검증 과정에서 Docker 를 설치하고 서비스를 재시작할 수 있어서, 문서는 되도록 새 서버를 쓰라고 권합니다.
운영 작업에는 앱 활동이 Coolify 자체에 영향을 주지 않도록 원격 서버를 두라는 권장도 있습니다.
Destination 은 서버 위의 Docker 네트워크이고, 다른 네트워크의 리소스는 공유 네트워크에 연결하지 않으면 격리됩니다. Compose 앱을 다른 리소스와 통신시키는 "Connect To Predefined Network" 는 켜지 않습니다.
Custom Docker Options 는 --cap-add, --cap-drop, --security-opt, --sysctl, --device, --ulimit, --init, --privileged, --hostname, --entrypoint, --add-host, --pids-limit, --read-only, --runtime, --tmpfs 등을 허용합니다. --network, --name, -v, -p, -e 는 적용되지 않고 배포 로그에 경고가 남습니다. 문서는 --privileged, --device, 추가 권한이 컨테이너 격리 경계를 약하게 한다고 경고합니다.
gVisor, Sysbox, Kata 를 Coolify 와 함께 쓴다는 공식 근거는 찾지 못했습니다. --runtime 이 허용 목록에 있으니 서버의 Docker 데몬에 런타임을 등록하면 지정할 수는 있을 것으로 추론할 뿐이고, 돌려 보지 않았습니다.
Docker 문서에 따르면 데몬에 명령할 수 있으면 그 머신의 root 를 가진 것과 같습니다.
격리 기술은 각자 막는 것이 다릅니다. gVisor 문서는 샌드박스가 안전한 구조를 대신하지 못한다고 적습니다. Firecracker 문서는 네트워크 필터링을 하지 않는다고 밝힙니다. 어떤 격리든 에이전트에게 준 자격증명으로 하는 합법적 동작은 막지 못합니다. 그래서 격리 기술을 고르기 전에 자격증명을 어디에 둘지부터 정해야 한다는 생각이 들었습니다.
설계 결정
서버를 나눕니다. 샌드박스 서버는 운영 서버와 분리한 별도 VM 입니다. 같은 Docker 데몬과 커널을 나눠 쓰지 않습니다. 제어판에는 원격 서버로 등록합니다. 방화벽은 들어오는 SSH 를 제어판에서만 받고, 프록시가 허용한 곳 밖으로 나가는 통신을 막습니다.
게이트웨이와 샌드박스는 다른 리소스로 둡니다. Coolify 는 compose 리소스의 환경변수를 그 안 모든 서비스 컨테이너에 주입하고, compose 의 environment: 로는 좁힐 수 없습니다. compose 리소스의 env 경계를 다룬 앞선 글에서 직접 재 본 내용입니다. Coolify 문서에서 확인한 것이 아니라 제 실측입니다. 토큰을 든 게이트웨이를 같은 리소스에 넣으면 샌드박스에도 토큰이 들어갑니다.
시크릿이 없는 것끼리는 같은 리소스에 둬도 됩니다. 샌드박스, 테스트용 DB 사이드카, 외부 통신 프록시를 내부 전용 네트워크(internal: true)로 묶습니다.
외부 통신은 프록시로만 나갑니다. 허용 대상은 패키지 레지스트리와 게이트웨이뿐입니다. github.com 도 직접 열지 않습니다. Agentic Workflows 도 Squid 프록시와 도메인 허용 목록을 씁니다.
컨테이너 권한을 덜어 냅니다. 샌드박스 컨테이너에는 아래 옵션을 줍니다. 런타임을 등록했다면 --runtime=runsc 를 더하는 것까지가 계획이고, 앞서 적은 대로 이 조합은 돌려 보지 않았습니다. 비루트 사용자로 실행하고, --privileged, --device, --cap-add 는 쓰지 않습니다. 작업 폴더만 쓰기 가능한 볼륨으로 둡니다.
--cap-drop=ALL --security-opt=no-new-privileges --pids-limit=512 --read-only --tmpfs /tmpDocker 소켓은 샌드박스에도 게이트웨이에도 주지 않습니다. 작업마다 컨테이너를 만들게 하려면 게이트웨이에 소켓을 줘야 하는데, 그러면 토큰을 든 서비스가 호스트 root 까지 갖습니다. 앞에서 옮긴 Docker 문서의 문장이 그 뜻입니다. 개인 규모에서는 컨테이너 하나, 동시 작업 1개, 작업 전후 폴더 초기화가 단순합니다. 동시 실행이 필요해지면 그때 전용 런타임을 고르려고 합니다.
통합 테스트는 더미로 돌립니다. 에이전트가 Docker 를 쓸 수 없으므로 테스트 DB 는 미리 띄운 사이드카나 인메모리로 줍니다. 값은 더미입니다.
배포 뒤에는 키 이름을 셉니다. 샌드박스 컨테이너의 환경변수를 키 이름만 뽑아 시크릿 계열이 0개인지 봅니다.
docker inspect <컨테이너> --format '{{range .Config.Env}}{{println .}}{{end}}' | cut -d= -f1 | sort게이트웨이는 공용 인터넷에 열지 않습니다. 사설망이나 내부망으로 둡니다. 원격 에이전트 서비스에 MCP 로 열어야 한다면 OAuth 2.1 로 인증하고, token passthrough 를 하지 않습니다. MCP 스펙은 token passthrough 를 명시적으로 금지하고, MCP 서버 자신을 위해 발급되지 않은 토큰은 받지 말라고 못 박습니다.
레포마다 할 일: 스킬과 하네스를 읽히는 법
샌드박스를 갖춰도 에이전트가 레포의 규칙을 읽지 못하면 소용이 없고, 반대로 규칙 파일을 에이전트가 고칠 수 있으면 규칙이 규칙 노릇을 하지 못합니다. 여기서 하네스는 상주 지시 파일, 스킬, 훅처럼 에이전트의 작업 환경을 이루는 설정을 말합니다. 아래 문서 사실은 Codex 기준이고, 도구마다 경로가 다릅니다.
AGENTS.md는 저장소 루트부터 현재 디렉터리까지 내려오며 합쳐 읽고, 기본 합산 한도는 32KiB 입니다. 모범 사례 문서는 짧고 정확한 파일이 모호한 규칙으로 가득한 긴 파일보다 낫다고 권합니다.- 스킬 탐색 경로는
.agents/skills등입니다. 클라우드 환경 문서에 따르면 저장소에 둔 스킬은 클라우드 작업에서 쓸 수 있지만, 로컬 컴퓨터의 개인 스킬은 동기화되지 않습니다. - 로컬 Codex 의 쓰기 샌드박스에서
.git,.agents,.codex는 읽기 전용으로 보호됩니다. 기본 네트워크는 꺼져 있습니다.
이 사실들 위에서 이렇게 정하려고 합니다.
하네스는 복사하지 않고 내보냅니다. 상주 지시 파일에는 접속 정보가 들어가기 쉽습니다. 전역 지시를 통째로 외부 환경에 동기화하면 그 값이 같이 나갑니다. 비밀값이 없는 별도 저장소로 분리하고, 환경 구축 스크립트가 고정 커밋을 받아 배치합니다. 내보내기 전에는 비밀값 스캔을 겁니다.
도구마다 읽는 파일이 다릅니다. Claude Code 용 스킬을 둔 폴더를 Codex 는 찾지 않습니다. 필요한 것만 공용 위치로 옮깁니다.
규칙 파일은 신뢰 경계 안에 둡니다. 에이전트가 고친 AGENTS.md 가 자기 리뷰 기준이 되면 안 됩니다. 리뷰 규칙은 PR 이 아니라 기준 브랜치의 고정 커밋에서 읽고, 규칙 파일은 보호 경로로 둡니다. 앞의 hooks/update 가 AGENTS.md 수정을 거절한 이유입니다.
의존성 설치를 고정합니다. 잠금 파일을 고정하고(--frozen-lockfile) 설치 스크립트를 막습니다(--ignore-scripts, 빌드가 필요한 패키지만 예외). Nx s1ngularity 사고에서 postinstall 이 자격증명을 수집했고, 일부 보도에 따르면 승인 생략 플래그로 AI CLI 를 호출해 파일을 탐색시켰습니다. 공식 권고문에는 프롬프트만 보이고 CLI 이름은 적혀 있지 않습니다.
CI 를 나눕니다. GitHub 문서가 명시하는 것은 포크에서 시작된 워크플로에 시크릿이 넘어가지 않는다는 데까지입니다. 같은 저장소 브랜치의 PR 에 대한 직접 서술은 없습니다. 그래서 포크가 아닌 같은 저장소 브랜치의 PR 은 이 제외에 해당하지 않으므로 시크릿에 닿을 수 있다고 보고 설계합니다. 이 부분은 제 해석입니다.
에이전트가 고친 테스트 코드가 CI 에서 돌기 때문에 테스트 작업에는 시크릿을 두지 않습니다. permissions: contents: read 로 두고, 시크릿은 배포 작업에만 줍니다. pull_request_target 은 쓰지 않습니다. Nx 사고의 상류 원인이 이 이벤트의 PR 제목 주입이었습니다. 앱에 workflows 권한을 주지 않아 워크플로 파일 수정을 막고, 저장소 설정의 "Allow GitHub Actions to create and approve pull requests" 는 끕니다.
멈추는 조건을 문서에 적습니다. 같은 검사 2번 실패, 허용 경로 밖 변경 필요, 결정 필요. 이 세 경우에는 에이전트가 더 밀고 나가지 않게 합니다.
외부 에이전트 서비스에 맡길 때: dots 를 찾아본 결과
제 서버가 아니라 벤더의 샌드박스에 맡기면 어떨까 싶어 dots 를 찾아봤습니다. 다시 밝히지만 dots 에 코딩 작업을 맡겨 본 적은 없습니다. 공식 문서와 공개 사용자 보고를 읽었고, 제 dot 의 클라우드 컴퓨터는 환경만 명령으로 재 봤습니다.
dots 는 OpenAI 가 2026년 9월 29일 발표한 ChatGPT 안의 상시 에이전트입니다. 자기 클라우드 컴퓨터와 브라우저를 갖고, 코딩은 미리 만든 Codex 클라우드 환경이나 연결한 개인 컴퓨터 1대의 Codex 작업으로 위임합니다. 문서에 따르면 dots 를 움직이는 모델군에 GPT-6.1 Terra 를 더하고 있고, 일의 부분마다 다른 모델을 쓸 수 있습니다. 위임된 작업의 모델과 선택 가능 여부는 문서에 없습니다.
코딩 모델 수준은 Terminal-Bench 4.0(Snorkel, effort max, 66과제)으로 가늠할 수 있습니다. Terra 는 이 표에 없습니다.
| 모델 | 점수 |
|---|---|
| Opus 5.5 | 64.8% ±3.1 |
| Sonnet 5.5 | 61.8% ±2.9 |
| GPT-6 Astra | 58.2% ±2.8 |
| GPT-6.1 Sol | 58.2% ±3.1 |
| Fable 5.1 | 57.9% ±3.8 |
다만 METR 은 SWE-bench 통과 패치의 메인테이너 병합률이 채점기 점수보다 약 24%포인트 낮다고 쟀습니다. 시험 모델은 GPT-5 와 Claude 4.5 세대까지입니다. 벤치마크 점수는 맡길 크기를 말해 주지 않습니다.
사례를 찾지 못했습니다
dot 에 자기 레포를 맡겨 병합까지 간 1인칭 사례를 찾지 못했습니다. 시도하다 막혔다는 보고는 서로 다른 작성자 약 11명이었습니다. Hacker News 출시 스레드, openai/codex 의 dots 라벨 이슈 300건의 제목과 본문 10여 건, 포럼, 블로그, 한국어 커뮤니티를 봤고 Reddit 은 열지 못했습니다. 그러니 없다는 단정이 아니라 찾지 못했다는 말입니다. 2026년 11월 초 기준이고 빠르게 바뀔 수 있습니다.
막힌 유형은 이렇습니다. 원문은 확인했지만 모두 사용자 보고이고, 재현은 제가 확인하지 않았습니다.
- 소유자 승인과 CI 가 있어도 병합이 거부됐습니다(#59833).
- 한 줄 수정 푸시가 자동 심사에 막혔습니다(#59426).
- 승인 창이 반복되며 세션이 멈췄습니다(#55412).
- dot 클라우드 컴퓨터에서
gh로그인이 막혔습니다(#52755, #54403).
재미있는 것은 이 보고들이 벤더 쪽 경계가 작동한다는 뜻이기도 하다는 점입니다. 다만 그 경계는 사용자가 조정할 수 없는 쪽에 있어서 무인 개발 흐름을 멈춥니다.
dots 문서의 단서도 눈여겨봤습니다. 제어 문서는 커스텀 규칙을 dot 이 따르려고 하는 지시이고 틀릴 수 있다고 적습니다. 작업 문서에는 실행이 끝났다고 요청한 결과가 달성되거나 전달됐다고 확인되는 것은 아니라는 문장도 있습니다. 정지해도 이미 완료된 동작은 되돌리지 않습니다. 벤더 문서도 지시를 경계로 치지 않는 셈입니다.
웹조사에서 가장 중요했던 것은 사례처럼 보이지만 사례가 아닌 글을 가르는 일이었습니다. 제목에 dots 와 GitHub 가 들어간 글 중에는 본문에서 실측이 아니라고 밝히거나(wavect.io) dot 접근권이 없다고 밝힌(flaviocopes.com) 글이 있었습니다.
문서에 없는 것도 적어 둡니다. 클라우드 작업의 브랜치 이름 규칙, PR 을 만드는 주체, 컨테이너 안 git push 가능 여부, Docker 사용 가능 여부, 실행 시간 상한입니다. 그래서 서비스 쪽 샌드박스를 믿더라도 저장소 쪽 규칙을 따로 걸어야 합니다.
제 dot 의 클라우드 컴퓨터를 재 봤습니다
코딩 작업을 맡긴 것은 아니고, 제 dot 에게 점검 명령을 돌리게 해서 환경만 봤습니다. 2026년 11월 7일에 계정 1개에서 본 값이라 다른 계정이나 시점에도 같다는 뜻은 아닙니다.
사양은 9 vCPU, 9.7 GiB 메모리였고 Docker 와 sudo 는 없었습니다. 명령을 실행하는 셸에서 홈은 읽기 전용이었고, 작업 폴더에는 쓸 수 있었습니다. 공개 저장소 clone 과 로컬 commit 도 됐습니다.
권한 설계에서 눈여겨볼 것은 통신입니다. 프록시를 거치지 않는 직접 연결은 실패했습니다. github.com 인증서의 발급자가 OpenAI 로 나왔으니, 프록시가 HTTPS 를 풀어 보는 구조로 보입니다. 그런데 무관한 주소로 보낸 POST 는 그대로 나갔습니다. 터미널에는 GitHub 자격증명이 없었습니다. 여기에 쓰기 토큰을 넣으면 토큰이 프록시에서 풀린 상태로 지나가고, 밖으로 나갈 길도 열려 있는 곳에 토큰을 두는 셈입니다.
테스트 도구는 바로 되지 않았습니다. 테스트용 MongoDB 는 시작하자마자 중단됐고, 시스템 Chromium 은 socket() failed: Operation not permitted 로 죽었습니다. 재 보니 유닉스 소켓 생성이 막혀 있었습니다. Codex 의 공개 격리 코드에도 프록시 경유 모드에서 유닉스 소켓을 막는 규칙이 있습니다. 명령을 고르는 것이 아니라 시스템 호출에서 막는 사례입니다. MongoDB 는 원인이 달랐습니다. 8.2.6 은 /sys 가 없어 메모리 할당기가 CPU 수를 읽지 못하고 시작하자마자 멈췄고, 유닉스 소켓을 꺼도 같았습니다. 7.0 은 유닉스 소켓을 끄니 떴습니다. 증상이 같아 보여도 원인은 하나씩 재 봐야 합니다.
Playwright 브라우저 설치도 실패했습니다. 다운로드 주소가 ZIP 이 아니라 HTML 을 돌려줬고, 같은 주소가 HTTP 200 으로 "Site Unavailable" 페이지를 돌려줬다는 보고도 있습니다. curl 200 만 보고 통신이 된다고 판단하면 안 됩니다. 다만 같은 버전의 브라우저를 구글 저장소에서 직접 받아 풀었더니 Playwright 실행과 스크린샷까지 됐습니다.
제 판단은 이렇습니다. 지금은 dot 을 작업 배분과 추적에 쓰고, 구현은 Codex 작업으로 보내며, 병합은 사람이 합니다. dot 자신의 컴퓨터에서 구현까지 하는 길은 실제 저장소로 돌려 본 뒤에 정하겠습니다. 어느 쪽도 아직 코딩 작업으로 재지는 않았습니다.
어디까지 맡길까: 크기보다 작업 범위
맡길 일의 크기는 어떻게 정할까요. 공식 문서에는 파일 수나 줄 수 기준이 없습니다. 문서의 권장은 한 채팅을 한 결과에 묶고, 검증 명령을 지정하고, 복잡하면 계획부터 세우라는 정도입니다. 검증된 숫자 기준을 지지하는 연구도 찾지 못했습니다.
.NET 팀의 10개월 기록
가장 구체적인 공개 데이터는 .NET 팀의 10개월 기록입니다(Stephen Toub, 2026년 3월 23일). Copilot coding agent PR 878건 중 535건이 병합됐고, 병합률은 67.9% 입니다. 이 병합률은 아직 열려 있는 PR 을 뺀 값으로, 병합 건수를 병합과 닫힘을 더한 건수로 나눈 것입니다.
사람(Microsoft) PR 은 87.1% 입니다. 빌드·테스트 환경과 지시 파일을 갖추기 전에는 38.1%, 후에는 69% 였습니다. 병합된 535건 중 되돌린 것은 3건입니다. 저자는 맡길 작업을 골랐으므로 방향 지표로 읽으라고 적습니다.
| 작업 유형 | 병합률 |
|---|---|
| 삭제·정리 | 84.7% |
| 테스트 | 75.6% |
| 리팩터링 | 69.7% |
| 버그 수정 | 69.4% |
| 문서 | 68.1% |
| 갱신·업그레이드 | 67.4% |
| 기능 | 64.5% |
| 성능 | 54.5% |
| 변경 줄 | 병합률 |
|---|---|
| 1~10 | 80.0% |
| 11~50 | 76.9% |
| 51~100 | 75.0% |
| 101~500 | 64.0% |
| 501~1,000 | 68.2% |
| 1,001 이상 | 71.9% |
원문의 표에는 «기타» 유형과 «변경 0줄» 행이 더 있는데 여기서는 뺐습니다. 저자의 결론은 "task scope matters more than size." 입니다. 크기보다 작업 범위가 중요하다는 뜻입니다. 줄 수 표를 보면 이 결론이 이해됩니다. 변경이 클수록 병합률이 떨어질 것이라는 직관과 달리, 101~500줄이 가장 낮고 그 위는 다시 오릅니다. 다만 501줄 이상은 표본이 작아서(44건, 32건) 오르막까지 믿기는 어렵습니다.
제 저장소에서 잰 방향
제 저장소에서도 비슷하게 재 봤습니다. 한 달 동안 Claude Code 와 Codex 가 나란히 PR 을 낸 약 100건을 놓고, 병합 뒤 7일 안에 같은 파일을 고치는 fix PR 이 뒤따른 비율을 셌습니다. Codex 쪽 PR 은 리뷰 절차를 거의 거치지 않았습니다.
| 구간 | Codex | Claude Code |
|---|---|---|
| 파일 10개 이하 | 21% | 9% |
| 파일 11~30개 | 53% | 50% |
| 파일 31개 이상 | 83% | 30% |
| 패키지 1개 | 29% | 19% |
| 패키지 2개 이상 | 68% | 40% |
fix 가 뒤따랐다고 결함이 있었다는 뜻은 아니고, 파일이 많을수록 우연히 겹칠 기회도 많습니다. 표본도 작으니 방향만 봅니다. 큰 PR 에서 격차가 가장 큽니다. 리뷰 없이 큰 변경을 합치는 쪽이 문제라는 해석이 가능하지만 그 인과를 재지는 않았습니다. 병합률과 후속 수정률은 다른 지표여서 .NET 표와 곧바로 비교할 수도 없습니다.
위임 기준: 여섯 관문
그래서 크기보다 성격으로 먼저 거르려고 합니다. 제 제안입니다. 여섯 관문을 모두 통과해야 보냅니다.
- 판정 가능: 완료를 판정할 명령이 정해져 있고 그 환경에서 돌아갑니다. Docker, 운영 데이터, 외부 계정, 눈으로 보는 화면 확인이 필요하면 탈락입니다.
- 되돌림 가능: 결과물이 초안 PR 하나뿐이고 병합 전에는 외부 상태가 바뀌지 않습니다.
- 범위 닫힘: 바꿔도 되는 경로를 적을 수 있고 패키지 하나 안에서 끝납니다. API 계약, DB 스키마, 공용 타입을 바꾸지 않습니다.
- 판단 완료: 제품·설계·보안 선택이 이미 정해져 있습니다.
- 입력 신뢰: 작업 문서를 소유자가 직접 썼습니다. 외부인이 쓴 이슈와 웹페이지를 지시로 넘기지 않습니다.
- 실패 허용: 통째로 버려도 되고 급하지 않습니다.
다섯째 관문은 앞에서 본 혼동된 대리인과 이어집니다. 외부인의 글을 지시로 넘기면 에이전트가 그 글을 사용자 의도로 읽을 수 있기 때문입니다.
크기 상한은 처음 10건에 파일 10개, 500줄, 패키지 1개로 잡으려고 합니다. 아직 재지 않은 가정이고 측정으로 조정합니다. 볼 지표는 사람이 크게 고치지 않고 병합한 비율, 7일 후속 수정률, 멈춘 횟수, 작업당 사용량입니다.
맡기지 않는 것도 정해 둡니다. 운영 DB 마이그레이션 적용, 배포와 환경변수, 워크플로 수정, 인증·인가·결제·개인정보, 여러 패키지에 걸친 API 계약 변경, 성능 개선, 화면 품질 판단입니다.
코드 리뷰는 구현과 같은 주체에게 맡기지 않습니다. 구현 맥락을 받지 않은 별도 작업이나 다른 도구로 나누고, 규칙은 기준 브랜치에서 읽습니다. 병합은 사람이 합니다. Copilot 이 요청자의 승인까지 막는 것도 같은 방향으로 읽힙니다.
작업 문서 양식
작업은 이 양식으로 넘기려고 합니다. dots 작업 문서에 따르면 위임 작업은 dot 과의 대화를 자동으로 받지 않으므로 문서가 자립해야 합니다.
# 작업: <결과를 한 줄로>
- 작업 ID: t-YYYYMMDD-NN
- 기준: main@<커밋>
- 브랜치: agent/t-YYYYMMDD-NN/<슬러그>
## 끝난 상태
## 바꿔도 되는 경로
## 바꾸면 안 되는 것
## 이미 정한 결정
## 검증 (전부 통과해야 PR)
## 멈추는 조건
- 같은 검사 2번 실패
- 허용 경로 밖 변경이 필요함
- 위에 없는 결정이 필요함
## 산출물
초안 PR 1개. 본문에 검증 명령과 결과를 붙인다.토큰은 줄어드나
계획만 직접 쓰고 구현을 넘기면 토큰이 줄어드는지도 따져 봤습니다. 비율만 적습니다. 같은 저장소에서 같은 한 달 동안 PR 1건당 입력 토큰은 Claude Code 가 Codex 의 약 7~11배, 변경 줄당 약 7배였습니다. 시작 맥락의 크기부터 3~4배 차이가 났고(상주 지시와 도구 정의), 요청당 입력은 2~3배였습니다. 입력의 대부분은 캐시 읽기였습니다. 계획만 쓰는 단계는 구현과 리뷰를 포함한 전체의 일부에 그쳤습니다.
그래서 계획만 쓰고 구현을 넘기면 계획 쪽 도구의 토큰은 확실히 줄어듭니다. 하지만 이 비교가 효율 차이를 뜻하지는 않습니다. Codex 쪽은 리뷰 절차를 거의 거치지 않았고 후속 fix 비율이 약 2배였으며, 토큰 단가와 구독 한도 산정도 도구마다 다르고, 두 도구가 맡은 일이 무작위로 배정되지도 않았습니다. 시작 맥락이 3~4배 크다는 것은 상주 지시를 줄이면 도구를 바꾸지 않고도 일부는 줄일 수 있다는 뜻으로 읽힙니다. 얼마나 줄어드는지는 재지 않았습니다. 품질을 맞춘 뒤의 절감도 아직 모릅니다.
아직 재지 못한 것과 다음 단계
각 자리에서 적었지만 한 번 묶어 둡니다. 이 구조를 서버에 띄워 운영해 보지 않았습니다. GitHub 룰셋의 거절 동작을 재지 않았습니다. dot 으로 실제 코딩 작업을 돌려 보지 않았고, 클라우드 컴퓨터는 환경만 재 봤습니다. gVisor 와 Coolify 조합을 돌려 보지 않았습니다. Reddit 은 열지 못했습니다. 다음 단계는 시범 작업 몇 건을 돌려 재는 것입니다.
명령어 표를 정리하려고 시작한 일이었습니다. 표는 남았지만 표에 맡기려던 역할은 다른 곳으로 옮겨 갔습니다. 표는 실수를 줄이고, 경계는 게이트웨이와 서버 쪽 규칙과 네트워크가 맡습니다. 결국 AI 에이전트 권한 분리는 에이전트에게 부탁할 일과, 부탁하지 않아도 할 수 없게 둘 일을 가르는 문제였다는 생각이 들었습니다.