Uncle Bob의 ub-mode, 코딩 에이전트에게 일이 끝났음을 증명하게 만든다

프로그램 네 개를 업고 있는 skill 파일
매주 어딘가의 저장소가 코딩 에이전트에게 인격을 하나씩 붙여 준다. 이름과 말투, 모델이 신경 써야 할 항목 목록을 담은 markdown 파일이다. skills 폴더에 넣고 슬래시 명령을 치면, 에이전트가 온갖 일을 겪어 본 시니어 엔지니어 같은 말투로 커밋 메시지를 쓰기 시작한다.
2026년 11월 15일 기준 ub-mode는 GitHub에서 7,989 스타, 저장소는 unclebob/ub-mode다. 설치 방식도 정확히 같은 패턴이다. SKILL.md를 ~/.claude/skills/ub-mode/SKILL.md에 복사하거나 Cursor, Grok의 해당 위치에 넣고 /ub-mode를 입력한다. 세 단계다. 「First Make it Work」에는 Laziness Protocol, Foundational Thinking, TDD, Redesign From First Principles, Attack the Premise, Subtract Before You Add, Outcome-Oriented Execution, Build the Lever, 그리고 도메인 모델링, 경계, 타입 규율, 멱등 연산, 공유 상태를 직렬화하기 전에 분리하는 일을 다루는 아키텍처 절이 들어 있다. 「Then Make it Right」에는 Fix Root Causes, Sequence Work into Verifiable Units, Test Behavior Not Implementation, Refactoring. 「Practice」는 로그, 컨텍스트 윈도 위생, worktree 정리, 작고 순서 있는 커밋이다.
사람들이 스크린샷으로 인용할 부분은 그 목록이다. 읽을 만한 부분은 「Then Make it Right」 안에 있다. 저자가 에이전트의 작업을 검사하려고 직접 쓴 네 개의 명령줄 프로그램이다.
한 문장의 문제
코딩 에이전트에게 끝났냐고 물으면 문장 하나가 돌아온다. 「엔드포인트를 구현했고 테스트를 추가했고 스위트가 통과합니다.」 그 문장은 코드를 쓴 것과 같은 과정이 생성한 것이므로 독립적인 정보를 담지 않는다. slop은 여기서 나온다. 모델의 성격 문제가 아니라 모델이 놓인 루프의 문제다. 에이전트에게 완료란 주장이고, 주장은 싸게 만들어진다.
이 skill은 주장을 에이전트가 움직여야 하는 숫자로 바꾼다. Crapper는 함수마다 순환 복잡도, 테스트 커버리지, CRAP 점수를 계산하고, 모든 함수가 CRAP < 10을 유지하도록 요구한다. Dryer는 구조적 중복을 찾아 유사도 0.8 이상인 블록의 제거를 요구한다. Mutator는 뮤테이션 테스트를 돌린다. 일부러 코드를 망가뜨리고 테스트가 알아채는지 본다. UML-viewer는 컴포넌트, 커버리지, CRAP 점수, 뮤테이션 점수, 의존 방향을 그린다.
넷 중 셋은 빌드를 실패시킬 수 있다. 문단과는 말다툼할 수 있다. 종료 코드와는 다투기 어렵다. 반론이 다른 코드여야 하기 때문이다.
Attack the Premise
1단계의 아홉 원칙 중 두 개는 읽는 쪽이 모델일 때 다르게 작동한다.
Attack the Premise는 그것만 따로 내놔도 좋다고 생각한다. 에이전트의 순종에는 구체적이고 값비싼 방식이 있다. 요청을 적힌 그대로 유능하게 구현하고, 그 요청이 존재해야 하는지는 끝까지 묻지 않는다. 캐시 계층을 붙이라고 하면 캐시 계층이 나온다. 테스트가 있고, 작은 단위로 커밋되고, 경계도 깔끔하다. 엔드포인트가 느린 게 쿼리 플랜 때문인지는 아무도 확인하지 않았다. 이 티켓이 2년 전에 떠난 누군가의 결정에 대한 임시 우회라는 것도 에이전트는 알아채지 못한다.
사람 리뷰어가 반박하는 이유는 반박이 공짜이고 주변 맥락을 머리에 담고 있기 때문이다. 에이전트는 규칙이 시킬 때만 반박한다. 그래서 Attack the Premise가 구조를 지탱하는 부품이 된다. 1단계에 있다는 위치도 중요하다. 코드가 존재하기 전, 답을 바꾸는 게 아직 싼 시점이다.
Sequence Work into Verifiable Units가 두 번째이고, 실은 기억에 관한 이야기다. 긴 세션은 썩는다. 3턴에서 정한 제약이 90턴에도 윈도에 남아 있지만 무게가 달라졌고, 모델은 한 시간 전에 세운 규칙을 자신 있게 어기기 시작한다. 작업을 단위로 자르고 각 단위 끝에 검사를 두면 멈춰서 볼 자리가 생기고, 게이트가 물어뜯을 대상도 생긴다. 4천 줄 변경 끝의 게이트는 그 변경이 나쁘다고 말한다. 40줄 끝의 게이트는 어느 40줄이 나쁜지 말한다.
숫자가 도움이 되지 않기 시작하는 지점
여기서부터는 믿지 않는다.
CRAP < 10은 사람의 코드 리뷰에서 나왔다. 동료가 쓴 코드를 읽는, 인내심에 한계가 있는 리뷰어를 위해 조율된 값이다. 임계값에 맞춰 최적화하는 에이전트는 정직한 40줄짜리 함수 하나를 더 나쁜 이름의 12줄짜리 함수 네 개로 쪼갤 수 있다. 로직은 똑같다. 함수당 복잡도는 떨어지고, 커버리지는 유지되고, 점수는 내려가고, 빌드는 초록이 된다. 코드는 나아진 게 없다. 숫자만 나아졌다.

