Agent에게 어디까지 맡길까를 묻다가
2026.10.21 게시
![]()
Agent와 개발 방법론 이야기를 오래 했다.
시작은 내가 쓰고 있는 방법론에 대한 의심이었다. 현행을 분석하고, 설계하고, 리뷰하고, 구현하고, 다시 검증한다. 작업이 커지면 단계를 더 나누고, 중간에 사람이 확인할 자리도 둔다.
그런데 이거, 사람이 개발하던 방식을 Agent에게 그대로 시키고 있는 건 아닐까.
사람은 한 번에 이해할 수 있는 양이 제한돼 있고, 서로 다른 사람이 일을 나눠 하니 문서와 인계가 필요하다. Agent는 다른 방식으로 탐색하고 작업할 수 있을 텐데, 내가 익숙한 절차 안에서만 움직이게 만들고 있는 건 아닐까.
내가 만든 방법론이라 더 신경 쓰였다. 실제로 필요해서 붙인 절차도 시간이 지나면 그냥 원래 하는 일이 된다. 모델이 달라져도 절차는 남는다.
12편, 「모델은 좋아졌는데 하네스는 그대로였다」에서도 모델의 약점을 보완하는 절차와 잘못됐을 때의 피해를 줄이는 통제를 구분해야겠다고 생각했다.
이번에는 그보다 조금 앞의 질문으로 돌아갔다.
내가 남기려는 절차는 누구에게 필요한 걸까. Agent에게 필요한가, 내가 이해하려고 필요한가. 아니면 둘이 같은 일을 하고 있다는 걸 확인하려고 필요한가.
이 글에 적은 내 경험은 각 프로젝트와 환경에서 겪은 것이다. 같은 작업을 조건을 나눠 비교한 실험은 아니다.
목차
명세는 어긋남을 꺼내두는 자리였다
SDD부터 다시 생각해봤다. 명세를 먼저 쓰고 개발한다는 형식만 보면 사람이 익숙한 개발 절차를 Agent에게 요구하는 것으로 보일 수 있다.
그런데 내가 실제로 명세를 쓰는 이유는 조금 달랐다.
내 머릿속에 있는 요구를 말로 꺼내는 순간부터 빠지는 것이 있다. “기존 동작은 유지하면서 이것만 바꿔줘”라고 말해도, 기존 동작의 어디까지를 유지한다는 건지는 다 적혀 있지 않다. 화면을 보여주면 배치와 모양은 전달할 수 있지만, 그 화면에 어떤 상황에서 들어오는지, 실패하면 어떻게 해야 하는지까지 전달되지는 않는다.
자연어든 그림이든 표현에는 한계가 있다. 내가 자세히 설명했다고 느끼는 것과 Agent가 필요한 조건을 모두 받은 것도 다르다.
그래서 Agent가 이해한 내용을 다시 꺼내 보게 한다. 현재는 이렇게 동작하고, 이번에는 이것을 바꾸며, 이 부분은 아직 정하지 못했다고 적게 한다. 그걸 보면서 내가 빠뜨린 조건을 발견하기도 하고, 처음 요청 자체를 고치기도 한다.
내가 쓰는 SDD의 역할은 여기에 더 가깝다. 서로 다르게 이해한 채 구현을 시작하지 않도록, 의도와 가정을 확인할 수 있는 형태로 꺼내놓는 것.
이 과정을 그림으로 그리면 이렇다. 명세를 가운데 두고, 서로의 이해가 어긋난 부분을 다시 확인한다.

