변경 기록
언제 무엇이 바뀌었는지 한 줄씩 쌓아 둔 목록이에요. 손님의 "어제까지 되던데요" 질문과 사장님의 "이거 언제 건드렸지"를 같은 종이 한 장으로 해결해요.
쉽게 말하면
가게 문에 붙이는 "이번 주 달라진 것" 안내문이에요. 메뉴 두 개가 빠지고 포장 가격이 바뀐 날, 안내문 한 장이 붙어 있으면 손님은 계산대에서 안 따져요. 안 붙어 있으면 같은 질문을 하루에 열 번 받아요. 그리고 그 안내문을 버리지 않고 계산대 서랍에 날짜순으로 모아 두면, 몇 달 뒤 "그 가격 언제 올렸더라"에 3초 만에 답이 나와요. 붙이는 쪽이 손님용이고 모아 두는 쪽이 내부용인데, 종이는 한 장이에요.
만든 것을 한 번 열고 끝내는 사람에게는 필요 없어요. 필요해지는 순간은 두 번째 배포부터예요. 어제와 오늘의 화면이 다른 순간부터, 그 차이를 아는 사람이 사장님 혼자가 되기 때문이에요.
원인을 찾는 데 걸리는 시간이 대부분 "언제부터인가"를 좁히는 데 쓰여요. 고치는 시간보다 찾는 시간이 길어져요.
고치는 실력이 는 게 아니라 **범위가 좁아진** 거예요. 이 문서가 파는 건 그 좁힘 하나예요.
커밋과 뭐가 달라요
가장 자주 나오는 오해예요. 커밋을 꼬박꼬박 남기고 있으니 변경 기록도 이미 있는 것 아니냐는 거예요. 둘은 독자가 달라요. 커밋은 코드를 고칠 사람이 읽고, 변경 기록은 코드를 안 볼 사람이 읽어요.
| 커밋 기록 | 변경 기록 | 손님 공지 | |
|---|---|---|---|
| 누가 읽나 | 코드를 고칠 사람. 몇 달 뒤의 사장님 자신도 포함이에요 | 사장님과 응대 담당. 코드를 안 봐도 읽혀요 | 손님. 필요한 것만 알면 돼요 |
| 무엇이 적히나 | 어느 파일의 무엇을 어떻게 고쳤는가 | 손님 눈에 무엇이 달라졌는가, 언제부터인가 | 달라진 것 중 손님이 알아야 할 것만 |
| 한 번 작업에 몇 줄 | 여러 줄. 작업 덩이마다 하나예요 | 보통 한 줄. 여러 커밋이 한 줄로 합쳐져요 | 없을 수도 있어요. 안 알려도 되는 변경이 많아요 |
| 자동으로 만들어지나 | 만드는 순간 남아요 | 안 만들어져요. 사람이 한 줄 옮겨 적어야 해요 | 안 만들어져요 |
| 빠지면 생기는 일 | 되돌릴 지점을 못 찾아요 | 문의 원인을 못 좁혀요 | 같은 문의를 반복해서 받아요 |
자동으로 뽑아 쓰는 건 안 통해요
커밋 목록을 그대로 붙여 손님에게 보여 주는 방법이 있어요. 편하지만 읽히지 않아요. "버튼 컴포넌트 상태 처리 수정"은 손님 말이 아니거든요. 번역을 안 한 기록은 안 읽는 기록이에요. 옮겨 적는 30초가 이 문서의 값 전부예요.
한 줄에 무엇을 적나
형식을 복잡하게 잡으면 셋째 주에 안 쓰게 돼요. 필요한 건 세 가지예요. 날짜 · 갈래 · 손님 말로 쓴 한 문장. 갈래는 새로 생김, 고침, 달라짐 세 개면 충분해요.
| 갈래 | 이 갈래에 적는 것 | 쓴 예 | 쓰면 안 되는 예 |
|---|---|---|---|
| 새로 생김 | 없던 기능이나 화면이 생긴 것 | "예약할 때 반려동물 동반 여부를 고를 수 있어요" | "펫 옵션 필드 추가" |
| 고침 | 되던 게 안 되던 것을 되게 만든 것 | "휴대폰에서 결제 버튼이 안 눌리던 문제를 고쳤어요" | "모바일 버튼 이슈 픽스" |
| 달라짐 | 되긴 되는데 예전과 다르게 되는 것 | "주문 취소는 이제 결제 후 24시간까지만 돼요" | "취소 정책 변경" |
| 빠짐 | 있던 것을 없앤 것. 갈래를 하나 더 두려면 이것이에요 | "카카오톡으로 예약 알림 보내던 기능을 멈췄어요" | 적지 않고 그냥 없애기 |
| 안 적어도 되는 것 | 손님 화면이 그대로인 내부 정리 | 적지 않아요. 내부 기록에만 남겨요 | "디자인 토큰 정리" 같은 줄로 목록 채우기 |
빠짐은 반드시 적어요
없앤 기능은 알려도 욕먹고 안 알려도 욕먹는데, 안 알리면 고장으로 오해받아요. 고장으로 알면 손님은 문의를 하고, 정책이라고 알면 대안을 찾아요. 그 차이가 문의 건수예요. 없애는 줄은 미리 예고하고, 없앤 날 한 번 더 적어요.
어디에 두고 누가 읽나
종이는 한 장이지만 두는 자리는 셋이에요. 자리마다 읽는 사람이 다르고, 그래서 같은 변경이라도 적히는 깊이가 달라져요.
| 두는 자리 | 읽는 사람 | 적는 깊이 | 안 하면 생기는 일 |
|---|---|---|---|
| 사이트 안 안내 페이지 | 궁금해서 찾아온 손님 | 손님 말로 한 줄. 날짜만 붙여요 | "바뀐 거 없다더니" 소리를 들어요 |
| 내 문서 파일 한 장 | 사장님과 응대 담당 | 손님용 줄에 배포 시각과 되돌린 이력을 덧붙여요 | 문의가 왔을 때 시간대를 못 좁혀요 |
| 응대 문구 옆 | 문의에 답하는 사람 | "이 문의에는 이 줄을 붙여 답한다"까지 적어요 | 같은 상황에 답이 사람마다 달라져요 |
| 만든 것을 넘길 때 | 인수인계받는 사람 | 최근 몇 달치를 통째로 넘겨요 | 왜 이렇게 만들어졌는지 아무도 설명 못 해요 |
장면 1 · 손님이 문의창에 남겼다
“지난주에 쓰던 할인 코드 칸이 없어졌는데 저만 그런 건가요.”
이 문의에 "확인해 보겠습니다"로 답하면 같은 문의가 계속 들어와요. 변경 기록에 그 줄이 있으면 답이 한 줄로 끝나요. "3월 12일부터 할인 코드는 결제 마지막 화면으로 옮겼어요." 응대 표준 문구에 이 줄을 붙여 두면 다음 사람도 같은 답을 해요. 기록이 응대 시간을 줄이는 건 이 지점이에요.
쓰는 순서
따로 시간을 내서 쓰면 오래 못 가요. 배포하는 흐름 안에 끼워 넣는 것이 유일하게 유지되는 방법이에요. 다섯 걸음이고, 실제로 손이 가는 건 세 번째 하나예요.
- 1올리기 직전에 오늘 바뀐 것을 소리 내어 한 문장으로 말해 봐요. 문장이 안 만들어지면 한 번에 너무 많이 바꾸는 중이라는 신호예요.
- 2손님 화면이 달라졌는지만 따져요. 안 달라졌으면 손님용에는 안 적어요. 목록이 짧아야 읽혀요.
- 3그 문장을 날짜와 갈래를 붙여 목록 맨 위에 적어요. 맨 위예요. 최신이 아래에 있으면 아무도 안 내려가요.
- 4되돌린 날도 한 줄로 적어요. 배포 되돌리기를 했다면 그 사실이 가장 중요한 줄이에요. 되돌린 기록이 없으면 나중에 목록과 실제 화면이 어긋나요.
- 5한 달에 한 번 목록을 위에서 아래로 읽어요. 같은 것을 세 번 고쳤으면 그건 아직 안 고쳐진 거예요. 이 발견이 목록의 덤이에요.
확인해 보세요
오늘 배포에서 화면 뒤쪽 정리만 했어요. 손님이 보는 것은 하나도 안 달라졌어요. 이때 손님용 안내 페이지에는?
사고가 났을 때 값을 하는 순간
평소에는 귀찮은 일이고, 값을 하는 날은 딱 하루예요. 뭔가 안 된다는 연락이 왔는데 원인을 모르는 날이에요. 그날 이 목록은 원인 후보를 시간으로 잘라 줘요.
| 들어온 말 | 목록에서 확인할 것 | 그다음 판단 |
|---|---|---|
| "어제부터 안 돼요" | 어제 날짜에 줄이 있는지 | 줄이 있으면 그 배포가 1순위 후보예요. 없으면 내가 안 건드린 것이 바뀐 거예요 |
| "저만 안 되는 것 같아요" | 최근 줄에 특정 기기나 브라우저 이야기가 있는지 | 없으면 손님 환경 쪽부터 봐요. 목록이 내 변경을 후보에서 빼 줘요 |
| "결제만 안 돼요" | 결제 근처를 마지막으로 만진 날 | 그 날짜 이후 문의가 몰렸는지 대조해요. 날짜가 맞으면 되돌릴 대상이 정해져요 |
| "갑자기 느려졌어요" | 최근 며칠에 줄이 몰려 있는지 | 여러 줄이 같은 날 몰려 있으면 하나씩 못 가려요. 다음부터 나눠 올리라는 신호예요 |
| "제가 넣은 정보가 사라졌어요" | 그 사이에 되돌린 줄이 있는지 | 되돌린 기록이 있으면 그 시간대에 들어온 입력을 먼저 확인해요 |
장면 2 · 맡긴 개발자가 통화에서 말했다
“저는 그 부분 안 건드렸어요.”
여기서 다투면 시간만 가요. 물을 것은 하나예요. "지난주에 올린 것들 목록으로 주실 수 있나요." 목록이 바로 나오면 대조를 시작할 수 있고, 못 만들면 그 자체가 지금 만들어야 할 것이 무엇인지 알려 줘요. 맡기는 관계에서는 이 목록을 결과물의 일부로 미리 요구하는 게 좋아요. 넘겨받기 때 같이 받을 목록이기도 해요.
몰아 올리면 목록이 힘을 잃어요
하루에 열 가지를 함께 올리면 그날 줄이 열 개예요. 문제가 났을 때 후보가 열 개면 안 좁혀진 것과 같아요. 목록을 잘 쓰는 사람은 결국 배포를 잘게 나누게 돼요. 이 습관이 목록의 진짜 효과예요.
자주 묻는 것
- Q. 손님이 하루에 몇 명 안 되는데도 필요한가요?
- 손님 수보다 바꾸는 횟수를 보세요. 일주일에 두 번 이상 화면을 바꾸고 있으면 이미 필요해요. 손님이 적어도 사장님 자신이 한 달 전 결정을 기억 못 하거든요. 반대로 만들기만 하고 아직 안 열었으면 커밋만으로 충분해요.
- Q. 보안 문제를 고쳤을 때도 적나요?
- 적되 방법을 안 적어요. "로그인 관련 보안 문제를 고쳤어요. 비밀번호를 다시 설정해 주세요" 정도면 돼요. 무엇이 어떻게 뚫렸는지 자세히 쓰면 아직 업데이트를 안 받은 곳을 알려 주는 셈이 돼요. 내부 기록에는 자세히 남겨요.
- Q. 옛날 줄은 지워도 되나요?
- 지우지 마세요. 화면에는 최근 몇 달만 펼쳐 두고 나머지는 접어 두면 돼요. 옛 줄이 값을 하는 건 분쟁이 생겼을 때예요. "그 조건은 언제부터였나요"에 날짜로 답할 수 있는 것과 기억으로 답하는 것은 완전히 달라요.
- Q. AI에게 대신 쓰라고 해도 되나요?
- 초안까지는 잘해요. 무엇을 고쳤는지 알려 주면 손님 말로 바꾼 문장을 만들어 줘요. 다만 무엇을 안 적을지는 사람이 정해야 해요. 안 알려도 되는 내부 변경과 알리면 안 되는 보안 내용을 가르는 건 판단이지 문장력이 아니에요.
- Q. 버전 번호도 같이 붙여야 하나요?
- 지금은 날짜만으로 충분해요. 번호는 남이 내 것을 가져다 쓰기 시작할 때 필요해져요. 앱을 내려받게 하거나 다른 서비스가 내 창구를 부르기 시작하면 그때 버전 번호 규칙을 붙여요. 그전에 붙이면 관리할 것만 하나 늘어요.
- Q. 안내 페이지를 따로 만들 여유가 없어요.
- 공지 게시글 하나로 시작해도 돼요. 중요한 건 화면이 아니라 날짜와 한 줄이 계속 쌓이는 것이에요. 쌓이기 시작한 뒤에 자리를 옮기는 건 쉽고, 안 쌓인 것을 나중에 복원하는 건 불가능해요.
직접 해보기
오늘 것부터 한 줄 적어 보세요
과거를 채우려 하지 마세요. 오늘 바꾼 것 한 줄부터예요. 스튜디오에서 만들고 있는 것이 있으면, 안내 페이지를 한 장 만들고 오늘 날짜와 한 문장을 적어 두세요. 문장은 손님이 읽는다고 생각하고 쓰는 게 요령이에요. 내일 한 줄이 더 붙으면 그때부터 목록이에요.
스튜디오 열기하나 더
다음 주에 예약 취소 가능 시간을 48시간에서 24시간으로 줄이려고 해요. 변경 기록은 언제 적는 게 좋을까요?
더 깊이 (안 읽어도 괜찮아요)
왜 최신이 맨 위여야 하나 · 목록을 여는 사람은 대부분 "방금 뭐가 바뀌었지"를 알고 싶어 와요. 오래된 줄이 맨 위에 있으면 그 사람은 스크롤을 내리다 포기해요. 날짜순 정렬 방향 하나가 읽히느냐 마느냐를 정해요. 같은 이유로 한 날짜 안에서는 손님에게 영향이 큰 줄을 위로 올려요. 화면 색이 바뀐 줄과 취소 규정이 바뀐 줄이 나란히 있으면 뒤쪽이 위예요.
손님용과 내부용을 왜 굳이 나누나 · 한 장으로 합치면 둘 중 하나가 반드시 망가져요. 손님용에 내부 사정을 적으면 목록이 길어져 안 읽히고, 내부용을 손님 눈높이로만 쓰면 나중에 추적이 안 돼요. 실무에서 쓰는 방법은 같은 줄에 칸을 더 두는 거예요. 손님용 문장은 그대로 두고 그 옆에 배포한 시각과 되돌림 여부를 붙여요. 공개할 때는 앞 칸만 보여 줘요. 두 번 쓰는 게 아니라 한 줄에 칸이 늘어나는 구조예요.
목록이 견적과 인수인계에서 하는 일 · 몇 달치 목록은 그 자체로 작업 이력이에요. 새 업체에 견적을 받을 때 이 목록을 보여 주면 무엇이 얼마나 자주 바뀌는 서비스인지 상대가 알아요. 넘겨받는 사람에게도 마찬가지예요. 코드만 받으면 현재 상태만 보이고, 목록까지 받으면 왜 지금 이 모양인지가 보여요. 만든 뒤 관리하기에서 말하는 관리 비용의 절반이 이 맥락 전달이에요.
이것만 기억하세요
- ·커밋은 코드를 고칠 사람이, 변경 기록은 코드를 안 볼 사람이 읽어요. 옮겨 적는 30초가 값이에요
- ·한 줄에 날짜와 갈래와 손님 말로 쓴 한 문장이면 충분해요. 형식이 복잡하면 셋째 주에 멈춰요
- ·손님 화면이 안 달라진 변경은 손님용에 안 적어요. 짧아야 읽혀요
- ·값을 하는 날은 원인을 모르는 날이에요. 목록이 후보를 시간으로 잘라 줘요
- ·없앤 기능과 되돌린 배포는 반드시 적어요. 안 적으면 고장으로 오해받아요