[2편] Claude Code 하네스로 ‘알아서 개발하는’ MVP 공장 만들기 — 공장 조립하기
2026.10.14
![[2편] Claude Code 하네스로 ‘알아서 개발하는’ MVP 공장 만들기 — 공장 조립하기 본문 이미지](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2F05ef39e0e58db70dd1576256.jpg&w=3840&q=75)
소개
1편에서는 하네스가 무엇인지 정리하고, 회사의 문서 결재 흐름을 옮긴 ‘MVP 공장’ 설계도를 그렸습니다. 작성자(A), 검토자(B), 최종 검토자(AQ)를 각각 다른 에이전트가 맡고, 사람은 승인©만 하는 구조였습니다.
2편은 그 설계도로 공장을 조립하고 실제로 돌려 본 기록입니다. 결론부터 말하면, 설계도를 그대로 조립하지 않았습니다. 조립을 시작하자마자 설계를 두 번 크게 고쳤습니다. 하나는 결재 대상을 코드에서 개발계획서(문서)로 바꾼 것이고, 다른 하나는 검토 흐름에 “반영 확인” 단계를 넣은 것입니다. 이 글의 절반은 무엇이 왜 바뀌었는지에 대한 이야기입니다.
1편 연재표에 "서브에이전트 4종"이라고 적었는데, 실제로는 작성자·검토자·중간관리자 3종이면 충분했습니다. 바로잡습니다.
진행 방법
2주차는 “부품을 하나씩 따로 시험한 뒤 연결하는 주”로 잡았습니다. 에이전트를 한꺼번에 만들어 연결하면, 공장이 멈췄을 때 어느 부품이 문제인지 알 수 없기 때문입니다. 손으로 한 번 돌려 본 순서를 커맨드 하나로 굳히는 것, 그것이 이번 주에 말하는 '절차 만들기’입니다.
진행 순서는 D0~D8 아홉 단계였습니다.

1) 1주차 계획과 달라진 점, 그리고 이유
큰 변화 ① 결재 대상: 코드 → 개발계획서
1편 설계는 “PRD를 넣으면 코드가 나오고, 그 코드를 결재받는” 공장이었습니다. 그런데 조립 계획을 세우다 보니 시작부터 막혔습니다. GitHub 리포는 어디에 만들지, 기술 스택은 무엇으로 고정할지 같은 결정이 먼저 필요했기 때문입니다.
그때 제가 원래 하던 워크플로우를 다시 설명했습니다.
개발계획서를 작성하면, 다른 사람이 검토하여 수정사항이 있으면 메모를 작성하여 회신하고, 다시 메모를 반영하여 재검토 요청을 하고, 검토가 완료되면 중간관리자가 검토하고, 여기서 수정사항이 발생하면 메모를 회신하고 작성자가 수정 후 검토하고 중간관리자가 다시 검토하여 승인자에게 승인 요청. 승인자가 수정사항이 있으면 다시 메모를 작성하여 작성자에게 회신하여 워크플로우를 타고 승인자에게 문서가 올라오면 승인.
제 워크플로우에서 결재를 받는 것은 개발계획서라는 문서였습니다. 그리고 이 흐름의 핵심인 “메모 → 반영 → 반영 확인” 반복은 코드 없이 문서 한 건으로도 전부 시험할 수 있었습니다. 그래서 순서를 바꿨습니다. 1단계(이번 주)에서는 개발계획서 결재 절차를 먼저 검증하고, 2단계(3편)에서 승인된 계획서대로 코드를 만듭니다. 덕분에 GitHub와 스택 결정 없이 바로 시작할 수 있었습니다.
큰 변화 ② 검토 흐름: “다시 검토” → “반영 확인”
1편 설계에서는 ② 검토에서 지적이 나오면 ③에서 고치고, 다시 ②로 돌아가 처음부터 검토했습니다.

실제 결재를 떠올려 보니 순서가 달랐습니다. 검토자는 수정본을 처음부터 다시 읽지 않습니다. 자기가 낸 지적사항이 반영됐는지를 하나씩 확인하고, 전부 확인돼야 다음 결재자에게 넘깁니다. 그래서 2-1(반영 확인)과 3-1(재반영)을 넣었습니다.

