[태그:] AI 코딩 에이전트

  • AI가 만든 대규모 PR 리뷰, 파일명 대신 의존성부터 읽어야 한다

    AI가 만든 대규모 PR 리뷰, 파일명 대신 의존성부터 읽어야 한다

    여러 파일을 한 번에 생성하는 AI 코딩 에이전트가 등장하면서, 리뷰어의 작업 방식도 바뀌어야 합니다. 화면에 dozens of files가 올라온 대규모 PR 리뷰를 앞에서부터 읽다 보면, 구현은 보이지만 그 구현을 지탱하는 계약과 스키마는 뒤늦게 보입니다. 결국 시간을 많이 쓴 뒤야 변경의 중심이 무엇인지 파악하게 됩니다.

    특히 git diff가 파일 경로와 이름 순서로 파일을 보여줄 때, 그 순서는 시스템의 책임 분배나 실행 흐름을 설명하지 않습니다. 에이전트가 만든 20-file 변경에서는 유틸리티 헬퍼나 UI 컴포넌트를 먼저 읽고, 실제 동작을 결정하는 데이터베이스 스키마나 핵심 인터페이스를 나중에 만나게 될 수 있습니다. 리뷰어가 해야 할 일은 더 많은 줄을 읽는 것이 아니라, 그 줄들이 어떤 계약과 호출 경로에 연결되는지 먼저 파악하는 것입니다.

    왜 알파벳순 diff는 구조를 보여주지 않는가

    파일 목록은 저장소 디렉터리의 결과이지 아키텍처의 결과가 아닙니다. UI가 서비스 함수를 호출하고, 서비스가 인터페이스를 의존하며, 인터페이스가 데이터 모델을 요구한다면, 파일 이름 정렬만으로는 그 방향을 알 수 없습니다. 호출 그래프를 머릿속에서 다시 그리기 시작하는 순간, 이미 코드 검토보다 구조 복원이 더 큰 비중을 차지합니다.

    이 문제는 자동화 도구를 하나 더 붙여 해결할 수 없습니다. AI 에이전트가 만든 변경 설명을 그대로 검토 전제로 삼거나, 통과한 테스트를 근거로 최종 diff만 승인하면 의존성 누락을 그대로 통과시킬 수 있습니다. 대규모 변경의 검토 대상은 구현량이 아니라 계약이 어떻게 바뀌고, 그 계약의 수신자와 호출자가 어디까지 영향을 받는지입니다.

    이 문제를 다루기 위해 에이전트가 만든 대규모 변경을 리뷰하는 방식에 대한 토론이 시작됐습니다. 핵심 질문은 단순합니다. 팀은 20-file diff를 어떤 순서로 읽어야 하는가입니다.

    파일 목록을 계약과 호출 흐름으로 다시 배치하기

    첫 단계는 변경 파일을 임의로 줄 세우는 대신 책임별로 분류하는 것입니다. 계약·인터페이스·스키마를 먼저 놓고, 도메인 서비스와 오케스트레이션을 그다음에 검토합니다. 이후 변경된 인터페이스를 호출하는 호출자, 테스트, 마지막으로 표현 계층을 확인합니다. 이 순서는 파일 수가 많을 때 모든 줄을 같은 깊이로 읽지 않고 위험도가 높은 의존 경로에 집중하게 합니다.

    확인 도구는 Git의 diff 명령을 단계적으로 사용하는 것으로 충분합니다. 규모와 파일 목록을 분리해서 보는 것이 핵심입니다.

    git diff --stat
    git diff --name-only
    git diff --find-renames
    git diff --word-diff

    --stat은 변경 규모를, --name-only는 검토 대상 목록을, --find-renames는 파일 이동과 변경을 구분하는 데 씁니다. 계약이나 설정처럼 한 줄의 의미가 중요한 변경에는 --word-diff가 구현 디테일을 덜 놓칩니다. 이 명령들의 결과는 다시 계약·스키마·호출자·테스트·표현 계층의 목록으로 재배치해야 합니다.

    스키마와 인터페이스의 영향 범위 찾기

    핵심 계약을 읽을 때 구현 세부만 판단해서는 안 됩니다. 해당 인터페이스를 직접 호출하는 코드, 메시지나 API 응답을 만드는 코드, 저장된 데이터를 읽는 마이그레이션 경로를 함께 찾습니다. 인터페이스 변경이 있으면 하위 호환성이 깨질 수 있는지, 응답 구조가 바뀌면 수신자가 영향을 받는지, 스키마 변경이 있으면 마이그레이션과 롤백 순서가 유효한지가 각각의 검증 항목이 됩니다.

    검토 문서에는 변경의 진입점, 변경된 계약, 예상되지 않은 호출 경로, 되돌릴 때의 상태를 먼저 적습니다. 호출자와 수신자, 스키마 변경은 하나의 논리적 단위로 묶되, 가능하면 계약 변경·호출자 반영·데이터 마이그레이션·동작 변경을 작은 단위로 분리합니다. feature flag를 쓸 수 있는 환경이라면 실제 도달 범위를 제한하고, 단계적으로 배포해 회귀가 발생했을 때 원인을 좁힐 수 있습니다.

    테스트는 통과 여부가 아니라 검증 게이트다

    대규모 PR 리뷰에서 테스트는 마지막에 한 번 실행하는 의례가 아닙니다. 변경 범위가 계약에 닿으면 계약 테스트를, 여러 계층이 연결되면 통합 테스트를, 스키마가 바뀌면 마이그레이션 검증과 롤백 검증을 함께 배치합니다. 실패 경로를 포함하지 않은 테스트는 성공 경로의 표현만 확인할 뿐, 실제 리스크가 있는 분기를 검증하지 못합니다.

    병합 전 리뷰 요청서에는 변경 요약, 영향 범위, 실행한 검증, 남은 위험, 롤백 방법을 함께 남깁니다. 테스트가 통과해도 계약의 의도가 맞는지, 호출자가 모두 반영됐는지, 되돌리면 데이터 상태가 안전한지는 별도로 판단해야 합니다. 이렇게 해야 AI 산출물의 설계를 그대로 믿는 대신, 독립적인 검증 대상으로 취급할 수 있습니다.

    실무에서 흔히 생기는 한계와 함정

    의존성 중심 리뷰를 도입하면 비용이 추가됩니다. 호출 그래프를 정리하는 시간과 파일 간 관계를 설명하는 시간이 들고, 아키텍처 경계가 불분명한 저장소에서는 분류 자체가 어려워집니다. 자동 분류 결과와 실제 호출 흐름이 다를 수 있으므로, 도구가 만든 목록을 검토 전제로 삼지 말고 사람이 연결 관계를 확인해야 합니다.

    가장 흔한 안티패턴은 이름순으로 읽자마자 구현을 판단하는 것, 에이전트의 변경 목적을 그대로 받아들이는 것, 테스트 통과만으로 최종 diff를 병합하는 것입니다. 대량 변경을 작은 논리적 단위로 나누면 병합 가능한 범위는 줄지만, 계약과 호출자가 서로 다른 묶음에 흩어질 수 있습니다. 분리 기준은 파일 수가 아니라 호환성 책임과 롤백 가능성입니다.

    지금 바로 해볼 것

    • 현재 브랜치에서 git diff --stat와 git diff --name-only를 실행하고 변경 규모와 파일 목록을 각각 기록합니다.
    • 파일 목록을 계약·스키마·서비스·호출자·테스트·표현 계층으로 분류합니다.
    • 변경된 인터페이스와 스키마를 검색해 호출자, 수신자, 마이그레이션 경로를 함께 표시합니다.
    • git diff --find-renames로 실제 이동과 변경을 구분하고 git diff --word-diff로 계약 변화를 다시 읽습니다.
    • 병합 전에 계약·통합·스키마·실패 경로 테스트와 롤백 방법을 리뷰 요청서에 남깁니다.

    참고 원문

    이 기사는 다음 원문을 확인해 작성했습니다: r/devops — Why are we still reviewing massive PRs in alphabetical file order?

  • 20년 차 시니어 개발자가 코드 한 줄도 안 쓰게 된 날 — 직함을 바꿀지 무게중심을 바꿀지

    20년 차 시니어 개발자가 코드 한 줄도 안 쓰게 된 날 — 직함을 바꿀지 무게중심을 바꿀지

    핵심 요약

    • 구조적 원인: 20년간 ‘작성한 코드량이 곧 임팩트’라는 등식이 유지됐지만, AI 코딩 에이전트가 보일러플레이트·구현·테스트 생성을 흡수하면서 코드량과 가치가 분리되는 전환점에 도달한 것으로 분석됨. 시니어일수록 ‘더 이상 손으로 짤 게 없다’는 상태가 빨리 도래하는데, 정체성·평판·보상 체계는 여전히 과거 등식에 묶여 있어 방향 상실이 커짐.
    • 실무 의사결정 기준: ‘AI 대체 저항성’은 직함이 아니라 스킬의 성격에 달려 있음. 시스템 설계·아키텍처 결정·도메인 맥락 해석·리스크 판단처럼 ‘맥락과 판단’이 핵심인 영역은 AI가 보강해도 대체하지 못해 가치가 증폭되고, 순수 구현·문법·CRUD 같은 영역은 AI가 빠르게 흡수함. 따라서 ‘DEV에 머무를지 PO/SM으로 갈지’는 2차 질문이고, 1차 질문은 ‘어떤 스킬에 무게중심을 둘 것인가’임. 구체적으로는 (1) 자신의 일 중 AI가 이미 상당 부분을 처리하는 영역 분류, (2) 남은 시간 중 도메인·사람·리스크가 차지하는 비중 측정, (3) 그 비중이 다음 수년간 더 커질지 시나리오화 — 이 세 단계로 결정하는 것이 실무적으로 검증된 방식으로 보임.
    • 피해야 할 안티패턴: (1) ‘AI가 못 하는 직함’으로의 도피 — PO/SM 역시 자동 백로그 정리·회고 분석·스프린트 계획 등 AI 도구가 빠르게 들어오고 있어 ‘관리자는 안전하다’는 가정은 5년 안에 흔들릴 가능성이 큼. (2) ‘결정을 미루면 시장이 보인다’는 대기주의 — AI 도구 도입 속도가 빨라 결정 지연은 협상력을 급격히 떨어뜨림. (3) ‘코드를 안 쓰면 임팩트가 없다’는 자기확신 붕괴 — 코드를 덜 쓰더라도 ADR·아키텍처 문서·기술 전략·리스크 리뷰 등 ‘판단의 흔적’을 산출물로 남기지 않으면 조직 내 가치가 빠르게 증발함.

    AI 시대 시니어 개발자의 커리어 안전은 ‘AI가 대체하지 못하는 직함’에 머무는 것이 아니라, AI가 생성한 결과물의 방향을 결정하고 그 품질을 보증하는 ‘판단과 맥락’에 무게중심을 옮기는 데서 나온다.

    목차

    매일 아침 IDE를 켜고 PR을 올리던 손이 멈췄다. 20년 동안 쌓아온 손코딩 근육은 그대로인데, 정작 코드를 직접 타이핑하는 시간은 하루 30분을 넘기기 어렵다. Cursor가 추천해주는 다음 줄, Copilot이 채워주는 함수 시그니처, Claude Code가 짜주는 마이그레이션 패치 — 그 너머에 남는 일은 ‘이걸 왜 이렇게 만들지?’라는 질문뿐이다. 이 질문에 답하는 사람이 시니어 개발자의 진짜 임무라는 자각이 슬쩍 올라온다.

    그런데 회사는 여전히 ‘작성한 라인 수’로 임팩트를 측정하지 않는다. 동료는 여전히 PR 리뷰 코멘트 개수로 신뢰를 판단하고, 채용 시장은 여전히 ‘아키텍트’라는 직함을 좇는다. 본인이 가장 잘하는 일이 변했는데, 그것을 보여줄 언어가 없는 것이다.

    한 경력 엔지니어 포럼에서 20년 차 엔지니어가 토로한 이 혼란은 특수한 사정이 아니다. AI 코딩 에이전트가 보일러플레이트를 흡수하는 속도가 빨라지면서, 경력이 오래될수록 ‘더 이상 손으로 짤 게 없다’는 상태에 빨리 도달한다. 정작 그들은 코드 한 줄 없이도 가장 큰 결정을 내리는 사람들이다.

    필자가 현업에서 수십 개 팀의 엔지니어링 문화를 봐온 바로는, 이 혼란의 본질은 직함의 문제가 아니다. ‘DEV로 남을지 PO/SM으로 갈지’는 표면적 선택지이고, 그 뒤에 숨은 진짜 결정은 ‘어떤 판단력에 무게중심을 둘 것인가’다. 같은 고민을 더 폭넓게 풀어낸 글이 AI 개발자 역할 재정립 5단계에 있으니, 여기서는 20년 차 시니어의 시선에서 그 무게중심을 어디로 옮길지 의사결정 프레임워크를 풀어본다.

    가치의 좌표가 흔들리는 이유

    지난 20년간 SWE 시장에는 ‘작성한 코드량 = 임팩트’라는 방정식이 통했다. 커밋 수가 많고, PR이 잦고, 깃허브 그래프가 푸르다 — 이게 곧 가치의 증거였다. 그런데 AI 코딩 에이전트가 그 등식의 왼쪽 변수를 급격히 통째로 삼켜버렸다.

    같은 기능을 만들기 위해 사람이 직접 타이핑해야 할 코드는 이제 10분의 1도 안 된다. 문제는 시장이 그 감소분을 ‘시간 절약’으로만 본다는 점이다. 절약된 시간이 다른 가치를 만드는 데 쓰이지 않으면, 임팩트 총량은 그대로가 아니라 줄어든다.

    시니어 개발자 특유의 모순이 여기서 폭발한다. 도메인 지식이 깊고 시스템 전체를 보는 안목이 있고 장애 패턴을 외우고 있는 사람일수록, AI가 보일러플레이트를 처리해줄 때 가장 큰 임팩트를 낼 수 있다. 그런데 그 임팩트는 코드량이 아니라 ‘결정을 내린 횟수’로 나타난다. ADR 한 줄, 디자인 리뷰 한 마디, 장애 대응 한 번 — 이런 흔적은 PR 통계에 잡히지 않는다. 그래서 시니어들은 자신이 더 많은 일을 하고 있는데도 그 일을 증명할 수 없다고 느끼는 것이다.

    AI 레버리지 매트릭스 — 내 시간을 세 영역으로 분리하기

    첫 번째 행동은 자신의 업무를 ‘AI 대체·AI 보강·AI 증폭’ 세 영역으로 분류하는 것이다. IEEE SWEBOK이나 SFIA 같은 표준 competency framework을 백본으로 깔고, 지난 한 달간 했던 작업을 시간 단위로 적어보면 패턴이 보인다. 대체 영역은 보일러플레이트 작성, 단순 CRUD, 반복 테스트 코드 생성이 대표적이고, 보강 영역은 리팩터링, 마이그레이션, 코드 리뷰 보조, 증폭 영역은 아키텍처 결정, 트레이드오프 판단, 장애 원인 추론, 도메인 규칙 해석이다.

    대체 영역이 업무 시간의 절반을 넘으면 그건 무게중심 이동이 시급하다는 신호다. 단순히 PO/SM 직함을 따는 게 아니라, 대체 영역의 시간을 의도적으로 줄여서 보강·증폭 영역으로 재분배해야 한다. 측정 도구는 거창할 필요 없다. Toggl 같은 시간 트래커에 태그를 달거나, 달력 블록에 ‘A/B/C’ 라벨을 붙이는 것만으로 충분하다. 두 달만 기록하면 자신의 일 중 어디서 가치가 증식되고 어디서 증발하는지 선명해진다.

    직함이 아니라 무게중심 — 진짜 결정은 무엇인가

    DEV/PO/SM 사이의 선택을 1차 결정으로 두면 거의 항상 실패한다. PO는 Jira 자동 분류, 회고 감정 분석, 스프린트 예측을 AI 도구가 빠르게 흡수하고 있고, SM 역시 페르소나 기반 코칭 제안, 세션 가이드 자동 생성이 이미 들어오고 있다. 5년 안에 ‘관리자는 안전하다’는 가정은 흔들린다. 진짜 1차 결정은 ‘나는 어떤 판단력에 시간을 더 쓰겠는가’다.

    구체적으로는 세 가지 질문으로 압축된다. 첫째, 내 일 중 도메인 맥락을 해석하는 일이 차지하는 비중은 무엇인가. 둘째, 그 비중이 다음 18개월간 더 커질 것인가. 셋째, 그렇다면 그 판단력을 어떤 산출물로 증명할 것인가. 이 세 질문에 답할 때 직함은 자연스럽게 따라온다.

    도메인 비중이 크고 그 비중이 커진다면 그 사람은 사실상 PO의 결정 영역을 DEV 직함으로 수행하는 것이고, 시스템·리스크 비중이 커진다면 그 사람은 테크리드나 아키텍트의 길을 가는 것이다. AI 개발자 대체 4단계 생존 절차에서 다룬 단계와도 맞물리는 지점이다.

    판단의 산출물 — 코드 너머의 포트폴리오

    코드를 덜 쓴다 하더라도 판단의 흔적을 남기지 않으면 조직 내 가치는 빠르게 증발한다. 시니어 개발자가 남겨야 할 산출물의 핵심은 ADR(Architecture Decision Record), C4 모델, Wardley Map, Event Storming 결과물이다. 이 중에서도 ADR은 GitHub의 adr-tools나 Log4brains 같은 도구로 표준화하면 부담이 줄어든다. 주요 결정마다 컨텍스트, 검토한 옵션, 트레이드오프, 결과를 마크다운 한 페이지로 남기는 것이다.

    시스템 전체의 지형은 C4 모델로 보여주는 게 효과적이다. Structurizr DSL로 컨테이너와 컴포넌트 다이어그램을 코드와 함께 버전 관리하면, ‘이 서비스가 어떤 책임을 지고 누구와 어떻게 통신하는가’를 한 화면에 압축할 수 있다. 비즈니스 변화에 따른 기술 구성요소의 위치는 Wardley Map이 직관적이다. 어떤 컴포넌트가 ‘Custom Built’에서 ‘Product’로 흘러가는지, 어디가 다음 분기 임팩트가 클지를 시각화한다. 이 세 종류의 산출물은 AI가 직접 생성하기 어렵고, 사람의 판단과 맥락이 가장 잘 보존되는 영역이다.

    도메인 깊이는 Event Storming이나 Domain Storytelling 워크숍으로 강화한다. Backstage 기반 Developer Portal이나 Internal Developer Platform을 운영하면서 ‘AI 에이전트가 호출하는 표준 인터페이스’를 정의하는 것도 시니어의 영향력을 코드량이 아닌 ‘플랫폼 제약 설계’로 전환하는 구체적 수단이다. PMP나 PSPO 같은 자격증보다 이런 산출물이 포트폴리오에서 훨씬 강한 신호로 작동한다.

    PO/SM으로의 도피가 안전하지 않은 이유

    ‘AI가 코드를 대신 짜주니까 관리자가 되겠다’는 발상은 5년 안에 위험해진다. 이미 일부 팀에서는 AI가 스프린트 회고를 요약하고 백로그를 자동 정렬하며 사용자 스토리 초안을 뽑아낸다. 그저 일정을 조율하는 SM의 일은 자동화의 첫 번째 타깃이 된다. AI 에이전트 11개가 한 계정을 공유할 때에서 살펴본 것처럼, 도구 자체가 빠르게 중첩되며 사람의 결재·검증 단계마저 자동화 영역으로 빨려 들어간다.

    실무에서 가장 흔히 놓치는 함정은 ‘결정을 미루면 시장이 보인다’는 대기주의다. AI 도구 도입 속도가 워낙 빨라 결정 지연은 협상력을 급격히 떨어뜨린다. 현실적 경로는 현 직무 비중을 70% 정도 유지하면서 30%를 인접 영역에 분산시키는 것이다. 보안·데이터·플랫폼 프로젝트에 컨트리뷰션하고, PO나 테크리드 역할의 책임 범위를 한 사이클 단위로 실험한다. 6개월 안에 ‘내 결정이 팀의 방향을 바꿨다’는 경험이 누적되면 직함은 저절로 따라간다.

    지금 바로 해볼 것

    • 한 달간 시간 트래커에 ‘A·B·C’ 태그 달기 — Toggl 또는 Clockify에서 ‘A(대체)’, ‘B(보강)’, ‘C(증폭)’ 태그를 설정하고 4주간 모든 작업을 분류한다. 매주 금요일 30분 동안 집계해 대체 영역이 50% 이상인지 확인한다.
    • 첫 ADR을 48시간 안에 작성하기 — GitHub 저장소에 docs/adr/0001-record-architecture-decisions.md 파일을 만들고, 최근 한 달간 내린 가장 큰 결정 하나를 컨텍스트·옵션·결과 형식으로 적는다. adr-tools의 adr new "제목" 명령으로 템플릿을 자동 생성할 수 있다.
    • Structurizr DSL로 C4 다이어그램 1개 그리기 — brew install structurizr-cli 또는 docker run -it structurizr/cli로 도구를 설치하고, 현재 담당 서비스의 컨테이너 뷰를 정의한다. structurizr export로 PNG를 뽑아 PR에 첨부한다.
    • Wardley Map 보드 1개 만들기 — 온라인 도구로 본인이 책임지는 시스템의 구성요소를 ‘Genesis·Custom Built·Product·Commodity’ 축에 배치한다. 다음 18개월 안에 어디로 흘러갈지 화살표를 그려본다.
    • 인접 역할 실험 1건 등록하기 — 분기 목표에 ‘스프린트 계획 1회 리드’, ‘기술 부채 정리 백로그 작성 1건’ 같은 실험 항목을 추가하고 90일 후 결과를 회고한다.

    자주 묻는 질문

    ADR을 쓰기 시작하면 PR 리뷰 부담이 너무 늘지 않을까요?

    ADR은 PR마다 쓰는 게 아니라 분기당 3~5건 정도면 충분하다. 오히려 결정의 컨텍스트가 문서화되어 있으면 다음 사람이 ‘왜 이렇게 만들었지?’라고 묻는 시간이 줄어들어 리뷰 자체가 빨라진다. adr-tools를 쓰면 파일 명명 규칙과 링크 자동화가 따라온다.

    PO나 SM으로 직함을 옮기면 연봉 협상에서 손해인가요?

    단기적으로는 임베디드 엔지니어 타이틀이 유리할 수 있지만, 5년 안에는 PO/SM 직함에서도 무게중심이 ‘결정자’에 있는지 ‘진행자’에 있는지 분기가 일어난다. 연봉은 직함이 아니라 산출물의 희소성과 영향력 범위로 결정되므로, ADR과 플랫폼 설계로 가시화된 판단력이 더 강하다.

    팀에서 AI 도구 도입을 반대하는 분위기라면 어떻게 접근하나요?

    ADR 한 건을 ‘도입 안 함’으로 쓰는 것 자체가 시작점이다. 결정의 컨텍스트에 ‘리스크 허용 범위’, ‘성능 측정 계획’, ‘롤백 조건’을 명시하면 팀 내 신뢰가 생긴다. 도구를 강요하는 것보다 ‘이런 결정을 남겼다’는 관행이 먼저 자리를 잡아야 한다.

    참고 원문

    이 기사는 다음 원문을 확인해 작성했습니다: r/cscareerquestions — The future of SWE. How to prepare?