대상: 대규모·규제 환경의 코드 현대화 프로젝트를 준비하는 조직 원문 게시일: 2026-09-23 저자: Jonah Ezekiel, Lexie Tonelli 시리즈: Notes from the Field (Anthropic forward deployed engineers)

핵심 판단

AI 에이전트가 코드 변경 속도를 높여도, 핵심 시스템의 변경 관리·검토·승인이라는 조직적 프로세스는 그대로 남는다. 병목은 변경 생산에서 변경 주변으로 조직을 동원하는 일로 이동한다. 따라서 AI 기반 현대화의 성패는 기술보다 사전 준비(무엇이 완료인지, 어떤 증거를 요구할지, 변경을 어떻게 프로덕션에 반영할지) 에 달려 있다.


주요 논점

배경

  • 과거에 다년·전체 인력 규모로 계획되던 코드 현대화가 이제는 수개월·수주 단위로 완료된다. 그러나 그 전후의 조직적 작업은 거의 변하지 않는다.
  • 핵심 뱅킹 시스템 등 규제 대상 시스템은 변경마다 변경 관리·검토·승인을 거쳐야 하며, 이는 규제기관·감사인·비즈니스 요구 때문에 견고한 프로세스다.
  • 이 프로세스는 인간이 각 변경을 작성하고 인간이 각 diff를 검토한다는 전제 위에 구축되어 있다. 에이전트가 변경 작성 속도를 높이면, 병목은 변경 생산이 아니라 변경 주변으로 조직을 동원하는 일로 이동한다.
  • 이 글은 현대화가 시작되기 전에 기업이 해야 할 일을 다룬다: 완료의 의미 정의, 변경이 갖춰야 할 증거, 인증된 변경이 프로덕션에 도달하는 경로, 실행을 시작할 수 있도록 준비돼야 할 것들.

Anthropic은 이 프로세스를 6단계로 정리한다.

  1. 목표 정의(Define the target): 현대화된 코드가 가져야 할 기술 스택과 동작.
  2. 인증서 생성(Create the certificate): 목표 상태에서 올바르다고 간주되기 위해 변경이 충족해야 하는 조건.
  3. 승격 정책 수립(Set the promotion policy): 인증된 변경이 생산 속도만큼 빠르게 프로덕션에 도달하는 경로.
  4. 전제 조건 정비(Put the prerequisites in place): 환경, CI/CD, 검토 역량, 승인.
  5. 에이전트 워크플로우 구축·다듬기(Build and refine the agentic workflow): 목표·인증서·승격 정책을 중심으로 여러 병렬 하위 에이전트 워크스트림에 현대화를 분배하는 맞춤형 Claude Code 동적 워크플로우.
  6. 현대화 실행(Run the modernization): 코드베이스의 작은 구역에서 워크플로우를 종단 간 입증한 뒤 확장.

Step 1 — 목표 정의 (Define the target)

목표(target) 는 현대화의 최종 상태다. 원하는 최종 상태에 따라 아래 세 현대화 유형 중 어떤 것을 수행하는지 결정된다.

현대화 유형 결정

유형설명선택 시점목표는
Uplift동일 스택 버전 갱신 (예: C++11 → C++20)스택은 괜찮지만 버전이 뒤처짐: EOL 런타임, 패치 안 된 보안 이슈, 더 이상 업그레이드할 수 없는 의존성런타임 버전 + 패키지 세트
Transform동작을 고정한 채 스택을 교체하는 교차 스택 재작성 (예: COBOL → Java)스택이 해결할 문제이고 동작을 신뢰함Uplift에 필요한 것 전부 + 새 코드가 따라야 할 언어·프레임워크·아키텍처 규약
Reimagine동작 변경을 동반한 새 아키텍처 그린필드 재구축코드와 함께 동작도 바꿔야 함Transform에 필요한 것 전부 + 새 시스템에 대한 작성된 동작 명세