그림 1. SDD를 통해 의도와 가정을 맞추는 흐름. 의도가 분명하고 영향이 작으면 짧게 확인하고 진행할 수 있다. 사람 판단이 필요한 질문에는 그 결정에 의존하는 작업만 멈추고, 새 사실이 나오면 명세와 합의한 범위를 갱신한다.
여기까지 생각하니 처음 질문을 조금 고쳐야 했다. 사람의 절차라는 이유만으로 걷어낼 수는 없었다. 그 절차가 해결하려던 문제가 Agent와 일할 때도 남아 있는지부터 봐야 했다.
구현 앞뒤에는 판단이 남았다
사람끼리 개발할 때를 돌아보면 더 분명해진다.
내가 현업에서 겪는 개발은 요구사항을 받아 코드로 옮기는 한 번의 변환이 아니다. 요구가 생긴 사람이 있고, 기획자가 인터뷰하고 설계한다. 개발자는 기존 시스템을 분석하면서 기획과 다시 조율한다. 구현한 뒤에는 QA를 거치고 배포한다.
흐름만 적으면 단순하다.
요구 발생 → 인터뷰·기획·설계 → 현행 분석과 기획 조율 → 구현 → QA → 배포
하지만 실제로는 앞뒤로 계속 돌아간다. 기획서에 없던 조건이 기존 코드에서 나오고, 구현 가능한 선택지를 보니 원래 요구를 바꾸기도 한다. QA에서 발견한 문제가 구현 오류인지, 요구의 빈칸인지 다시 판단해야 한다.
각 단계에서 사람이 하는 일에는 정보 전달뿐 아니라 해석과 선택이 들어 있다.
여기에 Agent를 넣어도 이 연결이 저절로 완성되지는 않는다. 코드를 분석하고 대안을 만드는 일은 많이 맡길 수 있다. 그래도 코드에서 발견한 사실을 업무상 어떤 의미로 받아들일지, 누구에게 확인해야 하는지, 이번 작업에서 어디까지 바꿀지는 별도의 문제로 남는다.
지금의 나는 그 사이를 잇는 역할을 꽤 많이 한다. Agent가 찾은 내용을 보고 기획과 다시 이야기하고, 업무 맥락을 전달하고, 결정된 내용을 구현과 검증으로 연결한다.
Agent가 다룰 수 있는 맥락과 권한이 넓어지면 달라지겠지만, 현재 내 작업에서는 구현을 자동화해도 이 연결을 맡는 일이 남아 있다.
알아서 해줬으면 좋겠는데, 혼자 정하진 말았으면
여기서 좀 모순적인 마음이 든다.
나는 Agent가 알아서 해줬으면 좋겠다. 이미 말한 내용을 다시 묻거나, 조금만 조사하면 알 수 있는 것까지 질문하면 답답하다. 일을 맡겼는데 내가 계속 다음 행동을 지정하고 있으면 맡긴 의미가 줄어든다.
그런데 중요한 가정을 혼자 정하고 끝까지 구현해오면 그것도 곤란하다.
질문이 적은 Agent가 항상 일을 잘하는 건 아니었다. 무엇이 불확실한지 알아차리지 못해서 질문이 없을 수도 있고, 내가 원하는 답을 맞춰주느라 반론을 생략할 수도 있다.
내가 “이 방법이 맞는 것 같은데?”라고 말할 때마다 Agent가 더 좋은 문장으로 동의해주기만 하면, 대화는 길어져도 생각이 바뀔 기회는 적어진다. 「이해하지 못하는 결정을 승인한다는 것」에서도 썼지만, 사람은 원래 자신의 경험과 판단에 편향돼 있다. Agent가 거기에 논리를 덧붙여주면 확신만 커질 수 있다.
그래서 내가 원하는 자율성을 좀 더 정확히 표현할 필요가 있었다.
조사해서 해결할 수 있는 것은 조사하고 진행했으면 한다. 하지만 선택에 따라 업무상 의미가 달라지거나, 내가 제공하지 않은 기준이 필요한 곳에서는 질문했으면 한다. 내 요청과 목표가 충돌하면 그것도 짚어줬으면 한다.
그때도 단순히 “어떻게 할까요?”보다는 무엇을 확인했고 무엇이 남았는지, 선택에 따라 무엇이 달라지는지를 같이 가져오는 편이 좋다. 그래야 나도 판단할 수 있다.
질문을 줄이는 것과 판단할 내용을 숨기는 것은 따로 봐야 했다.
이슈를 닫기 전에 폰에 깔아본다
이 생각은 Android 앱을 개발하면서 더 구체적이 됐다.
구현과 검사를 끝내고 이슈를 닫은 뒤, 배포해서 사용하다가 문제를 발견하면 별도 이슈를 여는 흐름이 있었다. 그런데 내가 써보니 더 잘 맞는 흐름은 이쪽이었다. 구현이 끝난 뒤 실제로 써보는 과정을 같은 이슈 안에 넣었다.

