고쳤더니 딴 게 깨짐

한 곳을 고친 뒤 다른 곳이 멈추는 현상이에요. 왜 매번 전체 점검이 필요한지의 답이에요

쉽게 말하면

메뉴 가격을 올린 날과 같아요. 벽에 걸린 메뉴판 숫자를 고쳤으면 끝난 것 같죠. 그런데 그 가격은 메뉴판에만 있는 게 아니에요. 계산대 기계에도 들어 있고, 배달앱 화면에도 있고, 지난주에 돌린 전단지에도 찍혀 있어요. 한 곳만 고치면 나머지 세 곳이 어긋난 채로 손님을 맞아요. 사장님은 멀쩡하다고 믿고 있고, 어긋난 걸 아는 사람은 계산대 앞에 선 손님뿐이에요. 만든 것 안에서도 똑같은 일이 벌어져요. 이걸 고친 자리가 아닌 딴 곳이 깨진 것이라고 불러요.

이 문서는 원인 찾기 다음 자리에 있어요. 원인을 좁혀서 고치는 것까지가 앞 문서의 일이고, 고친 뒤에 무엇이 같이 움직였는지 세는 것이 여기예요.

중요한 건 이게 실력 부족의 증거가 아니라는 점이에요. 기능이 서로 부품을 나눠 쓰는 한 반드시 생기는 일이라, 없애는 게 아니라 빨리 발견하는 쪽으로 대비해요.

많이 하는 마무리

"고쳤어요" · 고친 화면만 눌러 봄 · 되면 바로 손님에게 공개 · 무엇을 건드렸는지 기록 없음

그 자리에서는 성공으로 보여요. 이틀 뒤 결제가 안 된다는 문의가 들어오고, 그 사이에 들어왔어야 할 주문은 이미 지나갔어요.

값을 치른 마무리

"고치고 세 길을 다시 밟았어요" · 고친 화면 + 돈 받는 길 + 로그인 · 이상 없으면 공개 · 무엇을 건드렸는지 한 줄 기록

5분이 더 들어요. 대신 사고가 손님보다 먼저 눈에 띄고, 문제가 나도 방금 무엇을 건드렸는지 알아서 되돌리기가 쉬워요.

왜 멀쩡하던 곳이 깨지나

이유는 하나예요. 화면들이 부품과 값을 나눠 쓰고 있기 때문이에요. 나눠 쓰는 것이 무엇인지 알면 어디를 다시 봐야 하는지도 같이 정해져요.

내가 고친 것	같이 흔들리는 곳	보통 언제 드러나나
버튼 하나의 색과 크기	같은 버튼을 쓰는 모든 화면이에요. 예약 버튼을 고쳤는데 결제 버튼이 같이 커져요	다음 화면을 열어 보는 순간. 눈에 보여서 가장 안전한 종류예요
손님 정보에 칸을 하나 추가	그 표를 읽는 목록·상세·엑셀 내보내기가 전부 영향을 받아요	월말에 파일을 열 때. 며칠 늦게 알게 돼요
설정값이나 열쇠 하나	그 값을 쓰는 기능만 조용히 죽어요. 문자·메일·결제가 대표예요	손님이 "안 왔어요"라고 말할 때
화면 배치나 여백	폰 화면에서만 버튼이 화면 밖으로 밀려나요. 컴퓨터에서는 멀쩡해 보여요	손님 대부분이 폰으로 들어오니 공개 직후예요
저장하는 순서나 조건	그 순서를 믿고 있던 다른 기능이 빈 값을 받아요. 알림이나 집계가 멈춰요	다음 날 아침 또는 다음 달 첫 주

AI에게 맡길수록 이 일이 늘어나요

말로 고쳐 달라고 하면 AI는 사장님이 지목한 곳만 보지 않아요. 비슷한 이름을 가진 다른 자리까지 같이 손보는 일이 있어요. 그래서 부탁할 때 건드리면 안 되는 곳을 한 줄 적어 주면 범위가 줄어요. "결제 화면은 지금 정상이니 손대지 말아 주세요" 한 줄이면 돼요.

고친 뒤에 밟는 순서

전체를 다 보는 건 불가능해요. 대신 순서를 정해 두면 5분 안에 끝나요. 여섯 걸음 중 코드를 읽어야 하는 건 하나도 없어요.

