ub-mode: Clean Code 저자 Uncle Bob의 에이전트 코딩 3단계 규칙과 품질 게이트

Robert C. Martin · unclebob/ub-mode · ax-trend 이슈 #3554 · 2026-10-27 공개

ub-mode — Clean Code 저자의 에이전트 코딩 규칙 3단계
개요 — SKILL.md 파일 하나로 에이전트에게 코딩 규칙을 심는 방식입니다

SKILL.md 파일 하나를 복사하면 끝나는 규칙 모음입니다

Robert C. Martin(Uncle Bob, 『Clean Code』 저자)의 에이전트 스킬 저장소 unclebob/ub-mode를 Vox(@Voxyz_ai)가 2026-10-26 23:25 X 게시물로 소개했습니다. 설치는 SKILL.md를 에이전트 스킬 폴더에 ub-mode/SKILL.md로 복사한 뒤 /ub-mode 명령을 실행하는 방식입니다. 별도 패키지 설치 단계가 없어 도입 장벽은 낮습니다.

저장소 실측 수치는 다음과 같습니다. 생성일은 2026-10-25이며, 커밋은 4개, 스타는 약 1,320개, 포크는 65개입니다. 다만 라이선스는 미표기 상태입니다. 저장소가 공개되어 있어도 LICENSE 파일이 없고 API license도 null이므로, 오픈소스 라이선스 조건으로 쓰기 전에는 확인이 필요합니다.

에이전트 코딩의 실패는 대개 모델 성능이 아니라, 테스트 없이 코드를 바꾸고 원인을 덮는 습관에서 옵니다. ub-mode는 그 습관을 규칙 세 개로 막는 데 초점을 맞췄습니다.

작업 흐름은 세 단계로 고정됩니다

작업 흐름은 먼저 동작하게 만들고(First Make it Work), 다음에 바로잡고(Then Make it Right), 관행을 따르는(Follow Practice) 순서입니다. 첫 단계의 핵심은 TDD입니다. 코드를 바꾸기 전에 실패하는 테스트를 먼저 쓰고, 기대한 이유로 실패하는지 확인한 뒤, 통과시키는 가장 작은 변경을 합니다. 정직한 테스트가 어려우면 나쁜 테스트를 쓰지 않는다는 원칙도 함께 적혀 있습니다.

두 번째 단계의 핵심은 근본 원인 수정입니다. 문제를 재현하고 원인을 고쳐야 하며, 충돌만 숨기는 가드는 수정이 아닙니다. 검증력이 없는 테스트는 버리라는 문구도 원문에 있습니다. 모든 함수가 아무것도 반환하지 않아도 통과하는 테스트는 버리라는 취지입니다.

ub-mode 작업 흐름 — 동작, 바로잡기, 관행과 품질 게이트
흐름 — 실패 테스트부터 근본 원인 수정, 품질 게이트까지 세 단계가 이어집니다

품질 게이트는 동반 도구 3종이 맡습니다

품질 게이트는 crapper·dryer·mutator 3개 도구로 수행됩니다. crapper는 CRAP 10 미만을 기준으로 복잡도를 걸러내고, dryer는 중복 유사도 0.8 이상을 제거 대상으로 삼으며, mutator는 미커버·생존 뮤턴트·죽은 코드를 정리합니다. 세 도구는 ub-mode 저장소가 아니라 별도 저장소로 이미 존재하며, 모두 0BSD 라이선스입니다.

도구이슈에 적힌 역할GitHub 스타
crapperCRAP 10 미만 기준의 복잡도 게이트122개
dryer중복 유사도 0.8 이상 제거49개
mutator미커버·생존 뮤턴트·죽은 코드 정리62개
동반 품질 게이트 도구 3종의 GitHub 스타 — crapper 122, dryer 49, mutator 62
수치 — 동반 도구 3종의 스타는 ub-mode 본체(약 1,320개)보다 한참 작습니다

즉 스킬 파일 하나만 복사해서는 품질 게이트가 온전히 동작하지 않습니다. 게이트를 전부 쓰려면 동반 도구 3종을 별도로 설치해야 합니다. 이 지점이 도입 시 가장 먼저 확인해야 할 부분입니다.

pstack 원전과의 관계: 축소판이라는 위치가 핵심입니다

README는 ub-mode가 poteto-mode/pstack 규칙의 축소(reduced) 파생임을 스스로 명시합니다. 원전 pstack은 10월 16일에 ax-trend #3293으로 이미 다뤘습니다. 따라서 ub-mode는 완전히 새로운 규칙이 아니라, 유명 저자가 줄여서 품질 게이트 도구와 묶어 내놓은 버전으로 보는 편이 정확합니다. pstack 원전을 이미 쓰는 팀에는 중복이 될 수 있습니다.

반대로 아직 코딩 규칙을 정하지 않은 팀에는 축소판이라는 점이 장점이 될 수 있습니다. 파일 하나와 세 단계만으로 시작할 수 있고, 필요해지면 원전이나 동반 도구로 넓혀갈 수 있기 때문입니다.

아직 안 밝혀진 점도 분명합니다. "버그를 숨기거나 부실한 테스트로 속이는 일을 막을 수 있다"는 게시물 주장은 효과가 측정되지 않은 홍보성 표현입니다. 스킬이 규칙을 제시하는 것이지 결과를 보장하지 않습니다. "도구가 없으면 해당 단계를 건너뛴다"는 내용도 SKILL.md·README 원문에서 확인되지 않았으므로 미확인입니다. 저장소가 생성 2일차·커밋 4개로 얇고, 스타 급증은 화제성일 뿐 안정성 근거가 아닙니다. 이슈에 실린 N=1 대조 실험에서도 스킬 유·무 두 그룹이 동일하게 실패해 결과가 갈리지 않았는데, 속임수 유인이 없는 쉬운 과제라 스킬 무용을 증명하지는 않습니다.

실무 판단: 먼저 확인할 것

실무 판단은 이렇게 정리됩니다. pstack을 이미 쓴다면 ub-mode를 추가할 이유가 거의 없습니다. 규칙이 겹치기 때문입니다. 새로 도입한다면 스킬 파일부터 복사해 세 단계를 한 작업에 적용해보고, 품질 게이트가 필요하다고 판단될 때 동반 도구 3종을 순서대로 붙이는 편이 안전합니다. 라이선스 미표기는 업무용 저장소에 쓰기 전에 반드시 확인해야 합니다. 효과는 게시물 문구가 아니라 자기 팀 작업에서의 실패 테스트 작성률과 재발률로 직접 재는 과정이 도입 결정보다 앞에 와야 합니다.

원문 이슈

AI 코딩코드 유지보수AX Trend