유형 선택 시 내부 긴장

  • 프로덕션에 가까운 사람들: 리스크를 억제하기 위해 동작을 고정하고 스택만 교체하길 원함 (transform).
  • 코드베이스와 오래 생활한 엔지니어 + 새 요구사항을 명명하려는 비즈니스 이해관계자: 기술 부채를 갚고 신규 요구사항을 반영하길 원함 (reimagine).

둘 다 합리적인 입장이지만, unresolved 상태로 두면 나중에 특정 변경이 “올바른지”를 두고 쟁점으로 재등장한다. 어떤 경로를 택할지 사전에 합의를 구축하면 초기 마찰은 있지만 프로젝트 전체를 streamline한다.

코드베이스 매핑과 동작 명세 생성

  • 현재 시스템을 이해하는 것이 목표 정의의 좋은 첫 걸음이다. 기존 코드가 실제로 하는 일을 추출하고 현재 동작 인벤토리를 만들면, 어떤 부분을 변경/삭제할지, 현대화가 transform인지 reimagine인지 판단하기 쉬워진다. 이 과정에서 알려진 적 없는 비즈니스 로직과 엣지 케이스가 드러나는 경우가 많다.
  • Claude는 의존성 매핑, 누구도 기억하지 못하는 워크플로우 문서화를 통해 발견 작업의 상당 부분을 수행할 수 있다. 코드 현대화 플러그인의 assess, map, extract-rules 명령은 엔지니어가 검토할 수 있는 소스 인용과 함께 비즈니스 규칙을 채굴한다.
  • 그러나 Claude의 발견만으로는 레거시 시스템의 전체 동작을 완전히 포착하지 못할 수 있다. 비즈니스 사용자·개발자 인터뷰, 내부 문서로 간극을 메워야 한다. 컨텍스트 수집은 upfront에 시간이 들지만, 그 품질이 이후 워크플로우의 모든 결정을 좌우한다.
  • Reimagine의 경우 목표 정의에 추가 작업이 필요하다: 상세한 동작 명세를 작성하고 사용자 그룹과 합의해야 한다.

프로젝트의 정당성과 목표 확립

  • 목표 정의와 함께, 현대화가 왜 수행할 가치가 있는지 조직이 고민해야 한다. 레거시 시스템 현대화는 유지보수·운영 비용을 줄일 수 있지만, 경험상 비용 절감이 대부분 현대화 프로젝트의 주된 동기는 아니었다.
  • 위험 감소(risk reduction)가 종종 가장 중요한 현대화 이점이다. 현대화를 할지 말지 논의할 때, 현대화를 하지 않을 때의 위험을 고려하라.
    • 패치되지 않은 취약점이 있는 시스템은 사이버 침해나 비즈니스 자체를 위험에 빠뜨릴 만한 장애로 이어질 수 있다.
    • 지원 중단된 런타임, 시스템을 이해하는 엔지니어 풀의 축소는 리스크를 악화시킨다.
  • Claude Code 같은 에이전트 코딩 도구가 현대화 타임라인을 단축했지만, 예산은 여전히 추정이 어려워 정체(inertia)로 이어진다. Anthropic은 일부 대규모 현대화 비용을 공개했고, 다른 곳도 공개했다. 이것들이 대략적인 기준선 역할을 할 수 있으며, 예산 예측에 대한 추가 지침도 제공된다.
  • 이런 프로젝트 시작의 주된 과제는 보통 시스템을 소유한 팀과 그에 의존하는 팀으로부터 내부 합의와 몰입을 구축하는 것이다. 비즈니스 케이스 구축과 프로젝트 목표 설정(종종 리더십 수준에서)은 이 과정을 더 쉽게 만든다. 이는 뒤따르는 인증서와 승격 정책의 트레이드오프를 고정하는 데도 도움이 된다. 이해관계자들이 변경이 감내할 수 있는 리스크 수준을 두고 의견이 갈릴 때, 현대화하지 않을 리스크가 균형추(counterweight)가 된다.

Step 2 — 인증서 정의 (Define the certificate)

