개인 AI 워크플로가 팀 규칙이 되는 순간
팀 도입의 역할 분리와 승인선 기준을 가이드 요약에서 살펴보고, 개인 작업 기록의 훅 파이프 테스트와 git 사고를 예로 검증 범위를 나누어 적는 방법을 정리한다.

AI 에이전트 작업을 팀에 도입하려는데 ‘완료’라는 보고만으로 승인하기가 망설여진다면, 누가 어떤 증거를 확인할지부터 살펴볼 수 있다. 가이드 요약을 바탕으로 한 「팀 도입과 거버넌스」 노트도 도입의 기준을 도구의 수보다 승인 책임과 근거에 둔다. 이 글은 그 노트의 팀 도입 기준과 내 개인 작업 기록에 남은 사고와 검증 사례를 함께 다룬다.
실행 책임과 검토 책임을 나누는 기준
가이드 요약에서 정리한 역할 구분에 따르면, 요청하는 쪽은 무엇을 이루려는지와 판단의 근거를 제공하고 에이전트는 맡은 범위에서 실행한 증거를 남긴다. 검토하는 쪽은 요청을 제대로 해석했는지, 변경 내용과 검증 방식이 적절한지 살핀다. 배포와 접근 권한, 비밀값, 비용, 실행 이력의 관리는 운영 책임으로 구분한다.
이 사이트의 ARTICLE_RULES.md에는 작성자와 독립 검토자가 같은 원자료를 대조하도록 정한 조항이 있다.
실행하지 않은 테스트나 사람 검수를 주장하지 말라는 조항도 있다.
이는 문서에 명시된 규칙이며, 개별 작업에서 실제로 검토를 마쳤다는 수행 증거와는 구분해야 한다.
검증 범위를 나누어 남긴 기록
팀에서 “검증했다”는 말이 무엇을 뜻하는지는 범위를 적어야 가려진다. 아래 기록은 2026-07-06에 만든 벤더 CLI 차단 훅을 확인한 방식이다. 15개 케이스는 실제 세션을 띄운 것이 아니라, 표준 입력에 JSON을 넣고 Bash 명령 문자열을 바꿔 가며 훅을 직접 실행한 파이프 테스트다.
| 케이스 묶음 | 케이스 수 | 기대한 결과 |
|---|---|---|
| 벤더 CLI 직접 호출(하위 명령, 체인, 절대 경로 포함) | 5 | 차단 |
| 안전한 하위 명령(버전, 로그인, 도움말) | 4 | 허용 |
| 하위 에이전트가 호출하는 경우 | 2 | 허용 |
| 따옴표 안의 텍스트, 무관한 명령 | 2 | 허용 |
| 빈 입력, 잘못된 JSON 입력 | 2 | 허용(실패 시 통과) |
기록에는 15개 케이스가 모두 기대 결과와 일치했다고 적혀 있다. 같은 날 만든 컨텍스트 압축 유도 훅은 6개 파이프 테스트를 통과했다고 남아 있다. 이 숫자는 훅의 판정이 기대와 맞았다는 뜻이며, 실제 팀 저장소에서 훅이 어떻게 동작했는지는 말하지 않는다.
훅이 막는 것은 한 종류의 실수뿐이다. 같은 기록 묶음에는 git 명령으로 작업을 잃은 사고도 남아 있다. 2026-06-23에는 검증 하위 에이전트가 되돌림을 확인하려고 git checkout src/를 실행해 커밋되지 않은 작업분을 날렸다. 2026-06-27에는 git add -A adsence/가 작업 중 사라진 보호 디렉터리의 파일 23개 삭제까지 스테이징해 커밋했다. 그 뒤 커밋은 변경 파일을 명시해 추가하고, 위임 지시문에 git add, checkout, restore, clean과 파일 삭제 금지를 적는 규칙이 생겼다.
위임 에이전트가 정리 범위를 지시 밖으로 넓혀 추적 파일을 지운 사고도 기록돼 있다. 삭제된 파일은 34건이었고, 주기적으로 쌓아 둔 커밋 히스토리가 유일한 복구 근거였으며 마지막 커밋 상태로 전량 복구했다. 이 사례와 방지 규칙은 멀티에이전트 실패 패턴 글에서 따로 다룬다.
승인 규칙을 적는 일과 실행을 막는 일
「팀 도입과 거버넌스」 노트는 공용 규칙 파일과 작업별 허용 범위를 정하고, 변경 제안부터 리뷰·자동 검증·배포 확인까지 연결하는 것을 점검 기준으로 삼는다. 비밀값, 실제 서비스 환경, 결제, 데이터 삭제, 외부 권한 변경에는 별도 승인선을 두도록 정리한다. 가이드 요약이 제시하는 도입 흐름에서도 민감 작업의 승인과 실행 이력 기록을 마련한 뒤 반복 업무의 평가와 자동화로 이어 간다.
규칙을 실행 단계의 차단으로 옮긴 사례는 내 개인 작업 기록에 있다. 2026-07-06 기록에는 문장으로만 적힌 라우팅 규칙이 강제 장치 없이 표류한다는 관찰이 남아 있다. 이어 실행 전에 조건을 검사하는 훅 기반 차단으로 전환하고, 15개 케이스로 검증한 내역이 있다.
이 기록이 보여 주는 범위는 개인 설정에서 규칙을 실행 단계의 차단으로 바꾼 작업까지다. 팀의 배포나 결제 승인선을 운영해 효과를 확인한 기록은 아니다. 가이드의 팀 도입 기준과 이 개인 실행 사례는 그 범위를 나누어 읽어야 한다.
실패를 어디에 남길지도 도입 기준에 포함한다
「팀 도입과 거버넌스」 노트는 사람이 읽지 않은 결과물의 즉시 병합·배포와 제각각인 요청 방식·완료 기준을 위험 신호로 정리한다. 비밀값이나 실제 서비스 권한이 일반 작업 경로에 노출되는 상황도 포함한다. 실패가 대화에만 남고 공용 규칙이나 운영 지침에 반영되지 않는 상황 역시 같은 목록에 들어 있다.
노트가 제안하는 대응은 반복 실패와 좋은 사례를 공용 양식, 평가 기준, 운영 지침에 축적하는 것이다. 이 사이트의 작성 규칙도 검증 결과에 실행 명령·시각·환경·종료 코드·관찰 결과를 남기고, 이전 기록이나 전달받은 증거는 이번 실행과 구분하도록 요구한다.
아직 댓글이 없습니다.