"왜 멀티테넌시를 row-level로 했어요?" — 결정한 사람이 퇴사한 뒤에도 회의록에서 그 결정의 원문과 개정 이력을 찾는다

무엇이 쌓여 있나

5년치가 마크다운으로 다 남아 있고, 검색도 된다. 검색이 돌려주는 것은 '멀티테넌시'라는 글자가 들어간 줄의 목록이다. 그중 어느 줄이 결정이고 어느 줄이 의견인지는 목록에 적혀 있지 않다.

• 주간 엔지니어링 회의록 200여 장 — 2021년 3월부터 매주 한 장. 대부분 첫 줄에 날짜가 적혀 있다.
• 아키텍처 결정 문서 30여 장 — docs/adr/ 아래. 배경·선택지·결정·결과 순서로 쓰다가 2023년쯤부터 형식이 흐트러졌다.
• 슬랙 논의 발췌 60여 장 — 스레드를 통째로 복사해 붙인 노트. 대화 날짜가 안 적힌 것이 30여 장이다.
• 워크스페이스 전체 마크다운 4,000여 장 — 위 세 종류 말고도 온보딩 문서, 회고, 스펙 초안이 섞여 있다.
• 퇴사자 3명의 문장 — 결정을 실제로 내린 사람들의 말이 회의록 본문에 그대로 남아 있다.

지금은 이렇게 한다

CTO의 현재 절차는 이렇다. 슬랙에서 '멀티테넌시'를 검색하고, 결과 400여 개를 위에서부터 훑으며 결정처럼 보이는 메시지를 찾는다. 그다음 docs/adr/를 열어 관련 있어 보이는 문서를 연다. 이름이 adr-011-tenancy.md인데 2021년에 쓰였고, 그 뒤에 이 결정이 바뀌었는지는 그 문서 안에 적혀 있지 않다.

깨지는 지점은 두 곳이다. 첫째, 검색 결과에서 "스키마 분리가 나을 것 같은데"와 "결정: row-level로 간다"가 같은 무게로 나온다. 둘째, 2023년 6월 회의에서 엔터프라이즈 고객 3개사만 별도 스키마로 빼기로 한 예외가 회의록 어딘가에 있는데, 2021년 ADR 문서에는 그 흔적이 없다. 그래서 새 엔지니어는 폐기된 결정을 최신인 줄 알고 읽는다.

18개월 전에도 같은 질문을 받았어요. 그때 사흘 걸려 찾아낸 답을 어디에 적어 뒀는지가 지금 또 기억이 안 나고요.

이렇게 준비한다

새로 쓸 문서는 없다. 이미 있는 마크다운 290여 장을 넣고, 이 팀이 쓰는 용어를 한 번 가르친다.

이렇게 묻는다

"멀티테넌시 관련해서 우리가 내린 결정 다 찾아줘. 최신 순으로."
→ 결정 6건. 2025-03 "엔터프라이즈 3개사는 별도 스키마로 뺀다"부터
   2021-11 "테넌트 분리는 row-level로 간다"까지.
   각 줄에 말한 사람과 해당 회의록으로 가는 링크.

"그중에 나중에 뒤집힌 거 있어?"
→ 2건. 2021-11 결정은 취소선에 "대체됨" 배지,
   "아키텍처 회의 (2023-06)에서 대체됨" 링크가 그 회의록을 연다.
   2022-08 "커넥션 풀은 테넌트당 하나" 결정도 2024-01에 대체됨.

"row-level로 가면서 우리가 포기한 게 뭐라고 적혀 있어?"
→ 주장 4건, 입장 2건. "격리 감사 요구가 들어오면 못 버틴다" — 재호,
   반대 배지. "마이그레이션 비용이 스키마 분리의 1/5" — 지훈, 찬성 배지.

이 답이 가능한 이유는 두 가지다. 하나, 추출이 회의록을 읽을 때 저자의 문장 자체를 붙잡아 둔다. row-level 테넌시 엔티티 페이지의 "당신의 표현으로" 섹션에 결정·질문·주장·인용이 종류별로 모여 있다. 퇴사한 재호의 말에는 재호가 한 말이라는 출처가, 입장에는 찬성/반대 배지가 붙어 있다.

둘, 근거를 바로 확인할 수 있다. 엔티티 페이지에서 연결 칩에 마우스를 올리면 그 사실을 말한 원문 문장이 "아키텍처 회의 (2023-06).md · 14번째 줄" 형식으로 인용된다. 답에 붙은 노트 링크를 누르면 원본 회의록이 열린다. 새 엔지니어가 읽는 것은 CTO가 다시 쓴 요약이 아니라 2021년 회의록에 재호가 실제로 친 문장이다.

무엇이 달라지나