설계 결정을 영어로 적을 때, "우리는 A를 골랐습니다"로 끝내면 반은 날아갑니다

ADR(Architecture Decision Record)을 영어로 처음 써 본 사람은 대개 한 문단으로 끝냅니다. "We chose PostgreSQL over MongoDB." 선택을 적었으니 기록은 끝났다고 생각하죠. 그런데 반년 뒤 새 팀원이 그 문서를 열면 물어봅니다. "왜 Mongo는 안 됐어요?" 그때 작성자는 기억이 안 나고, 문서엔 그 답이 없습니다.
ADR의 핵심은 '무엇을 골랐나'가 아니라 '어떤 저울질 끝에 골랐나'입니다. 한국어로는 머릿속에서 자연스럽게 트레이드오프를 떠올리는데, 영어로 옮기는 순간 결론만 남고 근거가 사라집니다. 동사를 결정의 세기에 맞게 못 고르거나, 버린 선택지를 설명할 문장 틀이 없어서예요.
오늘은 설계 결정 기록과 장애 보고서를 영어로 쓸 때 '판단의 경로'를 남기는 다섯 가지 장면을 봅니다. 결론 한 줄이 아니라, 반년 뒤의 나와 새 팀원이 다시 판단할 수 있게 쓰는 방법입니다.
선택지를 "버렸다"가 아니라 "어떤 조건에서 밀렸다"로
가장 흔한 실수는 버린 선택지를 한 단어로 처리하는 겁니다. "We didn't use Kafka." 이러면 Kafka가 나빠서인지, 지금 상황에 안 맞아서인지 구분이 안 됩니다. 반년 뒤 트래픽이 10배가 되면 이 결정은 다시 열려야 하는데, 문서에 그 조건이 없으면 아무도 다시 안 엽니다.
before는 "Kafka는 복잡했다"는 과거의 단정으로 읽힙니다. was too complex는 Kafka 자체에 대한 평가처럼 굳어지죠. after는 두 가지를 바꿨습니다. 첫째, ruled out ... for now는 "지금은 뺐다"는 조건부 결정입니다. 둘째, isn't justified at our current volume은 뒤집힐 수 있는 기준을 명시합니다. message volume이 올라가면 이 문장이 그대로 재검토 신호가 됩니다. 영어에서 설계 결정은 과거형 단정(was)보다 조건을 품은 현재형(isn't justified at ...)으로 쓸 때 다시 읽을 수 있는 문서가 됩니다.
be 동사로 상태를 쓸지, do 동사로 행동을 쓸지
ADR에서 "이 방식은 성능이 좋습니다"를 쓸 때 많은 분이 This approach is better performance처럼 be 동사에 명사를 얹습니다. 문법이 어긋나고, 무엇보다 '무엇을 더 잘하는지'가 사라집니다. 성능은 상태가 아니라 동작의 결과거든요.
before는 is a better performance, is a less memory처럼 be 동사 뒤에 어색한 명사가 붙었습니다. performance나 memory는 그 자체로 상태를 나타내는 말이 아니라서 be와 잘 안 붙어요. after는 동작 동사로 바꿨습니다. handles peak load는 "최대 부하를 처리한다", consumes more memory는 "메모리를 더 쓴다". 둘 다 무엇을 어떻게 하는지가 보입니다. 그리고 but 하나로 트레이드오프가 한 문장에 담겼습니다. 지연시간은 낮지만 메모리는 더 쓴다. ADR이 노려야 할 바로 그 저울질입니다. be는 "~이다"라는 상태, do는 "~한다"는 행동. 성능과 자원 소비는 거의 항상 행동 쪽입니다.
장애 보고서의 시제 — 끝난 일, 여전한 일, 할 일을 가르기
장애 보고서를 영어로 쓸 때 전부 과거형으로 밀어버리는 경우가 많습니다. The service was down, we fixed it. 그런데 독자는 세 가지를 따로 알고 싶어 합니다. 무엇이 끝났나(과거), 무엇이 아직 남았나(현재완료/현재), 무엇을 할 건가(미래). 시제를 안 나누면 "다 해결됐다"로 읽혀서, 남은 리스크가 묻힙니다.
before는 모든 걸 과거로 덮고 Everything is fine으로 닫았습니다. 읽는 사람은 종료된 사건으로 받아들이죠. after는 시제로 상태를 구분합니다. became overloaded, restarted는 과거의 완결된 사건. has recovered는 현재완료로 "회복돼서 지금도 그 상태". 그리고 haven't yet addressed는 현재완료 부정으로 "아직 안 끝난 일"을 분명히 남깁니다. yet 하나가 "근본 원인은 미제"라는 신호입니다. 장애 보고서에서 시제는 단순한 문법이 아니라, 어디까지 안전하고 어디부터 위험한지를 나누는 선입니다.
근거의 세기를 동사로 조절하기 — 측정한 것과 추정한 것
연구직이나 PM이 특히 조심할 지점입니다. ADR에 "이게 더 빠를 겁니다"를 쓸 때 측정해서 아는 건지, 경험상 추정하는 건지가 섞입니다. 영어로는 둘 다 will be faster로 뭉개기 쉬운데, 그러면 측정값과 직감이 같은 무게로 읽혀서 나중에 신뢰가 깨집니다.
before는 will make it faster, maybe 10x처럼 측정과 짐작이 한데 섞였습니다. maybe가 붙었지만 10x라는 숫자가 사실처럼 떠버리죠. after는 둘을 분리합니다. cut p95 latency from 800ms to 90ms는 과거형 사실 동사로 "측정했다"는 확정. We expect similar gains, though ... may differ는 추정의 영역으로 세기를 낮춥니다. expect는 will보다 약하고, may differ는 조건까지 달아둡니다. 이렇게 쓰면 독자는 어디까지가 데이터고 어디부터가 당신의 판단인지 압니다. 근거의 세기를 동사로 조절하는 건, 신뢰를 지키는 가장 싼 방법입니다.
"되돌릴 수 있나"를 관사와 명사로 분명히 하기
좋은 ADR은 결정을 어떻게 뒤집는지도 적습니다. 그런데 이 부분을 영어로 쓸 때 관사와 명사 단수·복수에서 자꾸 뭉개집니다. "롤백 계획이 있습니다"를 we have rollback plan으로 쓰면 어색하고, "이 결정은 되돌리기 어렵다"를 막연히 적으면 얼마나 어려운지가 안 보입니다.
before는 hard to change later로 막연하고, rollback plan에 관사가 빠졌습니다. plan은 셀 수 있는 명사라 하나의 계획을 가리킬 땐 a rollback plan이 맞습니다. 관사가 없으면 원어민에게 문장이 미완성으로 들려요. after는 두 가지를 분명히 합니다. a one-way door는 "되돌리기 극히 어려운 결정"을 가리키는 업계 관용 표현이고, require a full data backfill로 되돌림 비용을 구체적으로 적었습니다. 결정적으로 마지막 문장이 배포 롤백은 되지만 스키마 변경은 안 된다고 범위를 갈라줍니다. 되돌릴 수 있는 것과 없는 것을 섞지 않는 것, 그게 ADR을 반년 뒤에도 쓸모 있게 만듭니다.
지금까지 본 다섯 문장은 전부 같은 원리를 공유합니다. 결론만 적지 말고, 그 결론에 이른 저울질과 조건을 남기는 것. 버린 선택지의 조건, 트레이드오프, 끝난 일과 남은 일, 측정과 추정, 되돌림 비용. 영어로 이걸 다 담으려면 문장 틀을 몸에 익혀야 하고, 그건 한 번 읽어서는 안 붙습니다.
이런 문장은 직접 써 보면서, 왜 ruled out for now인지, 왜 cut인지 do인지를 한 번씩 짚을 때 내 것이 됩니다. 오늘 ADR을 한 건 연다면, 결론 뒤에 "왜 다른 건 밀렸는지" 한 문장만 더 붙여 보세요. 그 한 문장이 반년 뒤의 당신을 구합니다.