X가 기존 웹 애플리케이션을 5명의 엔지니어와 AI 코딩 에이전트 를 활용해 6개월 이내에 재구축함. 기존의 사용자·검색 크롤러·링크 미리보기용 서버 3개를 하나로 통합했으며, 비로그인 서비스 전환을 완료하고 로그인 서비스도 국가별로 순차 전환 중임
기존 React 기반 클라이언트 렌더링 은 HTML 셸과 JavaScript를 다운로드·실행한 뒤 GraphQL 데이터를 요청해야 했음. 새 구조는 스트리밍 서버 렌더링(SSR) 으로 첫 응답부터 실제 콘텐츠를 전달하고, 서버에서 가져온 데이터를 브라우저가 재사용하도록 변경함
느린 네트워크의 로그인 프로필 테스트에서 첫 게시물 표시 시간이 23.9초에서 2.7초 로 단축됨. 별도 벤치마크에서는 프로필·게시물이 813배 빨리 표시됐으며, 페이지 전체의 압축 JavaScript 다운로드량도 4.14.8MB에서 1.3~2.3MB로 감소함
개발팀은 AGENTS.md, 25개 이상의 에이전트 스킬, 커스텀 린트 규칙 으로 AI 생성 코드를 관리함. 엔지니어가 아키텍처와 요구사항을 결정하고 모든 변경을 검토하는 동안, 에이전트가 기존 동작 이식·페이지 변환·테스트 작성·CI 오류 수정을 수행함
대규모 재작성의 위험을 줄이기 위해 기존 서버를 동작 명세이자 비교 기준 으로 활용하고, 검색 크롤러부터 비로그인 사용자, 로그인 사용자 순서로 트래픽을 이전함. 기존 서비스와 새 서비스를 병행 운영하면서 문제가 발생하면 즉시 되돌릴 수 있도록 구성함
기존 X.com 아키텍처와 재구축 배경
X.com의 기존 웹 애플리케이션인 rweb(responsive web) 은 2017년 Twitter Lite 에서 시작됨
느린 연결을 위한 Progressive Web App으로, React 클라이언트와 HTML 셸을 반환하는 소형 Node.js 서버로 구성됨
2019년 새 Twitter.com 의 기반이 되면서 모든 기기를 하나의 반응형 코드베이스로 지원함
시간이 지나면서 서로 다른 용도의 서버 3개가 운영됨
rweb : 로그인·비로그인 사용자를 위한 브라우저 렌더링
rweb SSR : 검색 크롤러용 서버 렌더링과 URL 정리
Jetfuel SSR : 이벤트, Spaces, Communities, Trends, 검색, 뉴스 등 검색엔진이 색인하는 비로그인 페이지 렌더링
하나의 URL을 세 가지 방식으로 생성하면서 유지보수 비용과 동작 불일치가 발생함
SEO 수정 사항이 일부 서버에만 반영될 수 있음
비로그인 사용자는 HTML 셸 → JavaScript 다운로드 → 실행 → GraphQL 요청 → 렌더링의 순서를 거쳐야 함
검색 크롤러는 완성된 HTML을 받지만 실제 비로그인 사용자는 가장 느린 경로를 사용함
기존 기술 스택은 Redux 정규화 저장소, Relay, React Native for Web, Flow, 최신·레거시 번들 등이 누적되면서 일상적인 변경과 성능 관리가 어려워짐
점진적 개선 대신 전면 재작성 선택
세 가지 대안을 검토한 뒤 새 애플리케이션 구축을 선택함
기존 rweb 개선: 세 서버가 그대로 남고 비로그인 SSR을 추가하려면 네 번째 렌더링 경로가 필요함
Webpack·Babel을 Vite로, Flow를 TypeScript로, Express를 Fastify로 교체: 대부분의 파일을 수정해야 하지만 근본적인 아키텍처 문제는 남음
단일 서버로 재구축 : 기존 서비스를 계속 운영하면서 트래픽을 점진적으로 이전하고 두 SSR 서버를 통합함
Joel Spolsky의 전면 재작성에 대한 경고 를 고려해 기존 제품 개발을 중단하지 않고 병행 운영함
기존 시스템에서 검증된 설계와 동작은 유지함
모든 기기를 지원하는 단일 반응형 코드베이스
GraphQL과 Relay 기반 데이터 접근
기존 URL, 리다이렉트, 별칭, URL 정리 규칙
구조화 데이터, 언어별 대체 URL, 실제 404 응답
링크 미리보기 이미지의 픽셀 단위 호환성
새로운 기술 스택
Vite : Rolldown으로 클라이언트·서버 번들을 생성하고, 로그인·비로그인용 진입점을 분리해 불필요한 코드 다운로드를 방지함
React : 서버·브라우저 렌더링에 스트리밍 SSR과 Suspense를 사용함
Fastify : 모든 요청과 HTML 스트리밍을 처리하며, 자체 @x-clients/server
패키지가 보안 헤더·쿠키·메트릭·정상 종료를 구성함
Platformatic Watt : Node.js v26에서 단일 프로세스의 여러 워커 스레드를 운영하고, 이벤트 루프나 메모리 한도를 지속적으로 초과하는 워커를 교체함
Relay + GraphQL : 컴포넌트별 데이터 요구사항 선언, 데이터 요청 및 캐싱을 담당함
XDS : Base UI와 Tailwind CSS를 기반으로 만든 40개 이상의 공통 UI 컴포넌트 라이브러리로, 다른 X 웹 애플리케이션 5개에서도 사용함
TypeScript + Tailwind CSS : 타입과 스타일을 관리하며, 타입 검사는 TypeScript 컴파일러의 Rust 포트인 tsrs
로 수행함
하나의 서버에서 사용자 유형별 응답 생성
사용자에게는 스트리밍 HTML
서버가 페이지 셸을 먼저 전송하고, 데이터가 도착하는 대로 각 영역의 HTML을 스트리밍함
서버가 수신한 GraphQL 응답을 페이지에 JSON 텍스트로 한 번만 포함함
브라우저는 빈 Relay 저장소에서 시작해 해당 응답을 재생하므로 동일한 데이터를 API에 다시 요청하지 않음
검색 크롤러에게는 완성된 HTML
검증된 검색 크롤러에는 모든 Suspense 경계가 해결된 완전한 HTML 문서를 전달함
구조화 데이터와 언어별 대체 링크를 포함하지만, 하이드레이션이 필요 없으므로 클라이언트 번들·라우터 상태·JavaScript용 플레이스홀더는 제외함
User-Agent 대신 엣지에서 검증한 IP 주소 로 검색 크롤러를 구분함
User-Agent를 기준으로 하면 Lighthouse 같은 성능 측정 도구도 버퍼링된 응답을 받게 됨
임의의 사용자가 헤더를 변경해 비용이 높은 크롤러용 렌더링을 요청할 수도 있음
검증되지 않은 크롤러는 일반 비로그인 사용자와 동일한 응답을 받음
링크 미리보기 봇에는 메타데이터만
Slack, Discord, iMessage, WhatsApp, Signal, Telegram 등 링크 미리보기 봇에는 제목·설명·카드 이미지만 반환함
페이지 본문 렌더링을 건너뛰고 타임라인·대화 데이터 요청도 생략함
링크 카드 PNG 생성 서비스도 JavaScript에서 Rust 로 재작성함
기존 서비스는 코어 활용을 위해 메모리를 공유하지 않는 인스턴스를 늘려야 했고, 장애 상황에서 응답에 약 2분이 걸린 사례가 있음
게시물, 미디어 미리보기, 구독, cashtag 차트, Money 등의 기존 경로를 유지함
기록·재생 테스트와 기존 서비스 비교 테스트로 이미지의 픽셀 단위 일치 여부를 확인함
데이터 로딩과 클라이언트 탐색
모든 라우트가 필요한 데이터를 미리 선언하며, 라우트 로더 가 서버 렌더링과 함께 GraphQL 요청을 시작함
서버에서 받은 GraphQL 응답은 브라우저의 Relay 저장소에 재생되며, 아직 소비하지 않은 응답은 스트림 종료 후 30초 동안 보관함
클라이언트 탐색에서는 사용자의 방문 의도를 감지해 코드와 데이터를 미리 가져옴
일반 링크는 마우스를 올리거나 키보드 포커스가 이동하면 사전 로딩함
타임라인 게시물은 포인터가 100ms 동안 머물거나 누르면 사전 로딩함
정지된 포인터 아래로 게시물이 스크롤되는 경우에는 사전 로딩하지 않음
9월 이후 21개 라우트 가 주요 GraphQL 요청을 라우트 로더에서 시작하도록 변경됨
기존 rweb는 대규모 클라이언트 캐시 덕분에 화면 전환이 즉각적인 경우가 많았으며, 새 앱은 의도 기반 사전 로딩으로 이 차이를 줄이는 중임
AI 코딩 에이전트를 활용한 개발 방식
초기 버전은 5명의 엔지니어가 6개월 이내 에 구축했으며, 9월 말 이후 새 앱에 코드를 기여한 인원은 20명을 넘음
엔지니어가 아키텍처를 설계하고 개발 범위를 결정하며 모든 변경을 검토함
에이전트는 기존 서버 동작 이식, 페이지 변환, 테스트 작성, CI·코드 리뷰에서 발견된 문제 수정을 주로 수행함
AGENTS.md로 공통 개발 규칙 정의
저장소 루트의 AGENTS.md
에 모든 에이전트와 신규 엔지니어가 따를 규칙을 작성함
named export 사용, barrel file 금지
외부 데이터는 신뢰 경계에서 검증
작성할 가치가 있는 테스트 기준 정의
린트·타입 검사·관련 테스트 통과 전 커밋 금지
저장소에 25개 이상의 스킬 구축
반복 작업을 단계별로 정의한 스킬을 코드와 함께 관리함
커밋 작성, PR 생성·스태킹·리뷰
CI 통과까지 PR 관리
의존성 변경과 번역 추가
Relay 및 자체 라우터 사용
작업 방식이 바뀌면 해당 스킬 하나를 수정해 모든 에이전트에 적용함
커스텀 린트로 AI 생성 코드 품질 관리
oxlint
커스텀 플러그인으로 Relay 사용, Tailwind 클래스, 테스트, 번역 규칙을 검사함
anti-slop 플러그인 은 에이전트가 자주 생성하는 패턴을 거부함
연쇄 타입 단언
unknown
타입 매개변수
빈 객체의 조건부 전개
커밋 전 훅에서 포맷·린트·타입 검사를 실행하고, 푸시 전 훅에서는 관련 패키지를 검사함
기존 SSR 서버를 동작 명세로 사용해 에이전트가 기존 동작을 읽고 재구현한 뒤 테스트로 고정할 수 있었음
엔지니어의 작업은 직접 코드를 작성하는 것보다 시스템 동작을 결정하고 실제 브라우저에서 검증하는 일 에 더 집중하게 됨
검색 크롤러부터 국가별 사용자까지 점진적 이전
검색 크롤러 전환
기존 SSR 서버와 새 서버를 동일한 경로에 대해 비교하는 동등성 검사 스크립트(parity script) 를 작성함
검증된 Googlebot 요청으로 상태 코드, 리다이렉트, 제목, 설명, canonical URL, robots 태그, Open Graph·X 카드 태그, 언어 대체 링크 수, 구조화 데이터 유형을 비교함
이전 일정
2026년 8월 1일 : Jetfuel SSR 종료
9월 초 : rweb SSR의 모든 크롤러 트래픽을 새 앱으로 이전하고 서버 종료, rweb에서 약 36,000줄 제거
9월 중순 : Jetfuel 저장소의 서버 렌더링·이미지 서비스 코드도 삭제함
비로그인·로그인 사용자 전환
엣지가 요청 경로와 사용자 조건에 따라 기존 rweb 또는 새 앱으로 요청을 전달함
ngroutes
설정이 파일 기반 라우트 트리에서 경로를 찾아 배포할 때마다 엣지에 게시하며, 새 앱에 없는 경로는 rweb로 전달함
기능 스위치 로 배포 없이 사용자 집단을 변경하거나 기존 앱으로 즉시 복귀시킬 수 있음
비로그인 x.com은 이미 새 앱에서 서비스 중이며, 로그인 사용자는 국가별로 전환 중임
lite.x.com
에서 직원과 테스터가 로그인 기능을 먼저 검증함
NFL, MLB, 대학 미식축구 허브 등이 최근 테스트 사례임
첫 번째 국가에서는 기존·신규 앱을 실제 트래픽으로 비교하는 실험을 진행함
두 앱에서 기능 공유
Module Federation 을 이용해 X Chat을 chat.x.com
에서 런타임에 불러오므로 두 앱이 동일한 채팅 기능을 사용함
새 앱은 X Calls와 Money도 같은 방식으로 불러옴
Money에 React 등 공통 라이브러리를 공유하면서 첫 Money 페이지의 압축 다운로드량이 590KB에서 509KB 로 감소함
분석 기능과 Grok Imagine 등은 두 앱이 가져다 쓰는 공유 기능 패키지로 유지함
서버 성능 최적화
렌더링 워커 확장
10월 운영 환경 측정에서 워커 이벤트 루프 사용률은 중앙값 67%, p95 84%였음
최대 이벤트 루프 정지는 중앙값 약 1.9초, p95 약 3.7초에 달함
실제 상위 서비스가 약 25ms 만에 응답했어도 이벤트 루프 지연 때문에 1초 타임아웃이 비로그인 렌더링의 ** 19%** 에서 발생함
동일한 트래픽을 더 많은 워커에 분산해 각 이벤트 루프의 부하를 줄임
직렬 요청을 병렬화
비로그인 렌더링에 필요한 guest token과 기능 플래그를 기존에는 순차 요청했음
기능 플래그 요청에는 토큰이 필요하지 않으므로 두 요청을 동시에 시작하도록 변경함
직렬 네트워크 왕복을 하나 제거하고 토큰 요청 지연이 기능 플래그 요청을 막지 않도록 함
Relay 저장소 직렬화 제거
기존에는 서버의 정규화된 Relay 저장소와 변경 사항을 HTML에 직렬화했음
해당 레코드가 원래 GraphQL 응답보다 45배 커지는 문제가 있었음
GraphQL 응답 자체를 JSON 텍스트로 한 번만 포함하고 브라우저에서 JSON.parse
로 재생하도록 변경함
검색 크롤러 HTML을 2MB 미만으로 축소
Googlebot이 응답의 첫 2MB 만 읽는 제약으로, 2.2~3.5MB에 달하는 긴 스레드의 뒷부분이 누락됐음
세 가지 최적화를 적용함
게시물마다 반복되던 7개 동작 아이콘과 인증 배지 SVG를 공통 스프라이트로 이동해 프로필에서 165KB(14.2%), 긴 스레드에서 340KB(13.6%) 절감함
사진 구조화 데이터에서 게시물 텍스트·이미지 URL 중복을 제거해 사진이 많은 스레드에서 450KB(13.0%) 절감함
타임스탬프 스크립트, 라우터 상태, 스켈레톤 게시물, 로그인 버튼 등 크롤러에 불필요한 출력을 제거해 137개 게시물 스레드에서 54KB 절감함
브라우저 성능 최적화
스트리밍 중 즉시 하이드레이션
기존 defer
모듈은 문서 전체 파싱 후 실행되어 가장 느린 Suspense 경계까지 하이드레이션을 지연시켰음
진입 스크립트를 async
모듈로 변경해 로딩 즉시 셸을 하이드레이션하고 각 경계는 HTML 도착 시 처리함
대화 쿼리에 5초 서버 지연을 넣은 테스트에서 React 연결은 589ms , 문서 파싱 완료는 6,017ms 에 발생함
초기 JavaScript 파일 수 축소
Rolldown 기본 청크 분할에서는 로그인 진입점이 754개, 비로그인이 582개 파일을 로딩했음
Chrome의 HTTP/2 연결과 CDN의 동시 스트림 한도는 약 100개여서 여러 차례의 네트워크 왕복이 필요했음
공통 시작 모듈을 의존성·자체 코드·지연 로딩 청크 참조 코드의 세 그룹으로 묶는 빌드 플러그인을 도입함
로그인: 754개 → 182개
비로그인: 582개 → 10개
JavaScript 응답마다 275ms 지연을 추가한 실험에서 로그인 홈 타임라인 표시 시간이 6.63초 → 4.95초 로 단축됨
스타일시트 우선 다운로드
느린 네트워크에서는 JavaScript와 CSS가 대역폭을 경쟁해 렌더링을 막는 스타일시트의 다운로드가 늦어졌음
CSS 로딩 후 JavaScript 진입점과 사전 로딩을 추가하도록 변경함
페이지
변경 전 FCP
변경 후 FCP
비로그인 프로필
3,064ms
1,984ms
비로그인 게시물
7,216ms
1,804ms
대신 JavaScript 실행이 늦게 시작되며, 테스트한 느린 페이지 5개 중 2개에서 하이드레이션 완료가 각각 0.3%, 0.6% 늦어짐
다운로드 용량 축소
영어 번역 키와 값이 동일한 특성을 활용해 비로그인 영어 페이지의 번역 카탈로그 5개, gzip 기준 49.5KB 를 초기 하이드레이션 경로에서 제거함
전체 ICU 메시지 파서를 필요한 기능만 처리하는 소형 파서로 교체해 진입점당 약 8KB 절감함
사용하지 않는 Sentry 릴리스 ID가 모든 청크에 추가되던 동작을 제거해 특정 프로필에서 12.4KB 절감함
게시물 사진, 동영상 포스터, 카드 이미지를 JPEG 대비 약 절반 크기로 제공되는 WebP로 요청하도록 변경함
성능 측정과 기존 앱 비교
Lighthouse CI가 @jack 프로필 과 첫 게시물 을 데스크톱·모바일 환경에서 검사함
운영 환경에서는 Core Web Vitals의 LCP·INP·CLS와 FCP·TTFB를 기존 rweb와 동일한 제품 구분으로 perftown
에 수집함
스타일시트 변경은 페이지당 11쌍의 교차 실행을 측정하고, 95% 부트스트랩 신뢰구간이 0을 제외할 때만 변화로 판단함
2026년 11월 3일 비교 실험
동일한 로그인 계정과 캐시가 비어 있는 새 headless Chromium을 사용하고 서비스 워커를 비활성화함
각 페이지를 앱·환경별 7회 측정하며 기존·신규 앱 실행을 교차 배치함
느린 환경은 150ms 지연, 다운로드 1.6Mbps, 업로드 750Kbps, CPU 4배 감속으로 설정함
초기 화면이 로고뿐인 rweb의 FCP 대신 첫 게시물이 화면에 나타나는 시간 을 주요 지표로 사용함
로그인 페이지
기존 rweb
새 앱
개선
@SpaceX 게시물, 느린 환경
약 21.8초
1.7초
12.8배
@SpaceX 프로필, 느린 환경
약 24.6초
3.0초
8.2배
홈 타임라인, 느린 환경
24.6초
14.1초
1.7배
홈 타임라인, 제한 없음
2.2초
1.8초
1.2배
제한 없는 환경에서도 게시물은 3.2배, 프로필은 2.3배 빨랐음
홈 타임라인은 여전히 브라우저에서만 렌더링하므로 두 앱 모두 JavaScript 실행을 기다려야 하며, 개선 폭이 가장 작음
서버 응답과 JavaScript 사용량
로그인 프로필·게시물의 첫 바이트 도착 시간은 새 앱이 430560ms , 기존 rweb는 300ms 미만이었음
새 앱은 데이터 요청과 서버 렌더링을 먼저 수행하므로 첫 응답 자체는 늦지만 실제 콘텐츠를 더 빨리 보여줌
느린 환경에서 첫 게시물 표시 전 JavaScript 다운로드량
기존 rweb: 압축 기준 3.03.6MB
새 앱의 프로필·게시물: 0MB , HTML에 이미 콘텐츠가 포함됨
새 앱의 홈: 1.9MB
전체 페이지의 압축 JavaScript 다운로드량도 기존 4.14.8MB에서 새 앱 1.32.3MB로 감소함
비로그인 페이지와 운영 인프라
느린 환경에서 비로그인 @SpaceX 게시물은 1.7초, 프로필은 2.2초 만에 첫 게시물을 표시함
네트워크 제한이 없을 때는 각각 442ms와 792ms가 걸림
별도의 11월 3일 화면 녹화에서는 새 앱의 첫 게시물이 2.7초, rweb는 23.9초에 나타남
이 녹화는 CPU 감속 없이 Slow 4G 네트워크를 적용하고 각 앱의 3회 측정 중앙값을 사용함
운영 인프라에서는 데이터센터당 rweb 비로그인 인스턴스를 1,400개에서 700개 로 줄임
rweb SSR도 종료 전 2,400개에서 1,200개 로 축소했으며, 이후 완전히 종료함
모든 성능 수치는 특정 노트북의 실험실 측정이며, 실제 기기와 네트워크에서는 차이가 발생할 수 있음
재구축에서 확인한 세 가지 원칙과 향후 계획
기존 시스템을 명세로 활용
오래된 SSR 서버에 축적된 URL 처리, SEO 동작, 예외 규칙을 테스트로 이전함
기존·신규 서버를 비교하는 스크립트가 AI 에이전트의 구현 결과를 검증하는 기준이 됨
점진적 전환과 즉시 복귀
크롤러와 비로그인 페이지를 먼저 전환하고 로그인 사용자는 국가별로 이전함
기존 rweb를 계속 운영해 전환한 사용자 집단을 즉시 되돌릴 수 있도록 함
실험실 성능과 실제 사용자 성능을 함께 측정
실험실 벤치마크는 변경 효과를 비교하고, 실제 방문에서 수집한 Core Web Vitals로 운영 환경을 관찰함
로그인 x.com의 국가별 전환이 완료되면 지난 10년 가까이 서비스를 담당했던 rweb를 종료할 예정임
X는 2026년 7월에도 Android 앱을 처음부터 재구축 했음
2017년 Twitter Lite가 추구했던 느리고 불안정하거나 비용이 높은 네트워크에서의 사용성을 일반 사용자, 검색엔진, 링크 미리보기까지 하나의 웹 아키텍처로 확장함
댓글과 토론