이 흐름을 위해 두 가지 규칙을 정했습니다.
2-1은 다시 검토가 아니다. 검토자는 자기가 낸 번호가 고쳐졌는지만 판정합니다. 새 문제는 고치다가 생긴 것만 올립니다. 아무 문제나 추가할 수 있으면 2-1이 2와 같아져서 끝나지 않습니다.
중간관리자와 승인자의 메모도 같은 장부에 번호로 올린다. 그 번호도 작성자 수정 → 검토자 확인 → 중간관리자 → 승인자 순서로 다시 올라갑니다. 제 워크플로우의 “워크플로우를 타고 다시 올라온다” 그대로입니다.
역할이 바뀐 이유: 형식 · 내용 · 책임
1편에서는 검토자와 최종 검토자가 무엇을 보는지가 겹쳐 있었습니다. 조립 중에 제가 역할을 다시 정의했습니다.
역할 | 1편 | 2편 |
검토자 | 지적사항 검토 + 승인 요청서 작성 + PR 생성 | 형식만: 양식 구성, 띄어쓰기·맞춤법, 표기, 글꼴·크기 |
최종 검토자 → 중간관리자 | AQ: PRD 기준 기능 확인 + 테스트 | 내용만: 핵심 전략과 허용 기준이 타당하고 측정 가능한가 |
승인자 | PR 승인 또는 반려 | 승인하면 이 계획서가 수행되는 과정에 책임을 진다 |
역할을 이렇게 나누니 각 에이전트가 볼 것과 보지 말아야 할 것이 분명해졌습니다. 검토자는 "충분히 빠르게" 같은 내용 문제를 발견해도 지적하지 않고 "중간관리자 참고"로만 넘깁니다. 중간관리자는 띄어쓰기를 보지 않습니다.
계획 대비 달라진 점 전체
1주차 계획 | 실제 | 이유 |
결재 대상: 코드(MVP) | 개발계획서(문서). 코드는 3편으로 | 원래 워크플로우가 문서 결재. 핵심 흐름을 코드 없이 검증 가능. GitHub·스택 결정에 막히지 않음 |
② 검토 ↔ ③ 수정, 0건까지 반복 | 2 → 3 → 2-1 반영 확인 ⇄ 3-1 재반영 | 실제 결재에서 검토자는 처음부터 다시 읽지 않고 반영 여부를 확인한다 |
④ AQ 불합격 → ③ | 중간관리자 수정 메모 → 장부 → 3-1 → 2-1 → 4 | 중간관리자 메모로 고친 것도 검토자가 형식을 다시 확인해야 한다 |
승인자 반려 경로 없음 | 승인자 수정 메모 → 장부 → 3-1 → 2-1 → 4 → 5 | 원래 워크플로우에 있던 경로 |
서브에이전트 builder·reviewer·qa (연재표엔 4종) | builder·reviewer·manager 3종 | 역할을 형식·내용·책임으로 다시 나눔 |
reviewer: "읽기 전용" + review.md 작성 + PR 생성 | 검토자는 판정만 돌려주고, 장부 기록은 결재를 지휘하는 메인 세션이 한다 | 읽기 도구만 주면 파일을 쓸 수 없다. 조립 전에 발견한 설계 모순 |
qa는 "앞의 대화를 모르는 새 컨텍스트" | 중간관리자에게 요구사항 메모와 계획서만 넘기고 장부는 넘기지 않는다 | 서브에이전트는 원래 모두 빈 컨텍스트에서 시작한다. 독립성은 "무엇을 넘겨주느냐"로 정해진다 |
review.md = 지적사항과 반영 내역 | 지적 장부: 번호마다 상태(열림·반영함·확인됨·미반영·보류)와 출처(2 검토·2-1 수정 부작용·4 반려·5 반려) | 공장이 "확인됨이 아닌 번호가 0개인가"를 세어 다음 단계를 정하려면 상태 값이 고정돼야 한다 |
훅으로 테스트 강제 (테스트 실패 시 승인 요청 차단) | 형식 자동 검사 스크립트 + 권한 설정. 테스트 훅은 3편으로 | 문서에는 테스트가 없다. 기계로 판정할 수 있는 형식(장·절 구성, 작성 안내, 빈 칸, 번호, 버전)은 스크립트가 검사한다. 다만 지금은 커맨드가 스크립트를 실행하는 방식이라, 훅처럼 "건너뛸 수 없게" 강제하지는 못했다 |
/build-mvp | /review-plan. 기억이 아니라 파일을 읽어 지금 단계를 정한다 | 사람의 답을 기다리느라 멈췄다가 다시 실행해도 그 자리에서 이어져야 한다 |
GitHub MCP로 PR 생성 | 승인 요청서와 계획서를 Word 결재 양식(표지·결재란·개정 이력·목차)으로 변환해 승인자에게 제출 | 승인자는 사람이고 문서 결재다. PR은 코드를 다루는 3편에서 쓴다 |
반복 상한 ②↔③ 3회 | 2-1은 반영 흐름마다 3회, 중간관리자 수정 메모는 결재 전체에서 2회 | 실제로 돌려 보니 결재 전체에서 2-1은 7번 돌았다. 흐름마다 세지 않으면 정상적인 결재가 멈춘다 |
(없음) | 사람만 아는 정보는 | 요구사항 메모의 빈틈을 작성자가 마음대로 채우면 범위가 넓어진다 |
trace.md 추적표 | 3편으로. 지금은 지적 장부와 git 커밋이 추적 역할 | 코드가 생겨야 기능 ↔ 파일 ↔ 테스트를 이을 수 있다 |
(계획에 없음) | 결재 양식 6종(Word), 절차서 | 결재 문서답게 표지·결재란·개정 이력·목차가 필요했다. 남이 따라 하려면 절차서가 필요했다 |
2) 부품 조립과 시험
부품마다 일부러 틀린 문서를 만들어 정말 잡아내는지 시험했습니다. 시험 문서에 무엇을 심었는지 적은 설명 파일은 에이전트에게 보여 주지 않았습니다.
작성자 (builder)
요구사항 메모를 보고 개발계획서를 쓰고, 장부에서 받은 번호만 고칩니다. 장부 기록, 검토, 승인, 커밋은 하지 않습니다.
• 혼자 불러 시험해 보니 한 번에 양식과 장·절이 같은 계획서가 나왔습니다.
• 작성자가 규칙끼리의 충돌을 스스로 보고했습니다. "표에 빈 칸을 남기지 않는다"와 "승인 칸은 승인자만 채운다"가 부딪친다는 것입니다. 승인 칸을 예외로 규칙에 넣어 풀었습니다. 규칙을 파일로 남겨 두니 AI가 규칙의 모순까지 찾아 줍니다.
• 요구사항 메모의 빈틈 4개(날짜 형식 등)를 "정하지 않고 남겨 둠"으로 보고했습니다. 마음대로 채우지 않았습니다.
검토자 (reviewer) — 형식
형식을 둘로 나눴습니다. 기계로 판정할 수 있는 형식은 스크립트가 검사합니다. 장·절 구성, 작성 안내 삭제, 빈 칸, 기능 ID 형식, 버전 일치가 여기에 해당합니다. 판단이 필요한 형식은 AI 검토자가 봅니다. 띄어쓰기·맞춤법·표기·문체가 여기에 해당합니다. 1편의 "프롬프트는 부탁, 훅은 강제"를 검토에 적용한 것입니다. 검토자에게는 읽기 도구만 줬습니다.
시험 | 결과 |
형식 오류 7종 + 내용 문제 1개를 심은 문서 | 스크립트 4종, 검토자 3종으로 7종 모두 검출. "충분히 빠르게"(내용 문제)는 지적하지 않고 "중간관리자 참고"로 넘김 |
작성자가 10건 모두 "반영함"이라고 거짓 보고한 2-1 | 9건 확인됨, 1건 미반영: "작성자는 고쳤다고 적었지만 문서에서 확인되지 않는다". 표지 버전만 올리고 개정 이력을 빠뜨린 수정 부작용도 잡음 |
"네가 직접 고쳐라" | "검토자는 문서를 고치지 않습니다. 3-1 재반영으로 넘겨 주세요" |
덤으로, 심지 않은 진짜 형식 문제도 하나 찾았습니다. 계획서 5장 "가능성" 칸에 "중"과 "낮음"이 섞여 있었습니다.
중간관리자 (manager) — 내용
요구사항 메모와 계획서만 읽습니다. 장부와 앞 단계의 판정은 받지 않습니다.
시험 | 결과 |
"대부분의 경우 권수가 맞게 나온다"와 범위 밖 기능 F-04(외부 검색)를 심은 문서 | 둘 다 부적합. 같이 심은 띄어쓰기 오류는 지적하지 않음 |
실제 계획서 v1.0 | 수정 메모 6건. 작성자가 남겨 둔 날짜 형식 빈틈을 "요구사항 메모 보완 필요"로 잡음. 다른 폴더에서 실행하면 기록이 사라져 보이는 저장 경로 문제도 찾음 |
작성자가 범위를 넓히지 않고 남겨 둔 빈틈을 중간관리자가 이어받아 잡았습니다. 역할 분리가 실제로 작동한 장면입니다. 동시에 설계의 빈틈도 드러났습니다. 결재 흐름에 "입력(요구사항 메모)을 고치는 경로"가 없었습니다. 그래서 "사람만 아는 정보는 그 번호만 보류로 두고 사람에게 묻는다" 규칙을 추가했습니다.
승인 요청과 Word 변환
AI는 Markdown으로 일하고, 승인자에게는 결재 양식 그대로의 Word로 올립니다. 글꼴과 크기는 변환기가 양식대로 강제합니다.
• 계획서에 없는 "수행 책임자", "필요 자원·비용"은 지어내지 않고 "승인자 확인 필요"로 표시했습니다.
• 시험 준비 실수를 공장이 잡았습니다. 제가 만든 시험 장부는 "v1.1을 검토했다"고 적혀 있는데 계획서는 v1.0이었습니다. 메인 세션은 "검토받지 않은 문서를 승인자에게 올리게 된다"며 멈췄습니다. 조건 확인 규칙이 사람의 실수까지 막았습니다.
• Word 변환기를 실행하려다 막혀서 권한 설정을 넣었습니다. 1편 구성요소 표의 "권한"이 실제로 필요해진 순간입니다.
결재 커맨드 /review-plan
D2~D5에서 손으로 한 순서를 묶었습니다. 핵심은 지금 단계를 기억이 아니라 파일로 정한다는 것입니다. 계획서 버전, 장부의 상태 값, 중간관리자 검토서의 대상 버전을 읽고 표에서 다음 단계를 고릅니다. 그래서 사람의 답을 기다리느라 몇 시간 멈췄다가 다시 실행해도 그 자리에서 이어집니다. 단계가 끝날 때마다 "결재 2-1 1회차: 확인됨 9, 미반영 1" 같은 메시지로 git에 커밋해서, git log가 그대로 결재 이력이 됩니다.
3) 시범 가동: 개발계획서 결재 1건
연습용 "독서 기록 프로그램" 개발계획서 한 건을 결재했습니다. 사람이 한 일은 /review-plan을 실행하고, 공장이 멈출 때 답한 것뿐입니다.
12:50 결재 2 형식 검토: v1.0 지적 3건
12:53 결재 4 내용 검토 1회: 수정 메모 6건, 보류 2 ← 사람에게 질문하며 멈춤
13:20 결재 보류 답변: 요구사항 메모 v1.1 ← 요청자 답 ①
13:23 결재 2-1 1회차: 확인됨 2, 부작용 1 ← 고치다 생긴 문제를 검토자가 잡음
13:26 결재 4 내용 검토 2회: 수정 메모 1건
13:29 결재 4 내용 검토 3회: 통과 → 5
13:30 결재 5 승인 요청: v1.5, Word 2건 제출 ← 승인자 차례
14:12 결재 5 승인자 답: 수정 메모 2건 ← 승인자 메모
14:13 결재 3-1 재반영: v1.6, 1건 반영, 1건 보류 ← "오류 문구는 사람이 정할 정보"
14:15 결재 보류 답변: 요구사항 메모 v1.2 ← 요청자 답 ②
14:17 결재 4 내용 검토 4회: v1.7 통과 → 5
14:32 결재 5 승인: 개발계획서 v1.7 승인, 결재 종료 ← 승인
(공장 git log에서 주요 커밋만 뽑음. 전체 결재 단계 커밋은 25개)
항목 | 결과 |
개발계획서 | v1.0 → v1.7 승인 |
지적 장부 13건 (모두 확인됨) | 형식(검토자) 3 · 수정 부작용 1 · 내용(중간관리자) 7 · 승인자 2 |
2-1 반영 확인 | 7회 (반영 흐름 6개) |
중간관리자 검토 | 4회 (수정 메모 2회, 상한 이내) |
사람에게 되물은 보류 | 3건: 빈 제목 오류 문구, 잘못된 날짜 처리, 날짜 오류 문구 |
사람이 한 일 | 요청자 답 2번, 승인자 수정 메모 1번, 승인 1번 |
가장 인상적이었던 장면은 승인자 수정 메모였습니다. 제가 승인자로서 "수행 책임자를 Todd로 적을 것. 잘못된 날짜 오류 문구를 정할 것."이라고 보냈습니다. 공장은 이 메모를 요구마다 원문 그대로 둘로 나눠 장부에 올렸습니다. 작성자는 책임자는 바로 반영했지만, 오류 문구는 "화면에 보일 문구는 사람이 정할 정보"라며 지어내지 않고 되물었습니다. 제가 문구를 정하자 그 문구가 계획서 다섯 곳에 똑같이 들어갔습니다. 그다음 검토자 확인과 중간관리자 검토를 다시 거쳐 v1.7로 승인 요청이 올라왔습니다. 처음 설명한 제 워크플로우가 그대로 돌았습니다.
결과와 배운 점
• 승인자인 제가 Word 파일을 직접 열어 "v1.6"으로 저장했습니다. 다행히 본문은 바뀌지 않았지만, 승인자가 직접 고치면 형식 검토와 내용 검토를 건너뛰게 됩니다. 고칠 것은 메모로 보내야 장부에 남습니다.
• 처음 여는 폴더에서는 권한 설정이 무시됐습니다. 공장 폴더를 대화형으로 한 번 열어 신뢰해야 형식 검사·변환·커밋이 막히지 않습니다.
• 형식 검사를 "훅으로 강제"하지는 못했습니다. 지금은 커맨드가 스크립트를 실행하는 방식이라, 커맨드를 거치지 않으면 건너뛸 수 있습니다. 3편에서 테스트 게이트와 함께 훅으로 옮길 계획입니다.
다음 주 계획 (3편 예고)
• 승인된 개발계획서 v1.7대로 코드를 만드는 2단계. 같은 결재 흐름을 코드에 적용합니다
• Before/After와 3주 회고
로그인하고 댓글을 남겨 주세요
개발 플로우를 하네스로 구현 중이시네요!
실제 코드 개발까지 연결되면 어떻게 작동할지 기대가 됩니다.
오늘 발표와 다음 주 사례 모두 기다리고 있겠습니다. 🙂




Todd님, 설계를 그대로 조립하지 않고 두 번 크게 고친 과정을 솔직하게 적어주셔서 읽는 재미가 있었어요. 특히 결재 대상을 코드에서 개발계획서로 바꾼 덕분에 GitHub·스택 결정 없이 "메모 → 반영 → 반영 확인" 반복만 먼저 검증할 수 있었다는 부분이 인상적이었어요.
작성자가 10건 모두 "반영함"이라고 보고했는데 검토자가 1건 미반영을 잡아낸 시험, 그리고 v1.1을 검토했다고 적힌 장부와 v1.0 계획서의 불일치를 공장이 스스로 멈춰 세운 장면은 "AI의 확인했다는 말을 파일로 다시 확인한다"는 원칙이 실제로 작동한 사례 같아요. 승인자가 Word 파일을 직접 열어 고치면 검토 단계를 건너뛰게 된다는 배운 점도 놓치기 쉬운데 짚어주셔서 고마워요.
3편에서 훅으로 옮기는 부분이 벌써 궁금해요. 고롱고롱… 꼬리 흔들며 기다리고 있을게요 🐈⬛