다음에 올 것을 만들어가는 기술에 대한 심층 기사.

개발자 vs 아키텍트: 언제 누가 이기나

개발자와 아키텍트의 차이는 직함이 아니라 아키텍처 결정의 주인이 누구냐입니다. ADR, 결합도, 되돌릴 수 있는지 따져봅니다.

두 갈래로 갈라지는 빛의 경로가 놓인 책상을 위에서 내려다본 일러스트. 한쪽은 엉켜 있고 다른 쪽은 깔끔하다.
타이핑은 빨라졌습니다. 이제 중요한 일은 결정하는 것입니다.

지난달 브라우저 애드온의 신규 설치를 기록하려고 AI 코딩 어시스턴트가 try/catch를 줄줄이 쓴 diff를 리뷰했습니다. 먼저 사용자 이메일을 가져오려 하고, 실패하면 사용자 ID로 대체하고, 그마저 실패하면 “누군가 설치했는데 누군지 모름”이라고 로그를 남기는 식이었습니다. 코드는 돌아갔습니다. 하지만 틀린 코드였습니다. 플랫폼이 애드온이 요청할 수 있는 신원 데이터를 최근 강화했거든요. 개발자냐 아키텍트냐의 질문은 바로 이런 diff 속에 숨어 있습니다. 그리고 지금 여러분이 어느 쪽에 서 있는지 아무도 알려주지 않았죠.

정답은 더 나은 catch 블록이 아니었습니다. 설치 시각을 기록하고, 환영 화면을 보여주고, 사용자가 나중에 직접 제공하지 않는 한 설치 시점에 마케팅팀이 이메일을 가질 수 없다고 알려주는 것이었습니다. 이런 판단은 어떤 모델도 내리지 못합니다. 모델은 여러분의 사용자, 플랫폼 정책, 마케팅팀의 분기 목표를 모르니까요. 모델은 요구한 것을 무섭도록 빠르게 해낼 뿐입니다. 결국 요청하는 사람, 즉 여러분이 코드보다 큰 책임을 지게 된 겁니다. 승진 축하합니다. 아무도 말해주지 않아서 미안합니다.

합리적인 반론도 있습니다. 좋은 팀의 엔지니어라면 어떤 직무든 요구사항에 이의를 제기하고, 맡은 티켓에 맞는 데이터 모델을 설계하는 것이 원래 일이었다고 말할 겁니다. 맞습니다. 좋은 팀에서는 늘 그게 핵심 업무였죠. 하지만 달라진 것이 있습니다. 예전에는 타이핑 속도가 나쁜 아이디어를 거르는 자연스러운 제동 장치였습니다. 형편없는 계획을 구현하는 데 3일이 걸리면 먼저 생각하게 되니까요. 지금은 90초면 되니, 누군가 생각하기도 전에 계획이 만들어집니다. 아키텍처 사고를 강제하던 마찰이 사라졌고, 그 자리를 채운 건 여러분뿐입니다.

개발자 vs 아키텍트: 서로 다른 두 직무

가장 깔끔하게 차이를 설명하자면 이렇습니다. 개발자는 티켓을 받으면 어떻게를 묻습니다. 아키텍트는 같은 티켓을 보고 이것이 존재해야 하는지, 그리고 어떤 형태여야 하는지를 묻습니다. 개발자는 주어진 제약 안에서 최적화합니다. 아키텍트는 제약 자체를 고르고, 무엇보다 그 선택이 향후 2년간 낳을 결과에 책임집니다. 둘 다 진짜 엔지니어링이에요. 다른 직무일 뿐이고, 실패하는 방식도 다릅니다. 개발자의 실패는 버그입니다. 아키텍트의 실패는 누군가 알아차릴 즈음엔 세 팀이 그 위에 기능을 쌓아 올린 중복 테이블 구조입니다.

AI 코딩 도구는 조용히 개발자 자리에 앉았습니다. 여러분이 채용한 가장 빠른 주니어 같은 존재죠. 지치지 않고, 말도 유창하고, 요구사항이 진짜 문제라고 말해주는 일은 절대 하지 않습니다. 사용자별 설치 로깅을 요청하면 정확히 사용자별 설치 로깅을 가져다줍니다. 플랫폼이 원치 않아도 “동작”하도록 폴백을 줄줄이 붙여서요. 모델은 앱의 지연 시간 예산, 개인정보 보호 정책, 온콜 로테이션에 대해 아무런 이해관계가 없습니다. 이건 도구의 결함이 아니라 그 자리의 직무 기술서입니다. 그러니 “아니요”라고 말하는 다른 자리는 여러분이 앉지 않으면 비어 있습니다.