인증서(certificate) 는 모든 현대화 변경이 충족해야 하는 조건/테스트 집합이다. 목표 대비 변경이 올바르다는 가장 강력한 누적 증거를 제공하는 조건을 골라라.

  • 각 조건은 사람 개입 없이 검증 가능해야 한다. 그래야 에이전트 워크플로우가 인증서 충족까지 변경에 반복(iterate)하거나, 충족하지 못하면 사람 검토로 플래그할 수 있다.
  • 인증서 내용은 대상에 따라 다르지만 보통 아래 목록에서 가져온다.
    • 원본 테스트 스위트 통과
    • 현대화 중 Claude가 작성한 테스트 전부 통과
    • 합의된 임계값을 충족하는 테스트 커버리지
    • 합의된 범위 안에 머무는 성능 벤치마크
    • 각각 새 컨텍스트 창에서 수행하는 Claude의 독립적 적대적 검토에서 차단 이슈 없음
    • UI의 경우 Claude 기반 computer use에서 회귀 없음
    • 현재 버전과 대상 버전이 동일 입력에서 동일 출력 생성 (live/recorded/Claude 생성 모두 가능)
    • 지속 상태(persisted state)와 와이어 포맷이 현재 버전과 대상 버전 간 왕복(round-trip)
    • 합의된 기간 동안 스테이징에서 변경 실행 시 오류율·지연시간·알림의 회귀 없음
    • 정적 분석·보안 스캔에서 새 findings 없음
    • 컴파일 타겟의 경우 빌드 클린, 타입 체크 통과

프로덕션으로 변경을 검토하고 승격할 사람들과 함께 인증서를 작성하라. 코드베이스에 현재 의존하는 개발자·사용자 그룹·비즈니스 리더를 인증서와 에이전트 워크플로우가 아직 설계 중일 때 끌어들여라.

  • 그들의 전문성이 인증서가 측정하는 것을 형성하고, 초기 관여가 변경이 검토에 도달할 때 그들의 몰입(buy-in)을 얻는 요소다.
  • 완성된 인증서에 대한 좋은 점검: 그들이 인증서의 증거만으로 병합하는 데 편안할 것인가? 그들에게 자기 기준이 보인다면, Step 3의 승격 정책을 더 가볍게 가져갈 수 있다.

현대화 유형별 인증서 기준

  • Uplift 현대화: 동등성(parity)은 원본 코드베이스를 기준으로 하며, 원본 테스트 스위트가 인증서의 핵심이 될 수 있다.
  • Transform 현대화: 동등성도 원본 코드베이스를 기준으로 하지만, 원본 테스트 스위트는 새 스택에서 거의 실행되지 않는다. 프로덕션 트래픽 재생, 기존-신규 간 차등 테스트(differential testing), 프로덕션-병렬 배포(prod-parallel deployment)가 대부분 작업을 대신한다.
  • Reimagine 현대화: 인증서는 동작 명세에 고정된다. 이 경우가 가장 어렵다. 명세는 비교할 기존 시스템보다 덜 객관적이어서 모델 판단의 개입이 더 크고, 결과가 더 가변적일 수 있다. 여기서 인증서는 명세로부터 작성된 테스트, 각 변경을 명세와 대조해 점검하는 Claude의 독립적 적대적 검토, 새 시스템이 이전 시스템의 동작을 유지하는지 보는 차등 체크에 의존한다. 명세가 명확해짐에 따라 인증서를 개정할 것을 예상하라 — 명세의 간극이 여기서 먼저 드러난다.

빈약한 테스트 커버리지 대응

  • 오래된 시스템은 종종 얇은 테스트 커버리지, 불안정한(flaky) 테스트, 적은 텔레메트리를 갖는다. 인증서 정의의 일부는 이러한 간극을 식별하는 것이다.
  • 강력한 인증서를 지원하기 어렵다면, 이 단계에서 할 수 있는 가장 유용한 작업 중 하나는 Claude를 사용해 누락된 증거를 구축하는 것이다 — 프로덕션-병렬 설정 구축, 재생 하네스(replay harness) 구축, 더 많은 테스트 작성 등.

Step 3 — 승격 정책 수립 (Set the promotion policy)