1고치기 전에 무엇을 건드릴지 한 줄 적어요. "예약 화면 저장 버튼 문구" 정도면 돼요. 이 한 줄이 나중에 어디를 다시 볼지 정해 줘요.
2고친 자리부터 원래 증상으로 확인해요. 재현 절차에 적어 둔 순서를 그대로 다시 밟아요. 다른 길로 확인하면 고쳐진 게 맞는지 알 수 없어요.
3바로 옆을 눌러 봐요. 같은 화면의 다른 버튼, 그 화면으로 오가는 앞뒤 화면이에요. 부품을 나눠 쓰는 곳이 여기에 가장 많아요.
4돈이 오가는 길을 처음부터 끝까지 한 번 밟아요. 무엇을 고쳤든 이건 매번 해요. 여기가 막히면 그날 매출이 통째로 사라져요.
5폰으로 한 번 더 열어 봐요. 컴퓨터 화면만 보고 끝내면 손님 대부분이 보는 화면을 안 본 것이에요.
6무엇을 바꿨는지 한 줄 남겨요. 이틀 뒤 이상한 문의가 들어왔을 때, 이 한 줄이 원인 후보를 그날 바꾼 것 하나로 줄여 줘요.

한 번에 한 가지만 고쳐서 공개해요

여러 곳을 고쳐 한꺼번에 공개하면, 문제가 생겼을 때 무엇이 원인인지 못 가려요. 이전 버전으로 돌리기도 어려워져요. 급할수록 묶지 말고 하나씩 내보내는 게 빨라요.

매번 다시 보는 짧은 목록

무엇을 고쳤든 다시 보는 길을 다섯 개만 정해 두세요. 다섯 개면 5분이면 끝나고, 이 다섯 개가 막히면 가게 문이 닫힌 것과 같아요.

다시 밟는 길	확인하는 한 줄	안 보면 생기는 일
손님이 돈 내는 길	상품을 고르고 결제 화면까지 실제로 들어가 봐요	매출이 그날 통째로 멈춰요. 손님은 다시 안 와요
로그인과 회원가입	새 계정 하나로 가입하고 로그아웃했다 다시 들어와요	기존 손님이 자기 주문 내역을 못 봐요. 문의가 몰려요
저장이 실제로 되는지	예약이나 문의를 하나 넣고 관리자 목록에 그 줄이 생겼는지 봐요	저장됐다는 표시만 뜨고 기록이 안 남아요. 가장 늦게 발견돼요
손님에게 나가는 알림	주문 확인 문자나 메일이 실제로 도착하는지 봐요	손님은 주문이 안 된 줄 알고 다시 결제해요. 중복 결제로 이어져요
첫 화면과 목록	손님이 쓰는 주소로 들어가 첫 화면과 상품 목록을 열어요	빈 화면이나 오류 화면이 뜨면 손님이 들어오자마자 나가요

확인해 보세요

예약 화면의 안내 문구만 고쳤어요. 공개하기 전에 다시 볼 것은?

헷갈리기 쉬운 것

여기서 시간을 가장 많이 잡아먹는 건 어려운 원인이 아니라 비슷하게 보이는 네 가지를 섞는 것이에요. 가르는 질문 하나씩만 외우면 돼요.

섞이기 쉬운 두 가지	무엇이 다른가	어느 쪽인지 가르는 질문
고쳐서 깨진 것과 원래 없던 기능	앞은 되던 것이 멈춘 것이고, 뒤는 애초에 만든 적이 없는 것이에요	"지난주에는 이게 됐었나요"
고쳐서 깨진 것과 예전 화면	고친 결과가 아직 안 보이는 상태일 수 있어요. 화면만 묵은 것이에요	"새 창이나 다른 기기에서도 똑같나요"
내 화면과 손님 화면	만드는 중인 화면과 손님이 보는 주소는 설정값도 자료도 달라요	"손님이 쓰는 주소로 들어가도 똑같나요"
고쳐서 깨진 것과 바깥 서비스 장애	결제사나 문자 회사가 멈춘 날이면 내 쪽에는 고칠 게 없어요	"그 회사 장애 안내에 오늘 공지가 있나요"

두 번째 줄이 사람을 가장 자주 헛돌게 해요. 분명히 고쳤는데 그대로면 더 파기 전에 캐시부터 의심해요. 새 창에서 정상이면 이미 고쳐진 거예요.