그림 2. 개인 Android 앱에서 더 실용적이라고 느꼈던 작업 흐름. 사람은 실제 동작을 관찰하고, Agent는 그 관찰을 바탕으로 원인을 찾고 수정한다. 이슈 종료는 확인한 범위에서의 완료이며, 이후 문제가 없다는 보장은 아니다.
직접 설치해서 써보고, 이상한 동작이나 기대와 다른 부분을 전달한다. Agent가 원인을 찾고 수정하면 다시 설치해서 확인한다. 이 과정을 작업이 끝나기 전에 이어가는 편이 내게는 더 효과적이었다.
물론 Agent에게 QA까지 맡기는 것도 기술적으로 가능했다. 그래서 사람이 해야만 한다고 정리할 수는 없다.
내가 해본 범위에서는 비용과 결과가 걸렸다. 자율 QA에 토큰이 많이 들었고, 어디를 더 탐색할지, 어떤 동작을 문제로 볼지 판단하는 품질도 기대에 못 미쳤다. 내가 기기에서 확인한 내용을 넘기고 Agent가 디버깅과 수정에 집중하는 조합이 더 실용적이었다.
그래도 처음의 질문을 다시 보는 데는 충분했다. 사람의 참여를 줄이는 게 목적이라면 QA도 최대한 넘기는 쪽을 고르게 된다. 내가 원하는 결과까지 드는 전체 수고를 보면 다른 선택을 할 수 있었다.
그리고 이때 나는 승인 버튼을 누르기 위해 참여한 게 아니었다. 실제 동작이라는 새 정보를 가져와 다음 수정을 가능하게 했다.
더 읽히려 하기보다, 다르게 보여주기
그렇다고 사람에게 더 많은 문서를 읽히는 쪽으로 돌아가고 싶지는 않다.
이미 그 방법의 한계를 겪었다. 사고가 나면 규칙을 붙이고, 규칙에 예외를 붙이고, 안 지켜지면 더 강하게 적었다. 그러다 보니 읽어야 할 산문이 너무 많아졌다.
17편에서 규칙을 세어본 이유다. 당시 분류한 370줄 가운데 온전히 기계적으로 판정할 수 있다고 본 것은 16줄이었다. 이 비율을 모든 방법론에 적용할 수는 없다. 내 문서의 상태를 본 결과다.
더 걸렸던 건 실제 사고였다. 검사를 실행하지 않아서 생긴 문제뿐 아니라, 검사를 돌리고 통과했는데도 요구를 증명하지 못한 문제가 많았다.
그래서 기계적으로 확인할 수 있는 건 테스트나 기존 도구로 옮기되, 검사 실행과 통과, 요구 충족을 구분하려고 했다. 문서 형식이 맞거나 기록에 완료라고 적혀 있다는 사실만으로 실제 작업까지 확인됐다고 보지 않으려 했다.
사람이 읽는 쪽도 바꿔왔다.
11편에서는 검증 문서를 실행 절차, 결과 반환, 사용자 결정, Agent 판정으로 나눴다. 이후에는 사람이 판단할 결론과 변경 내용을 앞에 놓고, 흐름은 그림으로, 전후 차이와 선택지는 비교표로 보여주도록 바꿨다. Agent가 작업을 이어갈 상세와 사람이 지금 판단할 내용을 구분해 온 것이다.
나누려는 것은 읽는 방식이다. 사람이 보는 설명과 Agent가 사용하는 상세가 서로 다른 사실을 가리키면 안 된다.