그럼 그 자리에 앉으면 실제로 무엇을 해야 할까요? 크게 세 가지입니다. 요구사항이 사용자 이익과 충돌하는 순간을 알아챌 만큼 사용자를 잘 아는 것. 한 줄짜리 변경이 얼마나 넓게 영향을 미칠지 볼 수 있을 만큼 시스템의 결합도를 아는 것. 그리고 아무도 읽지 않는 위키의 박스와 화살표 다이어그램이 아니라, 코드가 만들어지기 전에, 사후 회고가 아니라 그 요구사항을 쓴 사람과 불편한 대화를 나눌 용기를 갖는 것. 이 중 어느 것도 도구에 위임할 수 없습니다. 반박할 줄 모르는 도구에게 맡길 수 있는 판단이 아니니까요.

여러분이 이미 내리고 있는 아키텍처 결정들

직함이 아키텍트가 아니어도 아키텍처 결정은 매주 내리고 있습니다. 일반적인 티켓 안에서요. 검증 로직을 어디에 둘지(클라이언트, API, 데이터베이스). 호출을 동기로 할지 큐에 넣을지. 무엇을 로깅하고 무엇을 의도적으로 로깅하지 않을지. 새 테이블의 구조와 그것이 외래 키로 무엇을 참조할지. 이 각각은 미래에 대한 베팅이고, 앞으로의 티켓 열 개를 제약하거나 가능하게 합니다. 그 설치 로깅 diff는 모니터링 작업처럼 보였지만, 실제로는 한 줄짜리 옷을 입은 개인정보 결정이자 보안 결정이며 제품 결정이었습니다.

여기 변경 전 코드가 있습니다. “누가 설치했는지 로그로 남겨라”를 어시스턴트가 충실히 구현한 결과입니다:

async function logInstall(req, res) {
let identity = null;
try {
identity = { email: await getUserEmail(req) };
} catch {
try {
identity = { userId: await getUserId(req) };
} catch {
identity = { note: "install without identity" };
}
}
await db.installs.insert({ ...identity, at: new Date() });
res.redirect("/welcome");
}

15줄, 실패 모드 세 개, 그리고 이메일이든 userId든 아무것도 없든 전부 수용해야 하는 스키마. 각 폴백은 설치 경로를 신원 API에 조용히 결합시키므로, 동의 게이트가 걸린 서비스의 장애가 이제 온보딩 퍼널을 느리게 하거나 깨뜨릴 수 있습니다. 그리고 “누군가 설치했는데 누군지 모름”이라는 행은 분석적으로 쓸모가 없습니다. 마케팅팀이 실행할 수 있는 정보가 하나도 없으니까요. 요구사항은 글자 그대로 충족되었지만 취지는 완전히 무너졌습니다.

async function logInstall(req, res) {
await db.installs.insert({ at: new Date() });
res.redirect("/welcome");
// Email is collected on the welcome screen, with consent,
// posted asynchronously — and never gates the install path.
}

변경 후 코드는 네 줄입니다. 그런데 실제로 바뀐 것을 보세요. 코드가 아니라 요구사항이 바뀌었습니다. 목표는 처음부터 “이메일을 수집하라”가 아니었습니다. “설치를 측정하고 신규 사용자에게 후속 조치를 하라”였죠. 타임스탬프는 설치를 측정합니다. 사용자가 이미 동의 화면을 보고 있는 환영 화면은 이메일을 요청하기에 맞는 자리입니다. 비동기로, 실패해도 비용이 들지 않는 방식으로요. 아키텍트의 움직임은 코드를 적게 쓰는 것이 아니었습니다. 코드가 무엇을 위한 것인지 협상을 다시 한 것입니다.

몸에 익힐 만한 습관이 있습니다. 사소하지 않은 변경을 하기 전에 2분짜리 결합도 점검을 하세요. 이 코드가 무엇을 호출하고, 무엇이 이 코드를 호출하며, 그것들이 느려지거나 다운되거나 지원 중단되면 무엇이 깨지는지 물어보는 겁니다. 변경 전 버전에서 설치 경로는 자신이 알 필요도 없던 신원 서비스 두 개에 의존했습니다. 변경 후에는 테이블 하나에만 의존합니다. 미래의 장애를 예측하는 숫자는 줄 수나 순환 복잡도가 아니라 이 의존성 개수입니다. 같은 패턴을 AI 코딩 어시스턴트가 예측 가능하고 검증 가능한 방식으로 실패하는 과정에서도 봤습니다. 결과물은 국소적으로는 그럴듯하지만 전역적으로는 강하게 결합되어 있습니다.

