AI 에이전트 8개로 30만 줄을 짠 개발자의 바이브 코딩 규칙서

2026년 1월, 한 사람이 한 달에 6,600개의 커밋을 남겼어요. 겉보기에는 20명 규모 팀의 속도인데, 실제로는 개발자 한 명과 AI 에이전트 3~8개의 조합이었죠. GitHub 역대 최다 스타(31만+)를 기록한 OpenClaw 프로젝트 이야기예요. 오스트리아 개발자 Peter Steinberger가 Codex CLI 인스턴스를 3x3 터미널 그리드에서 동시에 실행하며 만들어낸 결과물이에요.

OpenClaw는 셀프 호스팅 개인 AI 어시스턴트로, 15개 이상의 메시징 플랫폼을 대형 언어 모델과 연결해요. 아키텍처 핵심은 18789 포트에서 동작하는 WebSocket 기반 Gateway 데몬인데, 들어오는 메시지를 각각 독립된 AI 에이전트로 라우팅하는 구조죠.

AGENTS.md는 "조직의 상처가 축적된 흔적"이다

이 프로젝트에서 가장 재현 가능성이 높은 혁신은 AGENTS.md 파일이에요. 코드베이스에서 작업하는 모든 AI 코딩 에이전트를 위한 포괄적 지침 문서인데, Steinberger는 이걸 "organizational scar tissue의 모음"이라고 불러요. 무언가 잘못될 때마다 Codex 자체가 점진적으로 내용을 추가해왔기 때문이죠.

빌드 및 테스트 명령어 명시, Conventional Commits 강제, 멀티 에이전트 안전 규칙(git stash 금지, 브랜치 변경 금지), 보안 경계(실제 전화번호나 운영 환경 설정값 커밋 금지)까지 담겨 있어요. AI 에이전트가 실수할 수 있는 모든 지점을 경험적으로 막아둔 방어막인 셈이죠.

PR이 하루 14개씩 쏟아질 때 자동화가 필수가 된다

CONTRIBUTING.md는 커뮤니티가 AI 보조 PR을 다루는 규범까지 정의해요. PR에 AI 사용 여부를 표시할 것, 테스트 수준을 명시할 것, 생성된 코드가 무엇을 하는지 이해하고 있음을 확인할 것. 임의 시점 기준 5,500개 이상의 오픈 PR과 19,000개 이상의 종료 PR이 존재하니까 강한 자동화 없이는 운영 자체가 불가능해요. 58개의 라벨이 컴포넌트별로 분류되어 있고, 하루 평균 14개의 신규 PR을 처리하죠.

이 프로젝트가 보여주는 건 단순히 "AI로 빠르게 코드를 짤 수 있다"가 아니에요. 대규모 AI 보조 개발에서는 코드를 짜는 속도보다 규칙을 세우는 속도가 더 중요하다는 거죠. AGENTS.md가 없었다면 8개의 에이전트는 서로의 작업을 방해하는 혼란의 원천이 됐을 거예요.