Q. 고칠 때마다 이걸 다 하면 언제 만드나요?: 다섯 개짜리 목록은 익숙해지면 5분이에요. 그리고 다시 보는 길은 규모에 따라 달라져요. 손님이 아직 없는 연습 단계면 고친 자리만 봐도 충분하고, 결제와 로그인이 붙은 다음부터 다섯 개가 필요해져요.
Q. 같은 곳이 자꾸 깨져요. 제가 뭘 잘못하고 있나요?: 대개 그 자리가 여러 기능이 함께 쓰는 부품이라 그래요. 잘못이 아니라 구조 신호예요. 같은 자리가 세 번 깨졌다면 손으로 확인할 목록에 그 길을 아예 고정으로 넣어 두세요.
Q. AI에게 고쳐 달라고 했는데 왜 멀쩡한 곳이 바뀌나요?: 범위를 안 줬기 때문이에요. AI는 사장님 화면을 못 보니 어디까지가 정상인지 모르면 전부를 수정 대상으로 봐요. "목록과 결제는 정상이니 건드리지 말아 주세요" 한 줄이 이걸 막아요.
Q. 깨진 걸 발견했는데 원인을 모르겠어요. 뭘 먼저 하나요?: 원인 찾기보다 되돌리기가 먼저예요. 손님이 지금 쓰는 중이면 마지막으로 멀쩡했던 판으로 돌려 놓고, 원인은 그다음에 찾아요. 순서를 바꾸면 손님이 기다리는 동안 원인을 파게 돼요.
Q. 손님이 알려주기 전에 먼저 알 방법은 없나요?: 공개 직후 10분 안에 다섯 개 목록을 한 번 밟는 것이 가장 싸고 확실해요. 그리고 조용한 시간에 공개하면 문제가 났을 때 영향을 받는 손님 수가 줄어요.
Q. 손으로 하는 확인 말고 자동으로 하는 방법도 있나요?: 있어요. 기계가 대신 같은 길을 매번 밟게 만들 수 있어요. 다만 만드는 데 시간이 들어서, 손으로 하는 다섯 개 목록이 자리를 잡은 다음에 붙이는 순서가 맞아요. 순서를 바꾸면 아무도 안 보는 자동 점검만 남아요.

실제로 겪는 장면

장면 1 · 외주 개발자가 수정을 마치고 말했다

“요청하신 부분만 딱 고쳤습니다.”

여기서 물을 건 하나예요. "고치면서 같이 손댄 파일이 있나요." 요청한 부분만 고쳤다는 말과 그 부분만 영향을 받는다는 말은 다른 말이에요. 같이 쓰는 부품을 건드렸다면 다른 화면도 같이 봐야 해요. 이 질문 하나가 다시 볼 범위를 정해 줘요.

장면 2 · 공개 이틀 뒤 손님이 전화했다

“결제 버튼을 눌러도 아무 일이 안 일어나요.”

이틀 전에 고친 것이 결제와 상관없어 보여도 먼저 의심해요. 순서는 정해져 있어요. 손님이 쓰는 주소에서 같은 길을 직접 밟아 확인하고, 재현되면 그날 고친 것부터 되돌려 봐요. 손님에게는 "확인해서 오늘 안에 연락드린다"까지만 말해요. 원인을 모르는 상태에서 복구 시각을 약속하지 않아요.

금요일 저녁과 연휴 전날은 피해요

깨진 곳은 공개 직후가 아니라 몇 시간에서 며칠 뒤에 드러나는 일이 많아요. 사람이 없는 때에 공개하면 발견도 늦고 대응도 늦어요. 조용한 시간을 고르되, 사장님이 최소 두어 시간은 화면을 볼 수 있는 시간대로 잡아요.

지금 규모에서 어디까지 하면 되나

여기가 이 문서에서 가장 정직해야 하는 자리예요. 위 순서는 전부 시간이 드는 준비이고, 가게 규모에 안 맞으면 그냥 낭비예요.

내 가게 상황	어디까지 하면 되나	왜
아직 만드는 중이고 손님이 없어요	고친 자리만 눌러 보면 돼요	깨져도 잃을 손님이 없어요. 지금은 빨리 만드는 게 이득이에요
손님은 받는데 결제는 아직이에요	고친 자리와 저장, 폰 화면 세 가지를 봐요	예약이나 문의가 안 들어오는 건 이미 손해예요. 다만 돌이킬 수는 있어요
결제와 로그인이 붙었어요	다섯 개짜리 목록 전부를 매번 밟아요	여기서부터는 깨진 시간이 그대로 매출과 신뢰의 손실이에요
직원이나 외주가 같이 고쳐요	다섯 개 목록을 문서로 만들어 넘겨요	머릿속에만 있는 순서는 남에게 안 넘어가요. 사람이 늘면 사고도 늘어요
고칠 곳이 한 주에 여러 번이에요	기계가 대신 밟게 만드는 것을 검토해요	손으로 하는 확인은 잦아지면 반드시 건너뛰게 돼요