중복은 반대 방향에서 무너진다. Dryer는 유사도 0.8 이상인 블록을 표시한다. 인자 아홉 개와 모드 플래그를 받는 공용 헬퍼를 뽑아내면 유사도가 임계값 아래로 떨어진다. 대체한 두 함수보다 읽기 어려운 함수 하나와 통과하는 검사 하나가 남는다. 도구가 재는 것은 모양이고, 모양은 더 나쁜 모양으로 쉽게 속일 수 있다.
뮤테이션 테스트는 정직한 게이트이고 값비싼 쪽이다. 변이체마다 스위트를 한 번씩 돌리므로 실제 시간은 스위트 실행 시간에 변이 개수를 곱한 값이다. 노트북에서는 견딜 만하고, 에이전트가 수정을 반복하는 루프 안에서는 괴롭다. 추측일 뿐이지만, 에이전트가 가장 먼저 대충 넘길 지점이 여기일 것이다. mutator를 건너뛰거나, 동작을 검증하지 않으면서 변이체를 죽이는 테스트를 쓴다. 함수가 null이 아닌 무언가를 반환하는지만 검증하는 테스트는 놀랄 만큼 많은 변이체를 죽이면서 사용자가 알아볼 만한 것은 아무것도 검증하지 않는다.
이제 게이트를 출하하는 에세이스트
이 프로젝트에는 README가 쓰지 않은 농담이 있다. Robert C. Martin은 20년 동안 논쟁의 대상이었다. 주로 Clean Code의 스타일 조언, 그 규칙이 값비싸게 얻은 경험이었는지 마케팅이 좋은 속설이었는지를 두고. 같은 저자가 이제 규칙을 임계값과 종료 코드를 갖춘 프로그램으로 내놓고, 읽지 말고 설치하라고 한다.
양보처럼 읽히고, 공정한 양보다. 에세이는 실행할 수 없다. 어떤 장에 몇 년씩 반대하면서도 결론을 내지 못할 수 있다. CRAP < 10에는 오후 한나절이면 반대할 수 있다. 자기 저장소에서 도구를 돌려 무엇을 바꾸라고 하는지 보면 된다. 스타일 논쟁은 누군가 숫자를 내놓는 순간 끝난다. 적어도 조용해지고 구체적으로 변한다. 코드에 관한 산문으로 유명한 사람이, 산문이 약한 부분이었다고 판단한 셈이다.
게이트가 보지 못하는 것
한계 하나를 분명히 적는다. 이것은 skill 파일 하나와 CLI 도구 네 개다. 이 묶음 어디에도 사람이 diff를 읽었는지 검증하는 것은 없다. 게이트는 에이전트가 만든 코드를 검사한다. 그 코드가 존재해야 한다는 데 누군가 동의했는지, 그 티켓이 할 가치가 있었는지에 대해서는 아무 말도 하지 않는다. 하나만 남길 수 있다면 남길 규칙인 Attack the Premise는 여전히 markdown 파일 속 한 문장이고, 모델이 지시를 따르려는 의지 말고는 강제하는 것이 없다. 컬렉션 전체에서 가장 강한 항목이 유일하게 프로그램을 뒤에 두지 않았다. 어떤 문제가 정말 어려운지가 거기에 드러난다.
설치하기 전에, 에이전트를 겨냥할 저장소에 crapper를 먼저 돌려라. 이미 함수 200개가 임계값을 넘고 있다면 첫 세션은 기능 개발이 아니라 리팩터링이 되고, 에이전트는 시킨 적도 없는 코드에 예산을 쓸 것이다. 그 숫자는 에이전트가 새벽 두 시에 대신 발견해 주는 것보다, 내가 먼저 보는 편이 낫다.
관련 글
서버 한 대, AI 스트리머 한 명: 야간 라이브를 돌리는 코드
open-yoki는 매일 밤 Binance Square에서 방송하는 AI 진행자의 프로덕션 코드로, 성격과 목소리, 돈에 닿는 기능은 걷어냈습니다. headless Chrome이 프레임을 그리고 ffmpeg이 RTMP를 밀며, Markdown 폴더가 그녀의 기분과 올릴 글을 정합니다.
Pinky는 agent에게 당신의 폰을 맡기고, 당신이 허용을 누를 때까지 전송 버튼을 붙잡고 있습니다
Pinky는 어떤 MCP agent든 실제 iPhone이나 Android 폰에 연결하고, 승인을 프롬프트가 아닌 자체 게이트웨이에서 강제합니다. 은행 앱은 보이지 않고 비밀번호 입력란은 손댈 수 없으며, Android 13에서는 agent가 숨겨진 두 번째 화면을 받습니다.
인터페이스의 AI 티를 잡아내고 9단계로 고치는 Claude skill
unslop은 Claude Code, Codex, Antigravity에서 도는 skill로, vibecoded 화면이 어디서 싸구려처럼 보이는지를 먼저 이름 붙여 줍니다. 제품에서 방향을 잡고 나면 디자이너가 redline review를 하듯 패스를 겹쳐 고칩니다. star는 19,413개이고, slop이 무엇인지에 대한 답도 분명합니다.
세계의 법을 git에 넣은 사람들, 이제 법조문도 blame할 수 있다
global-law는 각국 법령을 git 저장소로 보관하고, 커밋 하나가 특정 날짜에 시행된 법 하나에 대응한다. 조문에 log, blame, show, diff를 돌릴 수 있고, 어느 날 각국에서 시행 중이던 법을 확인하고, 코퍼스 전체를 MCP로 어시스턴트에 넘길 수 있다.