작업 기간: 2026.10.15–10.15
2026년 10월 15일, 개인 비공개 저장소에서 만드는 디자인 시스템 3.0의 핵심을 회사 팀 사이트 DS에서도 보이게 하기로 했어요. 3.0이 사이트용 자료 파일을 내보내고, DS는 그 사본으로 페이지를 그리는 구조예요. 구조 안을 받고 제가 처음 던진 질문은 "원본을 계속 바꾸면 페이지도 자동으로 바뀌나?"였어요.
답은 "저절로는 안 바뀐다"였고, 저는 그 상태를 일부러 남겼어요. 이 글은 정본 하나와 사본 하나를 어떻게 이을지 고른 과정에 대한 기록이에요. 자동화를 어디서 멈춰야 하는지, 그 경계를 무엇으로 정했는지에 답해 보려고 해요.
보관 장소가 달라서 저절로 바뀔 수가 없었어요
처음에는 원본만 고치면 사이트가 따라올 거라고 막연히 생각했어요. AI가 짚은 첫 이유는 보관 장소였어요. 3.0은 이 Mac과 개인 GitHub 비공개 저장소에 있고, DS는 회사 GitHub에서 만들어져 배포 서비스로 나가요.
그 배포 서비스는 제 개인 비공개 저장소를 읽을 권한이 없어요. 원본이 바뀌어도 DS 쪽은 그 사실을 알 길이 없는 구조였어요. 자동으로 바뀌게 하려면 누군가 개인과 회사 사이를 건너는 길을 새로 만들어야 했어요.
고칠 때마다 반영하면 미완성 상태도 운영에 나가요
두 번째 이유가 더 중요했어요. DS는 main에 합치는 순간이 곧 운영 배포예요. 원본을 고칠 때마다 반영되면, 제가 만드는 중인 어중간한 상태까지 그대로 운영에 나가요.
그래서 반영 단위를 "고칠 때마다"에서 "알파 태그를 단 버전만"으로 바꿨어요. 3.0에는 이미 알파 번호를 붙여 검토를 마치는 절차가 있었어요. 그 절차를 통과한 버전만 나가면, DS에 보이는 건 언제나 한 번 검토한 버전이 돼요.
알파 절차는 원래 태그를 달고 개인 저장소에 올리는 데서 끝났어요. 여기에 사본 교체 PR 한 단계만 더 붙이면 되니, 새 도구를 들이지 않아도 됐어요.
편한 안보다 열쇠가 경계를 넘지 않는 안을 골랐어요
AI는 자동화 수준에 따라 세 안을 표로 냈어요. 반자동은 알파를 닫을 때 사본 교체 PR을 한 번 열고, 검사를 통과하면 머지하는 방식이에요. 알파마다 PR과 운영 배포가 하나씩 생기는 게 비용이었어요.
완전 자동은 개인 저장소에 태그만 올리면 자동 실행 기능이 회사 저장소에 PR을 열고 머지까지 해요. 대신 개인 저장소에 회사 저장소 쓰기 토큰을 넣어야 했고, 사람 확인 없이 운영에 나가요. 실시간 읽기는 DS가 페이지를 열 때마다 제 개인 검토 사이트의 자료를 읽어 오는 방식이었어요.
저는 반자동을 골랐어요. 가장 편한 건 완전 자동이었지만, 회사 저장소에 쓸 수 있는 열쇠를 개인 저장소에 두는 순간 개인과 회사의 경계가 흐려져요. 실시간 읽기는 배포가 필요 없어 빨라 보였는데, 제 개인 서버가 멈추면 회사 페이지도 같이 깨진다는 점이 걸렸어요.
완전 자동을 아주 버린 건 아니에요. 반자동을 몇 번 돌려 보고 매번 여는 PR이 번거롭다고 느껴지면, 그때 다음 단계로 올리기로 했어요. 지금 필요한 건 속도보다 사람이 한 번 보고 넘기는 지점이었어요.
사본 교체 명령은 멈출 때부터 정했어요
반자동의 핵심은 사본을 바꾸는 명령 하나예요. 3.0에서 사이트용 자료를 임시 폴더에 만들고, 형식과 버전과 개수를 검사한 뒤 DS의 사본을 통째로 바꿔요. 네트워크는 쓰지 않고 이 Mac 안에서만 돌아요.
저는 이 명령이 무엇을 하는지보다 언제 멈추는지를 먼저 봤어요. 3.0에 커밋 안 된 변경이 있으면 멈춰요. 버전 번호는 같은데 내용이 다르거나 더 낮은 버전으로 되돌리려 할 때도 바꾸지 않아요.
내용이 같으면 "변경 없음"만 출력하고 파일을 건드리지 않아요. 같은 확인은 CI에도 넣어서, PR마다 커밋된 사본의 형식과 버전을 다시 봐요. 사람이 놓쳐도 잘못된 사본은 머지 전에 한 번 더 걸러져요.
사람이 매번 들여다보지 않을 단계일수록, 이상한 상태를 조용히 넘기지 않는 게 중요했어요. 첫 사본은 3.0.0-alpha.19였고, 3.0이 만든 결과물과 바이트까지 같은 것을 확인했어요.
로그인해 달라는 부탁부터 틀렸어요
화면을 확인하는 단계에서 한 번 막혔어요. AI는 처음에 로컬 화면의 로그인 창을 열어 두고, 저에게 평소 계정으로 로그인해 달라고 했어요. 그런데 열어 보니 화면이 아예 뜨지 않았고, 제가 보낸 말은 "?? 로컬은 안뜨는데" 한 줄이었어요.
AI가 확인해 보니 이유가 두 겹이었어요. 우선 로컬 서버가 47분 전에 멈춰 있었어요. 다시 띄워도 이 Mac에는 회원 정보 서버 접속값이 없어서, 로컬 로그인은 원래 될 수 없었어요. 제가 비밀번호를 넣었어도 실패했을 거예요.
PR 미리보기 사이트로 보는 길도 있었어요. 그런데 그쪽은 배포 서비스 계정 로그인부터 요구해서, 저는 로그인을 두 번 해야 했어요. 이 길도 쓰지 않았어요.
그래서 확인 방법을 바꿨어요. 앱 코드는 건드리지 않고, 화면을 찍는 동안에만 로그인 확인 응답을 "로컬 미리보기"라는 테스트 사용자로 바꿔 끼웠어요. 찍은 뒤에는 임시 파일과 설정을 모두 지웠고, 이 방법은 버전 기록에 남겼어요.
여섯 칸의 숫자가 사본과 같은지 보고 머지했어요
새 페이지 맨 위에는 3.0의 항목 수를 보여 주는 여섯 칸이 있어요. 화면의 숫자 8, 11, 336, 52, 21, 40이 사본 파일과 같은지부터 확인했어요. 사본이 제대로 들어왔는지 가장 빨리 알 수 있는 자리였어요.
페이지는 버전과 알파 상태를 맨 위에 두고, 여섯 칸 아래로 공통 규칙과 원칙, 토큰 값표, 부품과 패턴, 변경 기록이 차례로 이어져요.
PC 1440px와 휴대폰 390px 모두 가로 넘침이 없었고, 휴대폰에서는 목차가 가로 한 줄로 바뀌었어요. 다만 페이지가 길어요. PC에서 약 24,900px, 휴대폰에서 약 39,600px인데, 3.0 자료가 많아서 생긴 길이라 목차가 따라 내려오게 두었어요.
토큰 값표는 그룹별로 접히게 만들었어요. 마우스 없이 키보드 Enter와 Space로도 열고 닫히는지 확인했어요.
AI가 보낸 스크린샷 5장을 보고 제가 머지를 승인했어요. CI 3개를 모두 통과한 PR을 머지했고, 운영 배포 뒤 완료 검사 6단계도 모두 통과했어요. 여기까지는 회사 안에서 확인한 범위예요.
부품의 실제 모양 미리보기는 이번에 넣지 못했어요. 지금 DS 페이지는 3.0의 규칙과 값은 보여 주지만, 부품이 실제로 어떻게 생겼는지는 아직 보여 주지 못해요. 이 일은 남은 문제로 적어 두었어요. 다음 알파를 닫을 때 반자동 절차가 실제로 얼마나 걸리는지도 아직 재 보지 않았어요.
제가 정한 것과 AI가 한 것을 나눠 봤어요
제가 한 일은 질문과 선택이었어요. "자동으로 바뀌나?"라고 물었고, 세 안 가운데 반자동을 골랐어요. 화면을 보고 머지를 승인한 것도 저예요. AI도 반자동을 추천했지만, 개인과 회사 사이에 무엇을 넘기지 않을지는 제가 정할 일이었어요.
AI는 선택지 표를 만들었고, 사본 교체 명령과 검사를 짰어요. 로그인이 안 되는 원인을 찾아 확인 방법을 바꾼 것과 완료 검사도 AI가 맡았어요. 저는 AI가 멈춰서 물어 온 두 지점에서만 판단하면 됐어요.
처음 질문으로 돌아가 보면 답이 조금 달라졌어요
"원본을 고치면 페이지도 바뀌나?"에 대한 지금 답은 "알파를 닫을 때 PR 한 번을 거쳐 바뀐다"예요. 완전 자동보다 한 단계 느리지만, 그 한 단계가 사람이 보고 넘기는 자리예요.
사람이 확인하지 않은 버전이 운영에 나갈 수 있으면, 그 자동화는 아직 한 단계 이른 거예요.