에이전트는 인간 팀이 diff 단위로 검토할 수 있는 것보다 훨씬 빠르게 변경을 생산한다. 승격 정책은 변경에 대한 인간 검토의 깊이를 설정하는, 서면이 작성되고 사전에 합의된 계층적 검토 경로(tiered review path) 로, 현대화가 수용 가능한 타임라인에 완료되게 한다.

  • 인증서와 마찬가지로, 이 단계도 검토자(reviewers)와 함께 수행하고 가능한 한 조직의 기존 변경 관리 프로세스에 맞춰라. 세부사항은 조직과 직면한 리스크 트레이드오프에 따라 다르지만, 몇 가지 규칙은 모든 곳에서 성립한다.
    • 폭발 반경(blast radius)과 에이전트 신뢰도로 변경을 계층화하라. 조직에 자체 변경/리스크 분류가 있으면 사용하라. 중요한 경로(critical paths)에는 완전한 인간 검토를 유지하라.
    • 반복되는 플래그를 근본 원인에서 수정하라. 시간 경과에 따라 플래그된 변경을 그룹화·분석하라. 같은 종류의 플래그가 계속 반복되면, 각각 검토하는 대신 에이전트 워크플로우나 인증서에서 원인을 수정하라.
    • 검토자와 함께 출력 형식을 설계하라. 검토를 가장 빠르게 하는 정보·형식, 더 큰 신뢰를 주는 신호가 무엇인지에 합의하라. Step 5에서 초기 샘플 출력을 검토하게 하라.
    • SME 시간을 효과적으로 할당하라. SME는 모든 최종 diff를 읽지는 않지만, 그들의 판단은 여전히 희소한 입력이다. 대규모 diff를 헤집지 않고 가장 높은 리스크 계층의 변경과, 각 계층 내 플래그된 에이전트 결정으로 바로 이동할 수 있게 만들어라. 소수의 전문가 시간으로 가장 많은 리스크를 수반하는 변경을 커버할 수 있다.

이러한 규칙의 다수는 프로젝트 초기에 SME를 참여시켜 SME 시간을 앞당긴다. 그들의 피드백이 전체 현대화 시작 전에 인증서와 에이전트 워크플로우를 튜닝한다.

속도 vs 검토 깊이 스펙트럼상의 위치

  • 승격 정책은 현대화가 속도 vs 검토 깊이 스펙트럼의 어디에 위치하는지도 반영해야 한다.
    • 지원 종료 런타임처럼 촉박한 마감일을 향해 경주하는 현대화는, 더 가벼운 인간 검토와 변경당 더 많은 리스크를 수용한다는 명시적 합의를 동반한 더 빠른 정책이 필요하다.
    • 더 긴 타임라인의 현대화는 더 깊은 인간 검토와 더 느린 전환(cutover)을 감당할 수 있다.
    • 이해관계자들은 리스크 성향과 제약에 따라 이 스펙트럼의 서로 다른 지점에 정착할 것이므로, 작업 시작 전에 고정하는 것이 가치 있다.

규제 환경에서의 긴장

  • 규제 환경에서 어떤 변경에 대해 더 가벼운 인간 검토 경로를 취하는 것은 실제 불편을 초래할 수 있다. 개별 승인자는 나쁜 변경의 리스크를 떠안기 때문에 승인에 주저하는 반면, 리더십은 노후 시스템의 더 큰 리스크를 떠안는다.
  • 경험상 승격 정책에 대한 지시는 조직 최고 수준에서 내려오는 것이 가장 좋다. 또한 사전에 합의하는 것이 더 좋은데, 프로덕션에 도달한 버그에 대한 책임이 승인한 사람에게 집중되지 않고 공유되도록 하기 때문이다.

이 모든 것은 실제 증거 역할을 할 만큼 상세한 인증서, 그리고 Claude가 변경에 어떻게 도달했는지 충분히 이해하여 신뢰할 수 있는 검토자에게 여전히 달려 있다.


Step 4 — 전제 조건 정비 (Put the prerequisites in place)