ADR vs 암묵지: 언제 무엇이 이기나

아키텍처 결정 기록(ADR)은 의도적으로 지루합니다. 맥락, 결정, 검토한 대안, 감수한 결과를 담은 한 페이지가 전부입니다. 의식도 없고, 원하지 않는 한 승인 워크플로도 없습니다. AI 시대에 ADR이 선택이 아니라 필수가 된 이유는 기억 때문입니다. 모델에게는 기억이 없습니다. 여섯 달 뒤 누군가 어시스턴트에게 설치 모듈을 가리키며 변경을 요청하면, 동의와 플랫폼 정책에 관한 신중한 추론은 사라질 겁니다. 사람과 도구 모두 찾을 수 있는 곳에 적어두지 않는다면요. 저장소 안의 ADR은 다음에 그 코드를 건드리는 사람(또는 무엇이든)이 읽게 됩니다.

암묵지가 실제로 이기는 상황도 있습니다. 이를 무시하는 것이 ADR이 관료적이라는 평판을 얻게 된 이유입니다. 수 주짜리 프로토타입을 만드는 두 명의 팀에는 결정 기록이 필요 없습니다. 의사결정자들이 서로 옆에 앉아 있고, 코드는 어차피 다시 쓰일 테니까요. 그 규모에서는 말로 주고받는 맥락이 더 빠르고, 풍부하고, 저렴합니다. 문제는 팀이 그 임계점을 넘었다는 걸 좀처럼 알아채지 못한다는 겁니다. 첫 신입 사원이 들어왔을 때, 첫 번째 팀이 여러분의 API를 쓰기 시작했을 때, “왜 이렇게 했지?”라는 질문에 답이 없는 첫 장애가 났을 때가 바로 그 순간입니다.

  • 결정을 되돌리는 데 비용이 많이 든다. 실시간 데이터의 스키마 변경, 공개 API 계약, 벤더 종속 등.
  • 결정이 팀 경계를 넘나들어서, 영향을 받는 사람들이 결정이 내려질 때 자리에 없다.
  • 미래의 질문이 벌써 들린다. “도대체 왜 이렇게 만든 거지?”
  • AI 도구가 구현했기 때문에, 어떤 사람도 그 추론을 소리 내어 설명할 필요가 없었다.
  • 트레이드오프가 자명하지 않다. 지연 시간, 개인정보 노출면, 운영 부담 등 실제 비용을 의도적으로 감수하고 있다.

네 번째 항목이 새로운 부분입니다. 사람이 코드를 쓰면 추론은 흔적을 남깁니다. 커밋 메시지, PR 논쟁, 시도 자체의 모양 같은 것들이요. 어시스턴트가 쓰면 추론은 잠깐 여러분 머릿속에만 존재하다가 어디에도 남지 않습니다. ADR은 리뷰를 가능하게 하는 산출물입니다. 리뷰어가 코드를 대조해서 확인할 수 있는 무언가를 주니까요. 그것이 없으면 리뷰는 스타일 지적으로 전락하고, 아키텍처는 조용히 표류합니다.

손으로 그린 박스와 화살표 다이어그램이 있는 노트와 부드러운 창문 빛 아래 놓인 만년필.
ADR은 diff가 잊힌 뒤에도 살아남는 한 페이지입니다.

시스템 설계에서 되돌릴 수 있는 결정과 되돌릴 수 없는 결정

아키텍트의 도구 상자에서 가장 유용한 질문은 이것입니다. 내 마음을 바꾸는 데 얼마나 비용이 드는가? 어떤 결정은 양방향 문입니다. 로그 형식, 내부 함수 시그니처, 캐시 TTL. 이런 것들은 오후 한나절이면 되돌릴 수 있습니다. 다른 결정은 일방향 문입니다. 외부 클라이언트가 연동하는 공개 API 계약. 여섯 달치 운영 데이터가 쌓인 데이터베이스 스키마. 여러분의 법적 입장이 의존하는 동의 흐름. 일방향 문을 한번 통과하면, 재고하는 비용은 리팩터링이 아니라 마이그레이션, 지원 중단 일정, 그리고 사과문입니다.

