본문으로 건너뛰기

claude 플러그인으로 mvp 제작 하네스&루프 감잡기

이지영

2026.10.07

claude 플러그인으로 mvp 제작 하네스&루프 감잡기 본문 이미지

목적

하네스와 루프가 어떻게 돌아가는지 보고 싶어 claude 플러그인을 사용해 테스트 했습니다. 어디에 어떻게 돌아가는지는 목적에 따라 구조등이 다양할 것 같아서, 어디서부터 해야 할지 감을 잡는 중입니다. 이 글은 가장 작은 앱 하나로 그 감을 잡아 본 기록입니다.

플러그인

  • 하네스 : revfactory/harness

  • 루프 : ralph-loop

revfactory/harness
"하네스 구성해줘" 한마디로 도메인에 맞는 전문 에이전트 팀을 설계, 에이전트가 사용할 스킬까지 자동 생성

ralph-loop
반복하여 작업 목록을 순회하며 완료될 때까지 수행하는 장시간 실행형 AI 루프 시스템

Harness

출시당시 사용했던 revfactory/harness 는 완전히 md 파일 기반으로 토큰소비가 너무 커서 실망했었습니다. 지금은 더 좋은 대안이 있을 거 같은데 마침 V2 버전이 나온게 궁금하기도 하고 생성된 md 파일은 사후 지식층에 재사용할 수 도 있어 선택했습니다.

"MVP 자동생성 시스템 하네스 구성해줘" 에이전트 4개와 스킬 3개가 생겼습니다.

에이전트는 planner, architect, builder, qa 4개이고 스킬은 scoping, build-verify, orchestrator 3개

  • mvp-planner: 아이디어를 MVP 스펙으로 줄이고 성공 기준을 씁니다.

  • mvp-architect: 가장 단순한 기술 설계와 작업 목록을 만드는 역할.

  • mvp-builder: 작업 목록대로 코드를 구현해요.

  • mvp-qa: 구현된 앱을 실제로 실행해 보고 판정합니다.

왜 이렇게 나눴나

MVP를 만드는 과정은 다섯 단계로 나뉩니다. 인터뷰, 범위 확정, 설계, 구현, 검증이며, 각 단계는 파일을 주고받는 방식으로 연결됩니다.

  1. 인터뷰 : 이번 실행에서는 루프 안에서 기본값으로 생략했고, 그 결과 웹 페이지 형태, 최신순 정렬, 빈 입력 무시가 확인받지 않은 가정으로 남았습니다.

  2. 범위 확정: 핵심 흐름 하나를 골라 포함할 기능, 제외할 기능, Qa에서 실행으로 완료판정의 성공 기준을 정하는 단계, 기능을 줄이는 역할.
    ->포함 4개, 제외 7개, 실행성공 기준 8개

  3. 설계: 가장 단순한 스택을 골라 맨 앞에 작업 목록을 만드는 단계, 빌더가 스택을 즉흥으로 고르고 필요 없는 도구를 설치하는 것을 방지
    -> which로 확인한 Node 내장 모듈만 쓰는 설계로 의존성 0개와 작업 4개를 만들었고, 작업마다 확인 방법 기록

  4. 구현: 작업 구현 후 매번 실제로 실행해 확인하는 단계, 범위 밖 기능은 만들지 않고 제안으로만 남깁니다. 매번 실행하는 이유는 한꺼번에 만든 뒤 마지막에 확인하면 무너지기 쉽고, 실행 기록이 없으면 사후에 무엇을 확인했는지 알 수 없습니다.

    -> 작업목록 2~4번을 진행, 설계서의 test 스크립트가 Node 22에서 실패해 고치고 로그에 남김

  5. 검증 : 성공 기준을 한 줄씩 실제로 실행해 판정, 코드는 고치지 않고 보고만 합니다.

    -> 성공 기준 8개 통과, 차단과 일반 결함 0건, 참고 결함 3건, 사람이 직접 본 확인은 미확인으로 표시

    LOOP

루프는 어떻게 도는가

ralph-loop는 Claude가 턴을 끝내려 할 때마다 Stop hook이 끼어들어 같은 프롬프트를 다시 넣는 구조로 이번 실행은 최대 8회 중 3회 반복으로 The End.

이때 한가지만 보는데 완료 문구가 있나? 없으면 → 같은 프롬프트를 다시 밀어넣음

반복 1
오케스트레이터는 기본값으로 인터뷰 파일을 쓰고 mvp-planner를 백그라운드로 호출한 뒤 턴 끝 . Stop hook은 에이전트가 일하는 중인지와 상관없이 턴이 끝날 때마다 작동, 완료 문구가 없으면 같은 프롬프트가 다시 들어와 반복 하나 소모하게 된다.