이 단계의 많은 부분은 현대화 외부의 팀들을 통과한다: 호스트에 대한 플랫폼/인프라, 테스트 용량에 대한 QA/릴리스 엔지니어링, 승인에 대한 보안·컴플라이언스. 이 팀들 각각은 자체 백로그나 승인 프로세스를 갖는 경우가 많으므로, 요구사항을 식별하는 즉시 — 종종 Step 1~3이 아직 진행 중일 때 — 대화를 일찍 열어라.

환경

  • Claude가 접근할 수 있는 코드베이스와 기타 관련 소스가 도달 가능한, 워크플로우 실행용 전용 원격 호스트
  • 인증서에서 요구하는 테스트 용량
  • 인증서를 강화하는 모든 것: 프로덕션 텔레메트리, 프로덕션-병렬 설정, 재생을 위한 프로덕션 데이터

코드베이스 및 CI/CD

  • 빌드·컴파일 로그, import 분석, 런타임 트레이스에 기반한 코드베이스 의존성 맵. 코드 현대화 플러그인의 map 명령이 좋은 시작점이지만, 코드베이스 크기와 연식에 따라 더 광범위한 upfront 작업이 필요할 수 있다.
  • 대상 정의의 일부로 의존성/패키지의 계획된 처리
  • 필요한 경우 CI/CD에 추가할 준비가 된 호환성 체크
  • 인플레이스(in place) 현대화 시 합의된 코드-동결(code-freeze) 정책
  • 코드 동결 및 새 호환성 요구사항을 다루는 활성 개발자 대상 커뮤니케이션 계획

팀 및 검토

  • 코드베이스에 의존하는 다른 팀들이 참여 방식(인증서 서명, 승격 정책 하 검토 등)에 합의하고, 검토자 시간을 확보해 둠

보안 및 컴플라이언스

  • 소스 코드용으로 승인된 Claude Code용 모델 접근 경로
  • 에이전트 워크플로우에 대한 최소 권한 접근: 현대화 브랜치에만 쓰기, 프로덕션 자격 증명 없음
  • 현대화 브랜치에서 시크릿과 PII를 scrub/mask
  • 모든 변경이 추적 가능하고 PR이 에이전트 트랜스크립트·인증서 증거에 링크됨
  • 새 의존성에 대한 라이선스·취약성 체크

Step 5 — 에이전트 워크플로우 구축·다듬기 (Build and refine the agentic workflow)

Claude Code를 사용해 코드베이스 현대화용 맞춤형 동적 워크플로우를 개발하라.

  • 코드 현대화 플러그인으로 시작하는 것을 권장하며, 워크플로우가 필요로 할 수 있는 모든 것을 Claude가 접근할 수 있는 파일 시스템이나 MCP 위에 올려라. 여기에는 목표, 인증서, 승격 정책, 코드베이스, 문서, 인증서가 요구하는 데이터 소스나 도구가 포함된다. 이 글 자체도 Claude에 컨텍스트로 제공할 수 있다 — 이것이 프로젝트의 중앙 지식 기반을 형성한다.
  • 그 기반이 갖춰지면 현대화 워크플로우 구축은 쉬운 부분이다. 하류에서 의존하기 전에, 코드베이스별 스킬이나 추출된 규칙을 포함해 필요에 따라 Claude의 작업을 SME가 검토하게 하라.
  • 구축한 것을 코드베이스의 작은 부분에 적용해 다듬고, SME가 생산하는 변경, 에이전트의 프로세스, 인증서가 충족됐다는 증거를 검토하게 하라.

문제가 발생하면 각 변경이 아니라 워크플로우를 수정하라. 목표는, 일단 확장되면 변경이 거의 모든 곳에서 인증서를 충족하고, 검토자가 승격 정책 하에서 병합하는 데 편안할 것이라는 확신이다.


