본문으로 건너뛰기

자비스 작업 개선과 대시보드 모니터 개선

Elly

2026.10.20

자비스 작업 개선과 대시보드 모니터 개선 본문 이미지

소개

지난 사례발표에 아이콩님의 발표를 듣고 하네스 평가를 '리뷰어' 작업을 모니터하는 방법을 시도해볼만하겠다는 생각이 들었습니다.

또 이번주 베스트 사례발표에서 물결2님의 하네스 방식과 자비스의 제 작업 방식을 비교해 보았습니다.

두가지 사례를 참고해서 반영한 결과를 공유합니다.

진행 방법

1. 리뷰어의 검수 기록을 대시보드에 넣었습니다

  • 기록 방식: 검수 1회를 한 항목으로 적고, 지적마다 심각도(중대·보통·경미), 유형, 반영한 작업, 재검수 결과를 적습니다. '해결'은 리뷰어가 다시 보고 해결로 판정했을 때만 씁니다. 작업자가 반영했다고 적었어도 리뷰어가 아직 보지 않았으면 '재검수 전'입니다.

한국 축구대표팀 일정 스크린샷

2. 대시보드에 할 일(TODO) 보기를 추가했습니다

  • 완료된 작업과 진행할 작업을 대시보드에서 보고 싶었습니다. 처음에는 부서별 TODO 파일을 그대로 나열했더니 보기 어려웠고, 항목을 접어도 소용이 없었습니다. 이 파일이 마스터와 담당자끼리 주고받는 메모라 개발 용어로 쓰여 있기 때문입니다.

  • 그래서 개발 문서 TODO.md의 기능 묶음 11개(가입·로그인, 계산기, 가계부 등)를 기준으로 바꿨습니다. 기능마다 쉬운 이름과 한 줄 설명, 상태 막대, "작업 N개 중 N개 끝남"을 카드로 보여 줍니다. 상태는 문서의 문장을 읽어 끝남, 진행 중, 사용자 확인 대기, 시작 전으로 자동 분류합니다.

  • 기능을 넣으면서 개발 문서와 의논사항 문서의 상태가 어긋난 곳이 발견되어 일치하도록 보완했습니다.

한국 컴퓨터 화면의 스크린샷

3. 물결2님의 하네스와 비교해 자비스를 보완했습니다