그림 3. Agent에게 필요한 상세와 사람에게 필요한 설명을 구분한다. 사람용 설명에는 흐름도와 비교표를 쓰되, 판단에 필요한 불확실성과 원문으로 돌아갈 연결을 남긴다.
여기에도 한계는 있다.
보여주는 방식을 개선할 수는 있어도 내가 실제로 읽고 이해하는 것까지 강제할 수는 없다. 그림을 만들어줘도 넘길 수 있고, 비교표를 봐도 익숙한 선택지만 고를 수 있다.
승인 기록을 엄격하게 남겨도 내가 이해했다는 증거가 되지는 않았다. 사람이 볼 내용을 늘리기보다, 감당할 수 있는 양 안에서 판단해야 할 차이와 아직 모르는 부분이 드러나야 했다.
설계 승인을 뺐다
그래서 설계 승인을 줄였다.
이 부분은 정확하게 적어야 한다. 20편, 「승인을 늘릴수록 승인은 가벼워졌다」에서 바꾼 것은 서명 수단만이 아니었다.
먼저 개인 앱의 프로젝트 규칙에서 설계 단계 승인과 서명 검사를 뺐다. 이후 공통 방법론에서도 설계 단계 승인을 일괄 요구하지 않도록 바꿨다. 설계 승인을 둘지, 어디에 어떤 방식으로 둘지는 프로젝트가 정하게 했다.
혼자 승인하던 내가 병목이었기 때문이다. 서명을 대화 속 의사 표시로 바꾸더라도 단계마다 나를 기다리는 구조는 남는다. 그래서 기록 수단만 가볍게 하는 대안 대신 공통 강제를 제거하는 쪽을 골랐다.
앱에서는 설계와 코드 리뷰를 유지하면서, 사람이 결정해야 하는 미해결 질문과 큰 작업의 PR 병합에 내 판단을 남겼다.
공개 방법론에도 최소 조건은 남겼다. 사람 판단이 필요한 질문에는 의존하는 작업을 멈추고 물을 것. 사람이 판단하는 지점은 프로젝트가 명시할 것. 사람이 하지 않은 결정을 Agent가 만들어내지 않을 것.
여기까지 말하면 이제 설계는 맡기고 PR에서 보면 된다는 쪽으로 들릴 수 있다.
그런데 최근 현업에서는 내가 AS-IS 분석부터 계속 관여하고 있었다.
그런데 현업에선 분석부터 붙어 있었다
동일한 비즈니스 로직을 처리하던 패키지들을 하나로 통합하는 작업이었다.
구체적인 업무 구조와 구현 내용은 적을 수 없지만, 이 경험에서 중요한 건 분석 단계에서도 인간의 의사결정이 여러 번 필요했다는 점이다. 기존 동작을 찾아서 문서에 옮기는 것만으로 다음 설계가 자동으로 정해지지 않았다.
내 판단으로는 이 구간을 Agent에게 전부 맡기고 넘어갔다면 문제가 생겼을 상황이었다. 나중에 PR에서 발견했다고 해도 이미 구현한 내용을 바꾸고 설계부터 다시 확인해야 했을 가능성이 있다. 더 걱정되는 건, PR 검토에서 그 빈칸을 발견한다는 보장도 없다는 점이다.
그럼 며칠 전 설계 승인을 공통에서 뺀 결정과 모순일까.
나는 그렇게 보지는 않는다. 다만 왜 두 선택이 가능한지는 설명해야 한다.
| 경험 | 문제가 됐던 것 | 사람의 판단을 둔 곳 |
|---|---|---|
| 개인 앱의 단계별 승인 | 혼자 확인할 양이 늘면서 승인이 형식적으로 바뀜 | 미해결 질문, 큰 작업의 PR 병합 |
| Android 앱의 동작 확인 | 구현·검사 완료만으로 실제 사용 결과를 충분히 확인하기 어려움 | 이슈 종료 전 실기기 QA와 수정 반복 |
| 현업의 비즈니스 로직 처리 패키지 통합 | 현행 분석 중에도 이후 설계를 좌우하는 결정이 필요함 | AS-IS 분석과 설계 과정 |
설계 승인을 모든 프로젝트에 공통으로 강제하지 않겠다는 것과, 이 작업에서는 설계 전부터 사람이 참여해야 한다는 판단은 함께 성립한다.
다만 프로젝트가 알아서 정한다고 적는 것만으로 충분하지도 않다. 어떤 결정을 앞에서 해야 하고 무엇은 뒤에서 확인해도 되는지 실제 작업에서 봐야 한다. Agent가 미해결 질문을 전부 찾아준다는 보장도 없으니, 업무 맥락이 많이 필요한 변경에서는 사람이 초기에 함께 보는 이유가 생긴다.
남의 방식을 단순하게 읽었다
처음에는 Claude Code 팀과 내 방식을 비교하면서, 나는 앞에서 판단하고 그 팀은 PR에서 판단하는 것처럼 생각했다.
이 해석은 고쳐야 한다.
「Anthropic은 코드 리뷰를 어떻게 할까?」에서 읽었던 공식 글의 제목은 「How the Claude Code team does code review」다. Anthropic 전체가 아니라 Claude Code 팀의 운영을 설명한다. 이 글은 개발 방향과 범위, 다른 코드의 기준이 될 아키텍처 검토를 사람의 역할로 명시한다. 방향을 바꾸는 의견도 완성된 PR에서 병합을 막기보다 논의 초기에 제시하라고 설명한다. PR 승인 수를 줄이는 것과 모든 판단을 PR까지 미루는 것은 같은 운영이 아니었다. (공식 원문)
그러니 내 경험을 설명하려고 상대의 방법을 너무 단순하게 잡으면 안 됐다.
비교할 질문은 조금 달라졌다. 각자 어떤 결정을 앞에서 하고, 어떤 오류를 자동 검사로 찾으며, 놓친 문제는 얼마나 빨리 발견하고 되돌릴 수 있는가.
몇 번 들어갔나보다, 뭐가 달라졌나
대화를 시작할 때는 내가 Agent를 사람의 개발 방법론 안에 가두고 있는지 물었다.
지금도 그 의심은 필요하다고 생각한다. 모델이 이미 잘하는 일을 예전 습관 때문에 반복시키고 있을 수 있다. 사고가 날 때마다 붙인 절차가 목적보다 커질 수도 있다. 그런 것은 계속 줄이고 바꿔야 한다.
다만 절차를 줄인 다음 무엇을 확인해야 하는지는 더 구체적으로 보게 됐다.
| 확인할 것 | 보는 이유 |
|---|---|
| 사람을 기다린 시간 | 병목이 실제로 줄었는가 |
| 구현 뒤 설계로 되돌아간 횟수 | 앞단 참여를 뺀 대가는 없었는가 |
| Agent가 임의로 정한 업무 가정 | 질문을 줄인 대가는 없었는가 |
| QA·복구까지 포함한 총수고 | 비용이 뒤로 옮겨가기만 했는가 |
| 참여한 자리에서 더해진 것 | 승인 표시만 남았다면 줄일 후보인가 |
모델이 좋아지면 보조 절차를 줄이고 QA와 현행 분석도 더 맡길 수 있을 것이다.
그때도 무엇을 맡겼는지, 무엇으로 확인했는지, 아직 확인하지 못한 것은 무엇인지 알아야 다음 결정을 바꿀 수 있다. 위험을 감수하는 경계까지 Agent가 편의상 바꿔버리게 둘 수는 없다.
사람의 판단도 같은 기준으로 봐야 한다. 내가 참여했다는 이유만으로 좋은 결정이 되는 건 아니다. 앞에서 끼어들어 재작업을 막았을 수도 있지만, 이미 충분한 근거가 있는 일을 내 취향 때문에 지연시켰을 수도 있다.
그래서 이제는 사람의 참여 횟수보다 그 자리에서 무엇이 달라졌는지 보고 싶다. 빠진 업무 맥락이 들어왔는지, 불확실한 선택이 정해졌는지, 실제 동작에서 새로운 문제가 드러났는지. 아무것도 더하지 못하고 승인 표시만 남겼다면 그 자리는 다시 줄여볼 수 있다.
Agent에게 알아서 해달라는 마음은 여전하다.
다만 내가 빠진 시간을 절약이라고 부르기 전에, 그 비용이 뒤의 재작업이나 복구로 옮겨간 것은 아닌지 확인해야겠다. 반대로 내가 계속 보고 있다는 이유로 필요한 참여라고 생각하지도 말아야겠다.
지금 내가 고치고 있는 방법론은 그 둘을 구분하기 위한 시도에 가깝다.