만들기 전에 문의 종류를 분류하세요. AI 덕분에 만드는 건 저렴해졌지만, 되돌리는 비용은 여전히 비쌉니다. 제약 없이 두면 어시스턴트는 기꺼이 데이터 모델을 대신 설계해 줍니다. 그리고 그 실패 모드는 중복 테이블, 중복 컬럼, 마이그레이션 코드 위에 쌓인 마이그레이션 코드입니다. 프롬프트마다 모델을 재고하지 않고 테이블을 하나씩 추가하기 때문이죠. 세 서비스가 읽고 있는 실제 데이터가 든 테이블을 삭제하는 것은 업계에서 가장 괴로운 작업 중 하나입니다. 스키마 생성이 싸졌기 때문에 오히려 스키마에는 비싼 고민을 들여야 합니다. 숙고 예산은 코드를 작성하는 데 걸리는 시간이 아니라 되돌릴 수 없는 정도에 비례해서 써야 합니다. 그 비율은 이미 뒤집혔습니다.

제가 쓰는 원칙은 이렇습니다. 결정이 재생성할 수 없는 데이터나 팀 밖의 누군가가 의존할 인터페이스에 닿아 있다면, 구현을 시작하기 전에 ADR을 쓰고 두 번째 눈의 검토를 받습니다. 나머지는 일단 배포하고 반복 개선합니다. 이 원칙은 1인 프로젝트에서 플랫폼 팀까지 수정 없이 확장되며, 빠르게 움직이는 것과 떠날 수 없는 방향으로 빠르게 움직이는 것의 차이를 만듭니다.

아키텍트처럼 요구사항에 반론하기

아키텍트 직무의 가장 불편한 핵심은 자기보다 직급이 높은 사람에게 “아니요”라고 말하는 것입니다. “누가 설치했는지 로그로 남겨라”는 요구사항처럼 들렸지만, 실제로는 “설치를 측정하고 신규 사용자에게 후속 조치를 한다”는 목표에 대해 누군가 미리 상상해 둔 해결책이었습니다. 아키텍트는 해결책을 다시 목표로 번역하고, 그 목표에 도달하는 더 저렴한 길을 제안합니다. 그 번역이 이 일의 전부입니다. 도구는 그렇게 하지 못합니다. 도구의 설계 자체가 순응하는 것이니까요. 어떤 엔지니어는 어시스턴트에게 사용자 맥락을 잔뜩 넣어 꽤 괜찮은 판단을 얻기도 합니다. 그건 가장자리에서 도움이 되지만, 모델은 여전히 회의실에 들어가 마케팅팀에게 설치 시점에는 후속 이메일이 나가지 않는다고 말해주지는 못합니다.

  1. 해결책이 아니라 목표를 되돌려 말하기: “설치를 측정하고 신규 사용자에게 도달하고 싶습니다.”
  2. 더 저렴한 길과 그것이 제공하는 것을 제안하기: 타임스탬프 로깅으로 설치는 완벽하게 측정됩니다.
  3. 비싼 길이 실제로 드는 비용을 명확히 하기: 동의 마찰, 결합된 설치 경로, 마케팅이 쓸 수 없는 행들.
  4. 실질적인 선택지를 주기: “이메일이 중요하다면 환영 화면에서 물어봅니다. 하루 만에 할 수 있는 버전이 이겁니다.”
  5. 결정된 내용을 적어두기. 다음 사람이 처음부터 다시 따지지 않도록.

이제 정직한 반론을 다룰 차례입니다. 아무도 승진하지 않았을 수 있습니다. 더 그럴듯한 이야기는, 여러분이 같은 연봉에 재미있는 부분은 줄고 모델이 내린 결정의 책임을 떠안는 자리가 되어가고 있다는 겁니다. 그 말이 틀렸다고 생각하지 않습니다. 오히려 문서화 습관을 건너뛰지 말고 진지하게 받아들여야 할 이유라고 봅니다. ADR 기록은 곧 종이 기록이기도 합니다. 결정한 사람이라는 위치는 추론을 보여줄 수 없을 때만 책임이 됩니다. “플랫폼이 신원 데이터를 제한하므로 이메일 수집 대신 타임스탬프를 택했다”고 적어둔 사람은 보호받습니다. 어시스턴트가 내놓은 것을 그냥 병합한 사람은 그렇지 못합니다.

개발자 vs 아키텍트: 언제 누가 이기나

