받은편지함 속의 아키텍처: 주간 팀 다이제스트 출시

저희 Payment 서비스의 drift 점수는 6주째 오르고 있습니다. ADR 두 개가 리뷰를 기다리며 열려 있습니다. 월요일에 high severity 컴플라이언스 위반이 발생했습니다. 새로운 Inventory 서비스는 아직 존재하지도 않는 팀에 할당되었습니다.

제가 이 모든 것을 아는 이유는 오늘 아침 archyl에 로그인해서 다섯 페이지를 클릭했기 때문입니다.

해당 팀의 엔지니어 대부분은 그 어떤 것도 모릅니다.

이번 주 우리가 해결하기로 한 문제가 바로 이것입니다. 아키텍처 인사이트 — drift, 컴플라이언스, ADR, 결정사항, 토론 — 는 archyl에 모두 존재합니다. 인덱싱되어 있고, 계산되어 있고, 대시보드에 노출되어 있습니다. 하지만 그것을 가장 필요로 하는 사람들은 코드에 집중하고 있지, 대시보드를 새로고침하고 있지 않습니다. 그래서 인사이트는 그대로 머물고, 아키텍처 결정은 계속 진공 속에서 이루어집니다.

오늘 Team Architecture Digest 를 출시합니다. 각 팀의 아키텍처 상태를 그것을 소유한 팀의 받은편지함으로 가져다주는 정기 이메일. 주간, 격주, 월간. 팀이 선택합니다.

대시보드는 진다. 받은편지함이 이긴다.

GitHub가 2026년에도 풀 리퀘스트 알림 이메일을 계속 보내는 데에는 이유가 있습니다. Linear가 일일 다이제스트를 보내는 데에도 이유가 있습니다. 모든 분석 도구에 "weekly summary" 옵션이 있는 데에도 이유가 있습니다.

사람들은 끌어오지 않습니다. 도착하는 것을 스캔합니다. 열어야 한다는 것을 기억해야 하는 대시보드는 열기를 잊는 대시보드입니다.

10년간 우리는 "Slack과 대시보드가 이메일을 죽였다"고 들어왔습니다. 하지만 대시보드는 무엇을 찾는지 알 때 작동하고, Slack은 반응해야 할 때 작동합니다. 둘 다 "이번 주에 중요했던 모든 것, 2분 안에" 에는 좋지 않습니다 — 이것이야말로 엔지니어링 팀이 미팅으로 만들지 않으면서 아키텍처에서 정렬을 유지하기 위해 필요한 것입니다.

이메일은, 아이러니하게도, 올바른 서피스입니다. 조용하고, 밀도 있고, 아카이브 가능하고, 검색 가능하고, 전달 가능합니다. 그리고 모든 팀에는 이미 메일링 리스트가 있습니다.

다이제스트에 무엇이 있나

각 팀의 다이제스트는 해당 팀이 소유한 프로젝트로 스코프됩니다. 무관한 것은 없고, 다른 팀의 경계에서 온 것도 없습니다.

내부에는 최대 7개의 섹션 — 팀이 어떤 것을 유지할지 선택합니다:

• 아키텍처 헬스 — 이전 기간 대비 delta가 있는 drift 점수, 컴플라이언스 통과율, 배포 횟수, 리드 타임, MTTR. DORA 스냅샷을 한 줄로.
• 아키텍처 변경 — 추가, 업데이트, 제거된 C4 요소. 톱 아이템.
• 결정사항 (ADR) — 제안된 것과 머지된 것.
• 풀 리퀘스트 — 상태별 Architecture Change Requests.
• 컴플라이언스 — severity 표시된 새 위반사항.
• 토론 — 아키텍처 요소에 열린 새 댓글 스레드. "지금 무엇이 토론되고 있는가" 뷰.
• 인사이트 — 해당 기간에 생성된 아키텍처 인사이트.

활동이 없는 섹션은 조용히 생략됩니다. 절반만 채워진 이메일은 없습니다.

렌더는 평범한 HTML입니다. 트래킹 픽셀 없음, 마케팅 chrome 없음. 흰 배경에 검정, 모노크롬, 상단에 archyl 워드마크 — 트랜잭션 이메일은 캠페인이 아닌 Linear나 Vercel처럼 보여야 하기 때문에. 클라이언트가 prefers-color-scheme 를 지원하면 다크 모드가 자동으로 전환됩니다.

설정은 15초

팀 설정을 열고 Digest 탭으로 이동. 팀 이메일을 입력. 주기, 요일, 시간, 그리고 팀이 실제로 살고 있는 타임존을 선택. 섹션 체크. 저장.

아무것도 보내지 않고 앱에서 이메일을 미리보기 할 수 있고, 설정된 주소로 테스트 이메일 한 통을 보내 스케줄링을 활성화하기 전에 전달 가능성과 렌더링을 확인할 수 있습니다.

스케줄러는 매시간 실행되어 각 팀의 다이제스트를 설정된 로컬 시간에 발송합니다. Asia/Seoul 의 월요일 오전 9시로 설정된 주간 다이제스트는 서울 시간 오전 9시에 도착합니다 — 서울이 일광절약시간이든, self-hosted 인스턴스가 America/Los_Angeles 에서 돌아가든. 각 다이제스트는 소유 팀의 시계를 따릅니다.

왜 이것이 중요한가

아키텍처는 팀의 자산입니다. 집단적으로 소유되며, 소유자 중 누군가가 코드를 ship할 때마다 진화합니다. 가장 어려운 문제는 아키텍처를 캡처하는 것이 아닙니다 — 다이어그램, ADR, drift 감지, 그것은 우리가 수년간 해온 일입니다. 가장 어려운 문제는 아키텍처가 말하는 것과 팀이 아는 것 사이의 루프를 닫는 것 입니다.

주간 다이제스트는 단순하지만 드문 일을 합니다: 매주 팀에게 자신의 아키텍처에 대해 같은 페이지에 있을 5분의 단일한 순간을 제공합니다. 스탠드업 없음. 열어야 할 도구 없음. 만들어야 할 습관 없음. 모두가 이미 읽는 이메일뿐.

엔지니어링 매니저라면, 그 순간은 금입니다. 팀의 엔지니어라면, 아키텍처 컨텍스트가 쫓아가지 않고 당신에게 오는 첫 순간입니다.

지금 이용 가능

Team Architecture Digest는 모든 팀에서 활성화되어 있습니다. 팀 설정을 열고 Digest 탭을 클릭하세요. 다음 스케줄된 tick에 첫 리캡이 발송됩니다.

팀의 의견을 알려주세요. 받은편지함보다 채팅을 선호하는 조직을 위한 Slack과 Teams 동등 기능을 이미 프로토타입 중입니다 — 하지만 주간 케이던스에서는, 받은편지함이 노이즈가 되지 않고 컨텍스트를 전달하는 서피스라고 확신합니다.

아키텍처가, 마침내, 그것을 소유한 사람들이 실제로 살고 있는 곳에.

아키텍처 컨텍스트가 엔지니어링 팀 안을 어떻게 흐르는지 더 깊이 알아보고 싶으신가요? C4 모델에 풀 리퀘스트 워크플로우를 적용한 Architecture Change Requests 를, 또는 자신의 스택에 대해 무엇이든 질문하고 자신의 모델에 기반한 답을 얻는 Architecture Chat 을 읽어보세요.