이제 코드만 짜는 시대는 끝났다 — 에이전트를 위한 '하네스'를 설계하는 엔지니어링

무슨 일이 있었나요

OpenAI가 자사의 코딩 에이전트인 Codex를 실제로 어떻게 쓰고 있는지를 정리한 글을 내놨어요. 핵심 주제는 "하네스 엔지니어링(Harness engineering)"이라는 다소 낯선 개념인데요. 이게 뭐냐면, AI 에이전트가 일을 잘하도록 주변 환경과 도구, 작업 흐름을 통째로 설계하는 일을 말해요.

자동차로 비유하면 이해가 쉬워요. 예전엔 우리가 직접 운전대를 잡고 페달을 밟았다면(=직접 코딩), 이제는 자율주행차에게 "여기로 가줘"라고 말하는 시대로 넘어가고 있거든요. 그런데 자율주행차가 제대로 굴러가려면 잘 닦인 도로, 명확한 신호등, 정확한 지도가 필요하잖아요? 바로 그 도로와 신호등을 까는 일이 하네스 엔지니어링이에요. 코드를 직접 쓰는 게 아니라, 에이전트가 코드를 잘 쓸 수 있는 무대를 만드는 것이죠.

핵심 내용 — 사람의 역할이 바뀐다

OpenAI가 말하는 변화의 핵심은 개발자의 시간 배분이 달라진다는 거예요. 예전엔 키보드를 두드리며 함수를 한 줄 한 줄 짜는 데 대부분의 시간을 썼다면, 이제는 다음 같은 일에 시간을 쓰게 됩니다.

• 명확한 맥락(context) 제공: 에이전트는 사람의 마음을 못 읽어요. 그래서 코드베이스 구조, 코딩 규칙, 테스트 방법 같은 걸 문서로 잘 정리해두면 에이전트의 결과물이 확 좋아져요. AGENTS.md 같은 안내 파일을 두는 이유가 이거예요.
• 검증 가능한 환경 만들기: 에이전트가 코드를 고쳤으면 그게 맞는지 스스로 확인할 수 있어야 해요. 그래서 테스트를 자동으로 돌리고, 린트(코드 스타일 검사)를 걸고, 빌드가 되는지 확인하는 파이프라인을 촘촘하게 깔아두는 게 중요해졌어요. 사람이 일일이 확인하는 대신 에이전트가 "내가 짠 게 통과했다"를 스스로 증명하게 만드는 거죠.
• 작업을 잘게 쪼개기: 큰 작업을 한 번에 던지면 에이전트도 헤매요. 사람이 주니어한테 일 시킬 때처럼, 적당한 크기로 잘라서 맡기고 결과를 리뷰하는 흐름이 효율적이라는 거예요.

업계 맥락

이런 흐름은 OpenAI만의 이야기가 아니에요. Anthropic은 Claude Code를 통해 비슷하게 CLAUDE.md 같은 맥락 파일과 도구 연동을 강조하고 있고, GitHub Copilot Workspace, Cursor, Devin 같은 도구들도 전부 "에이전트가 코드베이스 전체를 이해하고 작업하게 한다"는 방향으로 가고 있어요. 즉 업계 전체가 '자동완성'에서 '자율 작업'으로 무게중심을 옮기는 중인데, OpenAI의 이번 글은 그 흐름 속에서 "그럼 사람은 뭘 해야 하나"에 대한 구체적인 답을 제시했다는 점에서 의미가 있어요.

한국 개발자에게 주는 시사점

당장 거창하게 에이전트 인프라를 깔 필요는 없어요. 하지만 작은 것부터 시작할 수 있어요. 내 프로젝트에 README나 컨벤션 문서를 잘 정리해두는 것, 테스트를 자동화해두는 것, CI를 촘촘히 거는 것 — 이런 건 사실 에이전트가 없어도 좋은 습관이었는데, 이제는 그게 곧 AI를 잘 쓰는 기반이 되는 거예요. 평소 미뤄뒀던 '문서화'와 '자동 검증'이 이제 생산성과 직결되는 투자가 됐다고 보면 됩니다.

마무리

핵심은 한 줄로 "이제 잘하는 개발자는 코드를 잘 짜는 사람이 아니라, 에이전트가 일할 무대를 잘 까는 사람"이라는 거예요. 여러분의 프로젝트는 AI 에이전트에게 일을 맡길 준비가 얼마나 되어 있나요? 가장 먼저 정리하고 싶은 건 무엇인가요?