So!

반복 2에서는 planner가 아직 일하는 중에 실행 되어 한번이 그냥 소모, 다음단계는 planner 가 만든 파일이 있어야 할 수 있는데 없으니 아무 일도 못하고 파일 생성을 기다리는 감시를 걸고 턴을 끝냄

다행히도!

반복 3에서는 턴을 끝내지 않고 파일이 생길 때까지 한 턴 안에서 기다림, 그 사이 범위 확정, 설계, 구현, 검증이 이어졌고, 마지막으로 npm test를 직접 재실행해 확인한 뒤 완료 문구를 출력하며 루프 완료.

한국 TV 채널의 일정 스크린샷

완료를 어떻게 믿는가

완료 문구를 내는 순간 루프가 끝나므로, 그 문구가 참인지가 전체 품질을 결정합니다. 이번에는 확인을 세 겹으로 쌓았습니다.

첫 번째는 빌더의 자체 확인
작업마다 직접 실행하고 명령과 출력을 03_builder_log.md에 남깁니다.

두 번째는 QA의 독립 실행
코드를 고치지 않고 성공 기준 8개를 한 줄씩 실행합니다. 이번에는 headless Chrome으로 클릭, Enter, 새로고침, 재시작 확인, 사람이 직접 본 확인은 아니라서 미확인으로 표시했습니다.

세 번째는 오케스트레이터의 재실행
완료 문구를 내기 직전에 npm test를 직접 다시 돌리고, 남은 서버 프로세스와 data/ 디렉터리를 확인

정직한 보고의 규칙 적용
실행하지 못한 항목은 통과가 아닌 미확인으로 씁니다.
다른 방법으로 대체했다면 대체했다고 명시합니다.
완료 문구는 조건이 모두 참일 때만 출력합니다.
보고서를 믿기 전에 사실을 한 번 더 확인합니다.
설계와 다르게 한 부분은 로그에 남깁니다.

---> 세션을 정리한 것으로 이것들이 실제인지 사람인 제가 확인하지 못했습니다.

기타

  • /harness:evolve 를 이용 : 이진 통과 평가에서 점수형 루브릭 평가 루프로 바꿈

    (기능: 생성된 하네스가 실제 개발 과정에서 겪는 실패(피드백)를 분석하여 에이전트 팀 구조와 스킬을 스스로 자가 진화(Self-evolution)시킵)

  • /goal 과 ralph-loop 와의 결과차이는 어떨까 하는 의문

  • 다음엔 claude-code-harness 를 써볼까

  • 스터디 마지막날엔 고도로 구조화된 시스템에 대해서 핸들링이 가능하길 희망합니다.

    배운점

할 게 많겠구나....

10

함께 이야기해요 10

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

댕댕이멍멍 프로필 이미지
댕댕이멍멍2026.10.07

하네스를 구성해 주는 플러그인인가 보네요!
자신만의 하네스를 구성하시는 여정을 기대하겠습니다. 🙂

이지영 프로필 이미지
이지영2026.10.08

네~^^ 적극적으로 스터디장님에게 물어서 완성하도록 하겠습니다. ㅋ

oneshot 프로필 이미지
oneshot2026.10.07

코드로 구조화된 루프, 기대되네요.

이지영 프로필 이미지
이지영2026.10.08

저도요. 뿌듯할 만큼 뭔가를 만들어야 겠는데,,잘 해볼께요

oneshot 프로필 이미지
oneshot2026.10.12

@이지영

지영 님 발표를 두 번이나 들었는데도 수준이 너무 높아서 못 쫓아가겠네요. 한참 더 공부해야겠어요.

이지영 프로필 이미지
이지영2026.10.13

@oneshot

단순하고 뻔한걸 용어를 풀지 못해서 그렇게 들리게 해드린점 죄송합니다^^::::

박승현 프로필 이미지
박승현2026.10.12

너무 어렵습니다 아아

이지영 프로필 이미지
이지영2026.10.13

실력이 부족하여 설명을 제대로 못하고 재밌었던 많은 사례로 즐거웠던 자리에 찬물을 끼얹은 바 ^^:: 분발하겠습니다 ^^

오코오니 프로필 이미지
오코오니2026.10.13

어려워서 저도 이해를 잘 못하겠어요.. ㅜㅜ

이지영 프로필 이미지
이지영2026.10.14

긴글 읽기가 싫어서 요약처럼 짧게 쓰다보니 "용어"를 좀 더 친화적으로 작성을 못했어요. 그래서 그러신건데 제가 사례글 작성에 다소 ^^::: 게을렀어요.

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

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

이런 사례도 있어요

사례 전체 보기