2만 1천 줄 기능 출시, 코드보다 질문이 먼저였다
Quick Summary
매트 포콕의 2만 줄 규모 기능 출시는 코드 생성에 앞서 질문으로 요구사항과 용어를 정하고, 구현 뒤 리뷰와 회고로 개발 환경을 고친 사례다.
영상 보기
클릭 전까지는 가벼운 미리보기만 먼저 불러옵니다.
🖼️ 인포그래픽

🖼️ 4컷 인포그래픽

💡 한 줄 결론
매트 포콕의 2만 줄 규모 기능 출시는 코드 생성에 앞서 질문으로 요구사항과 용어를 정하고, 구현 뒤 리뷰와 회고로 개발 환경을 고친 사례다.
📌 핵심 요점
- 영상에 따르면 포콕은 구현을 맡기기 전 약 40분 동안 질문 40개에 답했다. 출발점은 세부 작업 목록보다 사용자의 불편과 원하는 결과였다.
- 핵심 논의는 이름과 범위였다. 썸네일에 직접 그릴 그림을 ‘썸네일 다이어그램’으로 정하고, 기존 다이어그램과의 개념적 차이는 용어집과 결정 기록에 남겼다.
- 질문과 함께 시안 세 개를 비교하고 실제 화면 문제를 확인했다. 이후 요구사항을 사용자 이야기 47개와 티켓 9개로 정리해 에이전트에 구현을 맡겼다.
- 결과물은 21,349줄 추가, 커밋 37개, 파일 71개였다. 이를 작은 풀 리퀘스트 7개로 나누고, 데이터베이스 마이그레이션 등 검토가 필요한 부분을 구분했다.
- 리뷰에서는 과도한 주석과 반복되는 코드 패턴을 지적했다. 회고는 이런 문제가 기존 코드와 문서의 영향이라고 진단했고, 린트와 코딩 표준을 개선하는 후속 작업으로 연결됐다.
🧩 배경과 문제 정의
영상은 개발자 매트 포콕이 강의·영상 제작용 앱에 썸네일 편집 기능을 추가하는 과정을 소개한다. 기존에는 다른 화면에서 도식을 그리고 캡처해 붙여야 했으며, 위치가 맞지 않으면 작업을 반복해야 했다. 목표는 썸네일 속 얼굴 바로 옆에서 도식을 직접 그리는 것이었다.
포콕은 변경 규모에 따라 작업 방식을 달리한다고 설명한다. 작은 변경은 바로 맡기고, 큰 변경은 질문으로 요구사항을 맞추며, 한 세션을 넘는 작업은 별도 흐름으로 넘긴다. 이번 사례의 중심은 큰 기능을 에이전트에 맡기기 전에 무엇을 합의하고, 구현 뒤 무엇을 검토할지 정하는 과정이다.
🕒 시간순 섹션별 상세정리
1. 대규모 코드 생성과 실제 사용자 문제
- 도입부는 사람이 자리를 비운 사이 에이전트가 2만 줄 넘는 코드를 작성했다고 보여준다. 그에 앞서 포콕은 약 40분 동안 코드 작성 대신 질문 40개에 답했다고 보여준다. [00:23]
- 포콕의 앱은 얼굴 사진과 도식을 조합해 썸네일을 만든다. 다른 화면에서 도식을 캡처해 붙이는 번거로움을 줄이고, 얼굴 옆에서 직접 그리는 기능이 필요했다. [01:16]
2. 변경 규모에 맞춰 질문으로 범위 좁히기
- 포콕은 디프가 작으면 바로 맡기고, 크면 ‘그릴 위드 독스’로 질문을 받으며, 한 세션을 넘는 작업은 ‘웨이파인더’로 넘긴다고 보여준다. 이번 기능은 큰 변경으로 판단했다. [01:38]
- 첫 요청에는 불편과 원하는 모습이 담겼다. 질문을 통해 얼굴 이동과 그리기의 범위를 정하고, 범용 디자인 도구로 확장하지 않겠다는 선을 그었다. [02:51]
- 에이전트는 코드베이스를 살펴 질문을 수정했다. 포콕은 만들기 전에 무엇을 만들지 맞추면 결과를 예측하기 쉬워지며, 이름을 정하는 과정이 기능 정의와 연결된다고 보여준다. [03:16]
3. 이름을 결정하고 이유를 기록하기
- 기존 용어집은 다이어그램·스냅샷·보존 스냅샷을 구분했다. 새 기능을 ‘썸네일 드로잉’으로 부르자는 제안에 포콕은 기존 다이어그램과 혼동할 수 있다고 반대했다. [03:48]
- 후보 이름을 실제 사용 문장에 넣어 비교했다. ‘신’은 사용자가 평소 쓰는 말과 맞지 않고 기존 개념과도 겹쳐, 최종적으로 ‘썸네일 다이어그램’을 선택했다. [04:18]
- 이름에 다이어그램이 들어가지만 기존 다이어그램과는 다른 개념이라는 점을 ADR에 남겼다. 결정 기록은 다음 실행에서도 선택의 이유를 이해하도록 돕는 장치로 드러난다. [05:05]
4. 프로토타입 비교와 긴 대화의 한계
- 질문이 이어지는 동안 시안 세 개를 만들고 비교했다. 선택한 시안에는 요청하지 않았던 고스트 기능도 있었으며, 얼굴 이동과 재촬영을 그리기와 같은 되돌리기 기록에 넣는 아이디어도 논의됐다. [06:12]
- 내보낸 이미지 가장자리의 흰 줄을 브라우저에서 재현하고 픽셀을 확인했다. 영상은 윈도우 125% 화면 배율에서 미리보기를 축소하는 과정이 원인이라는 진단을 전해진다. [06:28]
- 해당 서브 에이전트는 이미 약 26만 토큰을 사용했다. 포콕은 새 에이전트를 쓰는 편이 나았겠다고 평가하고, 긴 대화에서 결과 품질 저하와 캐시 만료 뒤 재처리 비용을 우려했다. [07:06]
5. 스펙·티켓으로 구현을 맡기고 변경 나누기
- 질문 번호가 40에 이르자 스펙과 티켓을 작성했다. 깃허브 이슈에는 사용자 이야기 47개, 구현 결정, 범위 밖 항목이 담겼고 작업은 티켓 9개로 나뉘었다. [07:22]
- 대화 내용을 문서로 남긴 뒤 대화를 압축하고 구현을 맡겼다. 서로 막지 않는 티켓 세 개부터 병렬로 시작했다. [07:35]
- 돌아왔을 때 결과는 21,349줄 추가, 커밋 37개, 파일 71개였다. 검토를 위해 변경을 나누고, 큰 부분은 기능 플래그 뒤에 둬 최종 풀 리퀘스트 7개로 분리했다. [08:56]
6. 리뷰 지적을 규칙과 환경 개선으로 연결하기
- 용어집과 결정 기록만 바꾸는 첫 풀 리퀘스트에는 자동 병합을 켰다. 영상에서 사람의 검토가 꼭 필요하다고 지목된 항목은 썸네일 다이어그램을 추가하는 데이터베이스 마이그레이션이었다. [09:07]
- 포콕은 과도한 주석과 타입스크립트 코드 패턴 등을 지적했다. 반복해서 보고 싶지 않은 문제는 린트 규칙으로 만들고, 기존 위반 수가 늘지 않도록 점진적으로 줄이는 래칫 방식을 제안했다. [10:27]
- 회고는 세션 기록 약 30개와 리뷰 코멘트 12개를 분석했다. 지적 사항을 다루는 표준이 없고 기존 코드와 문서가 반대 패턴을 보여줬다는 진단으로 이어졌다. [10:57]
7. 주석 감사, 기능 병합, 사람의 역할
- 새 기능 폴더의 주석 비중은 18%로 저장소 평균 12%보다 높았다. 에이전트 감사는 주석 2,053줄 중 약 940줄을 삭제 가능하다고 보고, 7개는 코드와 맞지 않는다고 판단했다. [11:20]
- 재검토에서는 22개는 삭제, 18개는 주석이 설명하던 우회 코드 수정, 3개는 ADR 이동 대상으로 분류했다. 포콕은 회고에서 약 20개의 후속 이슈가 나올 것으로 예상했다. [12:24]
- 풀 리퀘스트 7개가 모두 병합되고 프로토타입에서 정한 모습의 기능이 시연됐다. 영상은 사람이 질문으로 목표를 정하고, 리뷰와 회고로 다음 에이전트의 작업 환경을 고치는 역할을 했다고 정리한다. [13:22]
🧾 결론
- 이 사례에서 사람의 주요 기여는 무엇을 만들지 결정하고, 에이전트가 참고할 공통 언어와 판단 근거를 마련한 데 있다.
- 용어집·결정 기록·스펙·티켓은 구현 중 선택의 여지를 줄이고, 대화를 압축한 뒤에도 맥락을 이어가는 장치로 쓰였다.
- 기능 병합과 함께 리뷰에서 드러난 문제를 규칙과 환경 개선으로 돌려보내는 과정까지 하나의 개발 흐름으로 제시한다.
📈 투자·시사 포인트
- 개발 생산성을 평가할 때 생성 코드량과 함께 요구사항 정리, 리뷰 부담, 수정 작업, 모델 사용 비용을 살펴볼 필요가 있다.
- 이 사례는 에이전트 활용 역량에 질문 설계, 작업 분할, 문서 관리, 품질 규칙 운영이 포함된다는 점을 보여준다.
- 기존 저장소의 코드와 문서는 에이전트의 작업 기준으로 작용했다. 도구 도입 효과를 판단할 때 개발 환경의 품질도 검토할 항목이다.
- 영상에는 매출·수익성이나 기업별 성과를 비교할 자료가 없어, 특정 기업이나 자산의 투자 판단으로 직접 연결하기는 어렵다.
⚠️ 불확실하거나 확인이 필요한 부분
- 코드 추가량과 병합 완료는 영상이 전하는 결과다. 독립적인 테스트 결과, 운영 장애, 장기 유지보수 비용은 제공되지 않아 품질이나 생산성 향상 폭을 확정하기 어렵다.
- 약 15만 토큰 이후 성능이 저하된다는 설명과 과거 모델의 사용 경험은 영상 속 주장이다. 모든 모델과 작업에 적용되는 보편적 기준으로 받아들이기 어렵고, 비용도 캐시 조건과 요금에 따라 달라질 수 있다.
- 저장소 스타 32만 개와 ‘세계에서 가장 많은 스타를 받은 스킬 저장소’라는 소개는 원자료 확인이 필요하다. 최다라는 표현은 영상에서도 본인의 주장으로 제시된다.
- 자막 기반 정리: 타임스탬프가 있는 자막을 기준으로 정리했으며, 고유명사·수치·인용은 원문 확인 필요 시 별도 검증한다.
- 영상 속 주장: 발표자의 해석·전망·비교는 확인된 외부 사실이 아니라 영상 속 주장으로 분리해 읽는다.
- 검증 필요: 수치, 기업 실적, 정책·시장 전망은 발행 전 최신 자료로 별도 검증이 필요하다.
✅ 액션 아이템
- 큰 기능을 맡기기 전 현재 불편, 원하는 사용 경험, 범위 밖 항목을 정리하고 질문으로 모호한 부분을 좁힌다.
- 핵심 개념의 후보 이름을 실제 사용 문장에 넣어 비교하고, 기존 용어와 충돌하는지 확인한다.
- 합의한 용어와 결정 이유를 용어집·결정 기록에 남기고, 스펙과 세션 단위 티켓으로 구체화한다.
- 큰 변경은 검토 가능한 풀 리퀘스트로 나누고, 데이터베이스 변경처럼 영향이 큰 항목의 검토 기준을 정한다.
❓ 열린 질문
- 혼자 사용하는 앱에서 효과적이었던 질문·문서·리뷰 방식은 여러 개발자가 참여하는 서비스에서도 같은 효율을 낼까?
- 사전 질문과 문서화에 쓴 시간을 포함하면 전체 개발 시간과 유지보수 비용은 얼마나 달라졌을까?
- 사람이 반드시 검토해야 할 변경을 어떤 기준으로 정하고, 에이전트의 검토 판단을 어떻게 검증할 수 있을까?