물결2님의 하네스 사례 발표를 듣고, 그 하네스와 제 자비스의 작업 방식을 비교해 보았습니다. 발표를 듣고 나서 사례 게시글과 소개된 저장소(https://github.com/dolsol3/harness-starter-skill)는 README와 가이드를 클로드 코드에게 읽혀 분석시켰습니다.

  • 물결2님 방식은 규칙을 훅(특정 동작 전후에 자동으로 실행되는 검사)으로 강제합니다. 진행 중인 작업이 없으면 코드 수정을 거절하는 식입니다. 자비스는 규칙을 문서에 적고 마스터가 지키기를 기대하는 대신, 검수 기록과 대시보드로 지적과 반영을 집계합니다. 목적이 달라 전체를 설치하지 않고 자비스에 맞는 아이디어만 참고했습니다.

  • 훅으로 막을 수 없는 부분을 기록으로 확인하기 위해 마스터에게 세 가지를 요청했습니다.

    • 진행 기록에 담당(배정했는지, 마스터가 직접 했는지)과 수정한 파일 적기. 물결2님 글의 "같은 폴더를 건드리는 작업은 동시에 하지 않는다"를 보고 더했습니다.

    • 작업을 완료로 표시할 때 근거가 되는 검수 번호 적기. 검수를 받지 않았으면 "검수 전 완료"로 표시합니다.

    • 검수 기록에 작성 도구와 검수 도구 적기. 마스터와 리뷰어가 같은 계열이라 생기는 문제를 나중에 세기 위한 것이고 도구를 바꾸라는 요청은 아닙니다.

  • 마스터는 이 세 가지와 앞에서 말한 검수 시각 기록을 모두 하겠다고 답했고, 규칙 문서에 한 줄씩 반영했습니다. 같은 파일을 여러 담당이 동시에 고친 사례는 기록에서 확인되지 않았고, 부서들이 같은 저장소 하나를 쓴다는 구조만 확인했습니다.

  • 뺀 것: 물결2님 글의 "멈춤/진행 가능" 질문 구분을 보고 사용자 확인 대기를 나누자고 제안했다가 뺐습니다. 의논사항 때문에 작업이 멈춘 기록을 찾지 못했고, 의논사항 화면에 권고와 시점이 이미 나오고 있었습니다.

결과와 배운 점

검수 결과

  • 검수 14회에서 지적 39건이 나왔습니다. 중대 13건, 보통 19건, 경미 7건입니다. 해결 30건, 미해결 4건, 철회 2건, 재검수 전 3건입니다. 중대 13건 중 10건은 해결됐고 2건은 미해결, 1건은 재검수 전입니다.

  • 가장 많은 유형은 '수용기준 누락'으로 12건입니다. 검수 6회에 걸쳐 나왔습니다.

  • 코드를 검수한 뒤에도 중대 지적이 나왔습니다. 계산 공유글 본문과 작성자 실명이 검색 결과에 나오는 문제, 닉네임이 없는 작성자의 실명이 공개 카드에 나오는 문제입니다. 모두 공개 화면에 비공개 정보가 나오는 문제인데, 같은 원인인지는 확인하지 못했습니다. 앞의 문제는 마스터가 고쳐 리뷰어가 해결을 확인했고, 마지막 문제는 마스터가 반영했고 재검수 전입니다.

재개한 마스터가 부서에 일을 배정하지 않았습니다

  • 상황: 쉬었다가 재개한 마스터가 부서에 작업을 배정하지 않고 혼자 착수하고 있는 것을 보게 되었습니다.

  • 마스터의 설명: 부서 좌석은 살아 있었지만 작업이 자동으로 배정되는 상태가 아니었고, 이를 확인하지 않은 채 혼자 시작했습니다. 재개 절차를 빠뜨렸다고 인정했습니다.

  • 이 문제는 검수 기록이 아니라 제가 직접 확인해서 발견했습니다. 대시보드는 리뷰어의 지적과 반영을 보여 줄 뿐, 부서에 일이 배정됐는지는 보여 주지 않습니다. 부서 구조가 있어도 마스터가 재개 절차를 지키지 않으면 혼자 일하게 됩니다.

  • 고친 방법: 재개 절차를 파일로 남기게 했습니다. 새 세션이 자동으로 읽는 AGENTS.md에서 MASTER_TODO.md의 절차로 이어집니다. 좌석 상태 조회, 인계 읽기, 역할별 작업 전달, 실제 착수 확인, 막힌 좌석은 사용자에게 알림, 확인 결과 기록 순서입니다. 기록된 위치는 직접 열어 확인했습니다.

  • 고친 뒤 첫 재개에서 개발과 디자인은 작업 중이었습니다. 리뷰어는 검수 요청 1건이 입력 대기로 막혀 있었고, 마스터는 이를 진행 중으로 보고하지 않고 제게 확인을 요청했습니다.

  • 확인하지 못한 것: 마스터가 혼자 한 작업의 범위, 같은 일이 이전에도 있었는지, 이 절차가 다음 재개에서도 지켜지는지입니다.

한계

  • 하네스 없이 같은 작업을 한 결과와 비교하지 않았으므로 이 기록만으로 하네스가 좋아졌다고 증명할 수 없다고 합니다.

  • 지적 건수는 리뷰어가 찾은 것만 센 값입니다. 놓친 결함은 알 수 없습니다.

  • 초기 검수 기록 일부는 검수자가 비어 있고, 검수 시각은 어느 검수에도 없습니다.

  • 대시보드의 상태 분류는 문서의 문장을 읽는 규칙이라 틀릴 수 있고, 원본 문서가 어긋나 있으면 그대로 어긋납니다.

  • 마스터가 새 기록 형식을 실제로 지키는지는 아직 확인하지 못했습니다. 대시보드 화면이 이해하기 쉬운지 평가한 기록도 없습니다.

도움 받은 글 (옵션)

  • 공정표(아이콩)님의 사례글:

    AI 리뷰어를 붙이면 회의록이 더 좋아질까? 실제 업무로 A/B/C 비교해보기

    https://www.gpters.org/nocode/post/ai-ribyueoreul-butimyeon-hoeyirogi-deo-johajilgga-silje-eobmuro-a-b-c-8i4FwVU9HskY0fp

  • 물결2님의 사례글:

    「하네스란? 스킬로 모든 프로젝트에 '하네스 씌워줘' 한마디로 끝!!」

    https://www.gpters.org/nocode/post/what-harness-all-projects-9S3J8dsL0n5YG2d

함께 이야기해요 0

로그인하고 댓글을 남겨 주세요

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기