'점수도 순위도 매기지 않는다'를 구현에서 어떻게 지킬 것인가. Grift CLI가 다음 버전에서 정한 5가지 조건
Grift CLI는 점수나 순위를 매기지 않겠다고 약속하고 있습니다. 2026년 10월 대조 작업에서, 주석에는 순위가 아니라고 적혀 있으면서도 표는 커밋 수가 많은 순으로 정렬되어 있던 점이 발견되었습니다. 0.8에 부여하는 5가지 인수 조건을 발주처, SES 영업, 엔지니어 분들을 위해 알기 쉽게 작성합니다.
“점수나 순위를 매기지 않습니다.” Grift는 griftai.org에서도 cor-jp.com에서도 그렇게 약속하고 있습니다.
하지만 약속을 글에 적는 것과 소프트웨어가 그 약속을 지키는 것은 별개의 문제입니다. 이 글에서는 2026년 10월 25일에 Grift CLI 내부에서 발견한 어긋남과, 0.8 버전에 부과하기로 한 5가지 조건을 적습니다. 발주처 담당자분, 소개 회사·SES 영업 담당자분, 추천받는 측의 엔지니어분을 위해 가능한 한 알기 쉽게 썼습니다.
이 글을 쓴 다음 날인 2026년 10월 26일에 0.8.0을 공개했습니다. 사람 목록을 ID 순으로 정렬한 변경 내용은 0.8.0 릴리스 노트에 있습니다. 본문은 작성 시점(2026년 10월 25일)의 내용 그대로입니다.
현장에서 일어난 일
Grift CLI에는 하나의 저장소에 관여한 사람을 목록으로 표시하는 출력이 있습니다(actor-index). 이 글을 쓴 시점에 공개되어 있던 v0.7.2에서는 이 목록에 “커밋 수로 추출했을 뿐이며, 품질의 순위가 아닙니다”라는 주석이 달려 있습니다.
그런데 표의 행은 커밋 수가 많은 순서대로 정렬되어 있었습니다.
주석은 “순위가 아니다”라고 말하고, 표의 정렬은 커밋 수로 결정되어 있다. 읽는 사람의 눈에 먼저 들어오는 것은 주석이 아니라 표입니다. 가장 윗줄에 있는 사람을 “가장 잘한 사람”으로 읽어 버리는 것은 읽는 이의 책임이 아니라 정렬 방식의 책임이라고 생각했습니다.
같은 날 대조 작업 중 또 하나의 결손을 발견했습니다. grift align는 프로젝트 측이 선언한 요구 사항과 후보자의 관측 결과를 나란히 놓는 방향만 가졌을 뿐, 엔지니어 측이 프로젝트에 바라는 점을 선언할 수 있는 입구가 없었습니다. “추천하는 사람에게도, 추천받는 사람에게도”라고 적어 온 약속의 절반이 구현에는 없었던 셈입니다.
둘 다 Cor.가 자사 사이트의 문구와 CLI 출력을 한 줄씩 대조하며 찾아낸 것입니다. 이용자로부터 지적받은 것이 아닙니다. 발견한 당일, 아키텍처 결정 기록(ADR)으로 문서화했습니다.
왜 정렬 순서만을 먼저 바로잡는가
커밋 수 표기 자체를 중단하면 된다는 생각도 있습니다. Grift는 그렇게 하지 않았습니다.
커밋 수는 분모가 있는 사실입니다. griftai.org의 데모에 나오는 “274건 중 73건”도 모수가 없으면 읽을 수 없습니다. 이를 지워 버리면 이용 규범 제1조 “부재를 부정적으로 해석하지 않는다”와도 충돌합니다. 지우는 것은 값이 아니라 정렬 순서입니다.
정렬 순서는 사실이 아니라 보여주는 방식의 선택입니다. 누가 많은지를 맨 앞에 배치하는 것은 받아보는 측으로 하여금 순위로 읽히게 만드는 연출 방식입니다. 다음 버전에서는 목록의 기본 정렬을 ID의 사전순으로 바꿉니다. 커밋 수 값은 남습니다. 커밋을 늘려도 표의 상단에 올라오지 않게 됩니다.
0.8 버전에 부과하는 5가지 조건
0.8 계열의 모든 변경 사항에 다음 5가지 인수 조건을 부과하기로 했습니다.
1. 관측한 양으로 사람을 정렬하지 않는다
사람을 나열하는 출력의 기본 정렬은 ID 사전순으로 하며, 커밋 수·라인 수·일수 등의 관측량에 의존하지 않도록 합니다. 값 자체는 분모가 있는 사실로서 유지합니다.
2. 양으로 선별할 때는 양임을 이름과 주석으로 명시한다
--top N라는 옵션은 관측된 커밋 수가 많은 N명을 추출합니다. 이는 양에 따른 선별입니다. 다음 버전에서도 유지하겠지만, 도움말과 출력 주석에 “선별 기준은 커밋 수이며, 품질이나 순위가 아니다”라고 계속 기재합니다. 이름을 바꿀지 혹은 폐기할지는 기존 사용 방식을 깨뜨리는 변경이 되므로 그다음 버전에서 판단합니다. 관측량을 기반으로 새로운 선별 메커니즘을 만드는 일은 하지 않습니다.
3. 참조 분포상의 위치는 요청받았을 때만 표시한다
Grift에는 공개 저장소의 참조 분포 속에서 해당 저장소의 값이 어느 구간에 있는지를 표시하는 기능이 있습니다. 사람이 아니라 저장소의 위치이지만, 직접 실행한 본인에게는 “내 저장소는 상위 N%“로 읽힐 수 있습니다. 비율을 높이면 구간도 올라갑니다. 다음 버전 이후로는 참조 분포의 버전을 명시하여 요청했을 때만 표시하며, 기본적으로는 “참조 분포가 요구되지 않음”이라는 사유가 적힌 미관측 상태로 둡니다.
4. 수치의 “부풀리는 방법”을 공개하되, 보정은 하지 않는다
테스트 동시 수정률은 테스트 파일에 형식적인 1줄만 변경해도 올라갑니다. 변경한 라인 수는 보지 않습니다. 최근 180일의 변경 일수는 매일 1건의 작은 커밋으로 채울 수 있습니다.
이러한 경로는 수치 옆에 고정된 문장으로 함께 적습니다. 가중치 부여나 보정은 하지 않습니다. 이용 규범 제7조가 맥락이나 난이도에 따른 수치 보정을 금지하고 있기 때문입니다. 공개의 목적은 읽는 이가 수치의 한계를 알도록 돕기 위함입니다. 수치 부풀리기를 적발하는 기능이 아닙니다.
5. 선언과 관측을 섞지 않는다. 양방향 모두에서
프로젝트 측의 요구 사항은 “선언”이고, 후보자의 git 이력은 “관측”입니다. grift align는 이 두 가지를 축별로 나란히 놓고, 일치·범위 외·0건·미관측·요구 없음의 5가지 형태로 표시합니다. 종합 점수도 순위도 합격/불합격 판정도 만들지 않습니다.
엔지니어 측이 프로젝트에 바라는 점을 선언하는 입구를 만드는 경우에도 동일한 5가지 표현과 동일한 금지 사항을 적용합니다. 어느 방향이든 선언과 관측은 서로 다른 칸에 둡니다.
읽는 입장에 따라
발주처 담당자분께. 목록 상단에 있는 사람이 우수한 사람이라는 식의 해석은 다음 버전부터 불가능해집니다. 정렬은 ID 순입니다. 수치는 면담에서 질문할 내용을 구체화하는 재료로 사용해 주십시오.
소개 회사·SES 영업 담당자분께. 후보자 본인이 공유한 기록을 순위표로 재구성하여 사용하는 것은 이용 규범에 위배되는 사용 방식입니다. 추천 사유는 값과 분모, 그리고 관측할 수 없었던 이유를 덧붙여 전해 주십시오.
자체 서비스 개발사 채용 담당자분께. 공유받은 기록을 바탕으로 순위나 합격/불합격을 가리는 것 역시 이용 규범에 위배되는 사용 방식입니다. 수치는 면담에서 질문할 내용을 구체화하는 재료로 사용해 주십시오.
엔지니어분께. 커밋을 늘려도 목록의 상단에 오르지 않습니다. 제출할 저장소를 선별했다는 사실 자체는 받아보는 측이 알 수 있는 형태로 남습니다. 선별하는 것을 금지하지는 않습니다. 숨기지 않을 것을 요구합니다.
마치며
약속은 글에 적는 것만으로는 지킬 수 없습니다. 문구와 구현이 어긋나 있다면 구현을 바로잡고, 바로잡은 경위를 공개합니다.
이 글을 쓴 시점에는 0.8이 아직 출시되지 않았습니다. 정렬 순서를 바꾸면 이전 버전에서 저장한 목록의 검산 결과가 일치하지 않게 되므로, 정의 버전을 올리는 작업과 함께 내보낼 예정이었습니다. 0.8.0은 정의 버전을 올려 2026년 10월 26일에 공개했습니다.
참고 자료
- Grift - 제품 사이트. 3가지 약속과 관측 항목
- grift-cli (GitHub, MIT) - CLI 소스 코드
- grift-cli 0.8.0 릴리스 노트 (GitHub) - 2026년 10월 26일에 공개된 0.8.0의 변경 사항
- grift-cli 0.7.2 (PyPI) - 이 글을 쓴 시점에 공개되어 있던 버전
- TEP 이용 규범 (norms) - 제1조 “부재를 부정적으로 해석하지 않는다”, 제7조 “가중치 부여·환산 금지”,
--top N및grift align취급 - grift 리포트 읽는 법 (metrics-guide) - 지표별 알기 쉬운 해설과 십분위수 표기 규칙
- Grift 도입 사례 페이지 - cor-jp.com의 실적 소개
이 글의 내용을 회사에서 진행하고 싶다면
인재 소개 회사・SES 기업・자체 개발 기업을 위한 Grift 시범 도입(PoC) 상담은 AI 접수 「Cloudia」에서 받고 있습니다.
Support this article
If this article was helpful, please support us with a tip. You can choose any amount.
관련 글
Git 이력에서 무엇이 보이고 무엇이 보이지 않는가. Grift로 OSS 4개를 검산했다
git 이력에서, 밝힌 규칙으로 셀 수 있는 것과 셀 수 없는 것을 나눕니다. 실재하는 OSS 4개를 저장소 단위로 검산했습니다. 사람의 능력이나 기록이 완전하다는 것은 보증하지 않습니다.
AI 개발·수탁 개발 견적이 개인 역량에 의존하게 되는 이유 ~ 근거를 회사의 자산으로 바꾸는 방법
수탁 개발 견적이 사람마다 달라지는 이유와 GitHub 실적, 시장 시세, 공수 내역을 활용하여 설명 가능한 견적 근거를 구축하는 방법을 설명합니다. Grift 활용에 대한 접근법도 소개합니다.
AI 기반 개발(AI 주도 개발)이란? 속도뿐만 아니라 프로덕션 품질을 높이는 개발 체제 구축 방법
AI 기반 개발을 단순한 코드 생성에 그치지 않고, 요구사항 정의, 리뷰, 테스트, 운영에 이르기까지 프로덕션 품질로 내재화하는 접근 방식을 설명합니다. AI 개발을 내재화하고자 하는 기업을 위한 글입니다.