Step 6 — 현대화 실행 (Run the modernization)

  • 먼저 코드베이스의 작은 부분에서 현대화를 종단 간(end to end) 완료하고, 변경을 승격 정책을 통해 검토·착륙(land)까지 진행하라.
  • 아직 저렴할 때 작동하지 않는 것을 수정하고, 확신할 때까지 프로세스를 반복한 뒤 전체 코드베이스로 확장하라.
  • Transform·Reimagine 현대화는 기존 시스템과 함께 대상을 구축하고 완료 시 전환하는 반면, Uplift에는 두 번째 옵션이 있다: 개발이 계속되는 동안 라이브 코드베이스에서 인플레이스로 현대화하는 것.
  • 이 방식이 일반적인 경우: 시스템을 다운시킬 수 없거나, 코드베이스가 너무 빠르게 변경되어 별도 현대화 사본을 최신 상태로 유지하기 어려운 경우.
  • 이 경우에 작동하는 방식: 리프(leaves)에서 안쪽으로 코드베이스를 논리적 파티션으로 분할 → 한 번에 하나의 파티션을 동결·현대화 → 파티션이 현대화된 뒤에는 새 커밋이 이를 되돌릴 수 없도록 CI/CD를 게이트(gate)한다.

비용에 관한 노트

이런 현대화가 토큰 기준으로 얼마나 드는지 자주 질문받는다. 각 현대화 노력은 다르지만, 주요 비용 동인은 다음과 같다.

  • 코드베이스 중 읽어야 하는 부분 대 변경해야 하는 부분의 비율
  • 인증서의 관여도 — 규제 환경에서는 보통 변경 작성이 아니라 검증이 더 큰 몫
  • 인증서가 요구하는 새 테스트 작성·테스트 수리량
  • 실행 중 주변에서 다른 팀이 병합하면서 발생하는 조정(reconciliation) 작업량

코드베이스의 작은 부분에서 현대화를 완료할 때 토큰 사용량을 측정하고, 이를 사용해 나머지 실행에 대해 추정(extrapolate)하라. 파일럿이 볼 수 없었던 것(라이브 코드베이스에서의 조정 등)은 미지로 취급하라. 이렇게 하면 전체 현대화에 대한 비용 하한(cost floor) 추정치를 얻을 수 있다.

  • 파일럿 측정값은 에이전트 워크플로우를 비용 측면에서 최적화할 위치도 보여준다. 가장 많은 토큰을 소비한 워크플로우 부분을 찾아 더 효율적으로 만들 방법을 고려하라. 컴퓨팅-heavy 검증 신호를 더 저렴한 게이트 뒤로 이동시켜, 더 쉬운 체크가 통과한 후에만 실행되게 하라.
  • 인증서가 완전히 검증하는 기계적이고 대량 작업에는 Sonnet처럼 비용과 능력을 균형 있게 맞추는 모델을 고려하라. 더 지능적인 모델은 어려운 변환과 정확성을 검증하는 적대적 검토에 남겨둬라.
  • 덜 비싼 모델이 인증서 충족에 실패하면 더 비싼 모델로 에스컬레이션할 수도 있지만, 파일럿 중에 재시도율(retry rate)을 주의 깊게 분석하라. 여러 번의 저렴한 시도가 한 번의 비싼 시도보다 더 비쌀 수 있다.
  • Claude에 워크플로우와 파일럿 데이터 모두에 접근권을 주면, 이 분석의 많은 부분을 함께 수행할 수 있다.

현대화를 넘어서

현대화된 코드베이스는 하나의 산출물이다. 나머지는 그것을 생산한 워크플로우, 무엇이 올바른지에 대한 서면 인증서, 변경 관리 프로세스가 이미 수용한 승격 정책, 그리고 착륙한 모든 변경에 대한 증거 흔적(evidence trail) 이다. 플레이북을 재사용 가능한 자산으로 코드화(codify)하라 — 그래야 다음 업그레이드· 재작성 때 패턴이 이미 갖춰져 있다.

Anthropic의 forward deployed engineers는 고객과 함께 가장 중요한 시스템에서 이 단계들을 수행한다. 현대화를 준비 중이라면 Anthropic 팀과 대화할 수 있다.


관련 노트

추가 리소스 (원문)