How to Generate Mergeable Code with a Context Engine — Peter Werry, Unblocked

한 줄 핵심

에이전트가 코드와 조직 맥락을 스스로 이해하지 못하므로, 작업마다 필요한 컨텍스트를 정확히 주입해 더 빠르고 신뢰할 수 있는 병합 가능한 코드를 만들게 해야 한다.

시간별 요약

1. 0:00
   에이전트 이전에는 당신이 컨텍스트 층이었다 조직의 지식과 맥락은 원래 사람이 여러 데이터 स्रोत와 코드베이스를 뒤져가며 직접 모아야 했고, 그 과정에서 팀의 암묵지와 운영 경험이 축적됐다. 이제는 그 역할을 사람 대신 시스템이 전달해야 하며, 그것이 컨텍스트 엔진의 핵심 가치다.
2. 1:46
   에이전트는 매 작업마다 초기화되는 새 직원이다 에이전트는 새로 온 숙련 개발자처럼 보이지만, 매 작업마다 기억이 초기화되어 코드 구조, 테스트 방식, 배포 절차를 다시 배워야 한다. 따라서 단순한 자동완성보다 더 강한 맥락 공급 장치가 없으면 실제 업무 수행이 계속 끊긴다.
3. 2:25
   성숙도 곡선: 자동완성에서 소프트웨어 공장까지 AI 활용은 autocomplete, Cursor, 조직 위키, MCP와 skills를 거쳐 소프트웨어 공장 단계로 이동하고 있으며, 갈수록 핵심 병목은 컨텍스트가 된다. 접근권을 주는 것만으로는 충분하지 않고, 에이전트가 조직 지식을 이해하고 탐색할 수 있게 만드는 구조가 필요하다.
4. 4:19
   방사선학에서 빌려온 만족스러운 탐색 에이전트는 위키나 문서를 검색해도 첫 번째로 찾은 단서에서 멈추기 쉬워, 중요한 추가 단서를 놓치는 satisfaction of search 문제를 겪는다. 또한 전체 코드베이스를 통째로 넣는 방식은 비용과 주의 분산만 키우므로, 작업에 맞는 핵심 맥락만 추려주는 설계가 필요하다.
5. 6:37
   빙산: 의도, 관례, 과거 결정 에이전트가 직접 볼 수 있는 것은 코드의 표면뿐이며, 실제 업무에 필요한 의도, 팀 관례, Slack에 남은 논의, 아키텍처 의사결정은 물밑에 숨겨져 있다. 그래서 진짜 작업을 끝내려면 코드 밖의 맥락까지 끌어오는 컨텍스트 엔진이 필요하다.
6. 7:29
   컴포넌트를 묻고 작업 과정을 보여주는 데모 코드베이스의 특정 컴포넌트에 대해 질문하면 시스템이 아키텍처를 설명하고, 보이지 않는 다이어그램까지 생성해 이해를 보강한다. 답만 주는 대신 근거와 출처를 함께 보여줘야 신뢰를 쌓을 수 있고, 인간이든 에이전트든 그 위에서 수정과 보완이 가능해진다.
7. 10:03
   컨텍스트 엔진이 있을 때와 없을 때의 같은 계획 컨텍스트 엔진 없이 생성한 최적화 계획은 코드 탐색만으로 그럴듯한 결론에 도달하지만, Slack·PR·Notion·아키텍처 문서를 함께 쓰면 더 세밀한 개선 방향을 잡아낸다. 더 적은 토큰과 더 짧은 시간으로 더 정확한 계획을 만들 수 있고, 잘못된 가정으로 루프를 반복하는 비용도 줄어든다.
8. 12:44
   시니어 엔지니어의 발언을 강화하는 리뷰 에이전트 리뷰 에이전트는 PR 데이터와 조직 지식을 바탕으로 베스트 프랙티스를 제안하고, 특히 시니어 엔지니어의 과거 코멘트를 중요한 신호로 활용한다. 이미 현명했던 판단을 다시 드러내고 증폭하면 코드 리뷰 품질과 합의 형성이 더 빨라진다.
9. 13:50
   Slack으로 되돌아가 깃발된 이슈 감소를 디버깅하기 코드 리뷰 이슈 수가 급감한 원인을 찾을 때도, PR 생성과 Slack 대화를 연결하면 문제의 배경과 수정 사유를 함께 추적할 수 있다. 조직 맥락이 연결돼 있으면 원인 분석에서 수정 PR 작성까지 한 흐름으로 이어져 디버깅 효율이 높아진다.
10. 15:08
    오픈소스: 쿼리 엔진과 소셜 그래프 문서 쿼리 엔진은 GitHub 저장소와 과거 PR을 학습해 질의 가능한 스키마를 만들고, 엔지니어링 소셜 그래프는 코드 리뷰 관계를 바탕으로 전문성과 커버리지를 시각화한다. 두 도구 모두 조직 맥락을 구조화해 에이전트와 사람이 더 좋은 질문과 판단을 하게 돕는다.

실무 인사이트

• 에이전트 성능을 올리고 싶다면 모델 자체보다 작업별로 어떤 조직 맥락을 주입할지 먼저 설계해야 한다.
• 답변만 제공하지 말고 근거, 출처, 관련 대화까지 함께 보여주면 신뢰와 수정 가능성이 함께 올라간다.
• PR, Slack, 문서, 리뷰 관계를 연결해 두면 최적화·디버깅·리뷰가 각각의 개별 작업이 아니라 연속된 워크플로로 바뀐다.