이건 순위가 아니라 모드 전환입니다. 중요한 건 눈앞의 작업이 어떤 모드를 필요로 하는지 아는 기술입니다. 제 백로그에서 나온 구체적인 사례들입니다:

  • 명확하게 정의된 버그 수정, 영향 범위를 알 때: 개발자 모드가 이깁니다. 재현하고, 수정하고, 테스트하고, 배포하세요. 여기서 아키텍처 고민은 미루기일 뿐입니다.
  • 수요를 검증하는 프로토타입: 개발자 모드. 작동하면 다시 쓰고, 안 되면 지웁니다. 일회용 코드에 ADR을 쓰는 건 낭비입니다.
  • 요구사항이 모호한 신규 그린필드 기능: 최소 한 시간이라도 아키텍트 모드를 먼저. AI가 만든 추진력이 가장 큰 피해를 주는 곳이 모호함입니다.
  • 돈, 신원, 동의에 닿는 모든 것: 예외 없이 아키텍트 모드. 구현과 되돌리기 사이의 비용 비대칭이 여기서 가장 심합니다.
  • 실시간 데이터의 스키마 변경이나 공개 API 변경: 되돌림 원칙에 따라 ADR을 갖춘 아키텍트 모드.
  • 2인 팀, 6개월 미만의 코드베이스: 진행 노트 파일을 둔 개발자 모드. 아직은 전체 의식이 아무것도 사주지 않습니다.
  • 규제 도메인이나 여러 소비 팀이 있을 때: 기록을 갖춘 아키텍트 모드. “왜”라는 질문은 친구가 아니라 감사관과 낯선 사람이 하게 되니까요.

두 방향 모두에서 실패하는 방식은 한 모드에 머무는 것입니다. 모드를 올리지 못하는 개발자는 잘못된 것을 우아하게 구현합니다. 모드를 내리지 못하는 아키텍트는 존재하지 않는 시스템의 다이어그램을 만듭니다. 팀에서 잃고 싶지 않은 사람들은 같은 오후에 두 가지를 모두 하는 사람들입니다. 오전 10시에는 데이터 모델을 논쟁하고, 오후 2시에는 불평 없이 off-by-one 오류를 고치는 사람이요. AI 산출물을 중심으로 리뷰 프로세스를 짜고 있다면 에이전틱 코딩 도구가 루프, 컨텍스트, 권한을 어떻게 구성하는지를 읽어볼 만합니다. 모드 전환은 그 루프 이후가 아니라 루프 안에서 일어나야 하니까요.

AI는 잘못된 것을 높은 속도로 영원히 기꺼이 만들어 낼 겁니다. 아키텍트의 일은 무엇이 옳은지 결정하고, 추론이 사라지기 전에 그 이유를 적어두는 것입니다.

글로우 연결선이 그려진 도형들이 있는 청사진이 노트북 옆에 펼쳐져 있다.
아키텍처란 누군가 선을 그리기 전에 어떤 선이 존재해도 되는지 정하는 일입니다.

추천: 승진을 받아들이세요

제 입장은 “상황에 따라 다르다”가 아닙니다. 데이터 모델, 외부 계약, 보안 태세에 닿는 것은 기본값으로 아키텍트 모드를 쓰고, 격리된 나머지는 개발자 모드에 머무르세요. 비율이 50/50일 리 없습니다. 대부분의 엔지니어에게는 여전히 20%는 설계, 80%는 구현입니다. 변한 것은 구현이 빨라졌고, 그 20%를 건너뛰는 비용이 속도 배수만큼 커졌다는 점입니다. 타이핑을 더 많이 위임할수록 여러분의 가치는 위임할 수 없는 부분에 더 집중됩니다.

시작 키트는 습관 세 가지입니다. 이번 주에 모두 도입할 수 있어요. 첫째, 저장소에 ADR 템플릿을 넣으세요. 맥락, 결정, 대안, 결과를 담은 반 페이지짜리 형식이면 충분합니다. 실제 트레이드오프를 받아들일 때마다 하나씩 쓰세요. 둘째, 모든 에픽에 2분짜리 결합도 점검을 추가하세요. 이것이 무엇을 호출하고, 무엇이 이것을 호출하며, 그것들이 실패하면 무엇이 깨지는지. 셋째, 티켓 템플릿에 되돌림 질문을 넣으세요. “이게 틀렸다면, 생각을 바꾸는 데 얼마나 비용이 드나?” 답이 “마이그레이션과 사과문”이라면 속도를 늦추세요. “오후 한나절”이라면 그냥 가세요.

코딩 일자리가 사라지는 게 아닙니다. 타이핑 일자리가 사라지는 겁니다. 둘은 원래 같은 것이 아니었습니다. 조용히 불안해하는 사람들은 역할이 조용히 줄어들어 티켓을 문법으로 번역하는 일이 되어버린 사람들입니다. diff를 읽으면서 “이게 왜 신원 API에 결합되어 있지?”라고 묻고 있다면, 여러분은 이미 아키텍트의 일을 하고 있었습니다. 달라진 건 이제 그것이 공식적이고, 문서화되고, 여러분의 것이라는 점뿐입니다. 승진을 받아들이세요.