겁을 필요한 만큼만 사세요

이 주제는 대기업 기준으로 쓰인 글이 많아요. 사장님 기준은 하나로 정리돼요. 지금 깨지면 돈이나 손님을 잃는가. 잃는 게 없으면 가볍게 하고, 결제가 붙은 날부터 무겁게 해요.

하나 더

공개하고 두 시간 뒤에 로그인이 안 된다는 문의가 들어왔어요. 오늘 고친 건 상품 목록 화면이에요. 지금 할 일은?

직접 해보기

내 가게의 다섯 줄을 지금 적어 보세요

다시 밟을 길 다섯 개를 사장님 말로 적는 데 3분이면 돼요. "상품 고르기부터 결제 화면까지", "새 계정으로 가입하기"처럼 순서가 보이게 적는 게 요령이에요. 스튜디오에서 만들고 있는 것이 있으면 그 화면 이름을 넣어서 적어 두세요. 다음에 무언가를 고칠 때 이 다섯 줄이 그대로 점검표가 돼요.

스튜디오 열고 적어 보기

더 깊이 (안 읽어도 괜찮아요)

왜 고친 곳이 아니라 옆이 깨지나 · 만든 것 안에서는 같은 부품이 여러 화면에 꽂혀 있어요. 버튼 하나, 날짜를 다루는 규칙 하나, 손님 정보를 읽는 방식 하나가 여러 곳에서 함께 쓰여요. 이건 낭비가 아니라 좋은 구조예요. 한 번 고치면 전부 고쳐지니까요. 다만 대가가 있어요. 한 번 잘못 고치면 전부 잘못돼요. 그래서 부품을 나눠 쓸수록 고친 뒤에 옆을 보는 일이 더 중요해져요.

비유가 어디까지 맞고 어디부터 다른가 · 메뉴판 비유는 "같은 값이 여러 곳에 있다"까지는 정확해요. 다른 점이 하나 있어요. 가게에서는 값이 적힌 곳이 눈에 보이지만, 만든 것 안에서는 어디에 몇 곳이 있는지 사장님 눈에 안 보여요. 그래서 세는 방법이 달라져요. 목록을 눈으로 훑는 대신 길을 직접 밟아 보는 것이 유일한 확인이에요. 이게 다시 밟는 목록이 표가 아니라 순서로 적혀 있어야 하는 이유예요.

같은 자리가 세 번 깨졌다면 · 그 자리는 이미 약한 곳이라는 뜻이에요. 사람을 탓하면 다음 달에 또 나요. 대신 두 가지를 해요. 첫째, 그 길을 다시 밟는 목록에 고정으로 넣어요. 둘째, 무엇을 고쳤을 때 깨졌는지 세 번 치를 나란히 적어 봐요. 같은 원인이 보이면 그때는 점검이 아니라 그 자리 자체를 손볼 때예요.

손으로 하다가 기계로 넘기는 시점 · 다시 밟는 목록이 열 개를 넘거나, 한 주에 여러 번 고치게 되면 손으로는 못 버텨요. 사람은 잦은 반복을 반드시 건너뛰거든요. 이때부터 기계가 같은 길을 대신 밟게 만드는 방법을 봐요. 순서가 중요해요. 손으로 하는 목록이 먼저 자리를 잡아야 무엇을 자동으로 만들지가 정해져요.

이것만 기억하세요

·고친 자리가 아니라 옆이 깨져요. 화면들이 부품과 값을 나눠 쓰기 때문이에요
·다시 밟을 길 다섯 개를 정해 두세요. 돈 내는 길, 로그인, 저장, 알림, 첫 화면이에요
·한 번에 한 가지만 고쳐서 공개해요. 묶으면 원인도 못 찾고 되돌리기도 어려워요
·깨진 걸 발견하면 원인 찾기보다 되돌리기가 먼저예요
·결제가 붙기 전까지는 가볍게 해도 돼요. 무거워지는 건 돈이 오가는 날부터예요