본문으로 건너뛰기

[클로드 코드] 피드백 3개를 붙였더니, 제출용 데모가 사내 시스템이 됐다

sophie

2026.08.12

📝 한줄 요약

지난 글에서 만든 지점 근무 상태 사이트를 스터디에서 발표하고 피드백 3개를 받았습니다. 데이터를 실제로 연결할 것 · 지도는 API를 붙일 것 · 레퍼런스를 볼 것. 그걸 하나씩 붙이는 동안, 아무도 안 쓰던 제출용 화면이 전 직원이 매일 여는 사내 시스템으로 바뀌었어요.

바쁘시면 이것만:

  • 데이터는 상류로. 정리된 시트 말고 그 시트를 만들어내던 원본 캘린더를 읽게 했더니 갱신 지연이 통째로 사라졌습니다

  • 외부 서비스는 미니테스트부터. 본 작업 전에 30분 쓴 게 반나절을 살렸어요

  • "나는 되는데 너는 안 되는" 버그는 감으로 찍지 마세요. 화면에 진단 정보를 박아 재배포하면 캡처 한 장으로 끝납니다

  • 레퍼런스는 캡처가 아니라 대조표로. 그냥 던지면 "느낌"만 반영되고, 표로 바꾸면 고칠 게 목록으로 떨어집니다

🎯 이런 분들께 도움돼요

  • AI로 결과물은 만들었는데 일회성 데모에서 안 넘어가는 분

  • 사내용 페이지를 만들었다가 "제 화면에선 안 되는데요" 를 들어본 분

  • AI가 만든 화면이 어딘가 "AI 같은데" 왜 그런지 말로 못 짚겠는 분


😫 받은 피드백 3개

지난 글에서, 대표님의 "누가 어디서 일하는지 지도로 보고 싶다"는 한 마디를 하루 반 만에 사이트로 만든 이야기를 썼습니다. 솔직히 한계가 뚜렷했어요. 데이터는 한 번 떠온 스냅샷이라 어제 뜬 화면이 어제 그대로였고, 지도는 AI가 그린 약도라 확대가 안 됐고, 무엇보다 아무도 안 썼습니다.

스터디에서 발표하고 받은 피드백이 정확히 거기를 찔렀습니다.

"이건 고객용이 아니라 내부 대시보드니까 디자인은 지금 정도면 됩니다. 대신 데이터를 실제로 연결하고, 지도는 API를 붙이세요. 그리고 레퍼런스 — 사람이 만든 실제 대시보드를 보고 미감을 보완하세요."


① 데이터를 상류로 — 정리된 시트 말고, 정리되기 전 캘린더

처음엔 운영 시트에서 데이터를 떠왔습니다. 편했거든요, 이미 정리돼 있으니까. 그런데 생각해보니 그 시트도 누군가가 캘린더를 보고 옮겨 적은 결과물이었습니다. 그리고 사내엔 이미 매일 아침 그 캘린더를 읽어 슬랙에 요약을 올리는 봇이 돌고 있었어요.

우리 아침 브리핑 봇이 읽는 그 캘린더를, 이 사이트도 똑같이 읽게 하고 싶어.
그 봇이 어떤 캘린더를 어떤 규칙으로 읽는지 먼저 실측해줘.

AI가 서버에 붙어 배관을 역추적했습니다. 스케줄러 등록 이름 → 실행 스크립트 → 참조하는 캘린더 목록까지. 봇이 읽던 캘린더가 사이트에 필요한 지점 목록과 정확히 일치했어요.

여기서 판단을 하나 했습니다. 파서를 새로 안 짰다는 것. 캘린더 제목은 사람이 쓴 자유 텍스트라 규칙이 지저분한데, 셀 이벤트와 안 셀 이벤트를 가르는 로직이 이미 그 봇 안에 있었고 1년 넘게 실전 검증된 거였거든요. 새로 짜면 그 검증을 처음부터 다시 해야 합니다.

💡 AI에게 "만들어줘"라고 하면 대체로 새로 만들어 옵니다. "이미 돌고 있는 게 있는지 먼저 찾아보고, 있으면 재사용해"를 한 줄 붙이는 것만으로 결과가 달라져요.

그리고 마지막 한 걸음 — 이걸 스케줄러에 얹었습니다. 월~토 아침 8시 40분, 오후 2시에 자동으로 캘린더를 읽어 페이지를 다시 배포합니다. 어느 단계든 실패하면 텔레그램으로 알림이 오고, 화면 상단엔 "기준: ○월 ○일 스냅샷" 배지를 띄워 그 날짜가 오늘이 아니면 경고색으로 바꿨어요.

💡 자동화에는 "이게 죽었다는 걸 어떻게 알지?" 를 같이 설계하세요. 배관이 죽었을 때 화면이 어제 데이터를 오늘 것처럼 조용히 보여주는 것이 에러 페이지보다 위험합니다. 알림은 서버 쪽, 신선도 배지는 사용자 쪽 — 둘 다 필요해요.


② 지도 API — 30분 미니테스트, 그리고 "제 화면에선 안 보여요"

지도를 붙이는 건 쉽습니다. 문제는 배포하려는 곳이었어요. 사내 전용이라 회사 계정 로그인한 사람만 봐야 했고, 별도 로그인 시스템을 만들기 싫어 구글 Apps Script 웹앱을 골랐습니다. 회사 도메인 인증이 공짜로 딸려오거든요.

그런데 지도 API는 "어느 주소에서 부를 건지 미리 등록" 을 요구합니다. Apps Script는 구글이 만들어주는 임시 주소에서 도는데, 그게 어떻게 생겼는지 아무도 모릅니다. 그래서 본 작업 전에 지도만 덜렁 띄우는 빈 페이지를 먼저 배포했어요. 30분짜리였는데 두 개를 잡았습니다. 하나는 키를 발급받아도 "지도 기능 사용" 스위치가 따로 있었다는 것, 다른 하나는 그 임시 주소가 프로젝트마다 새로 생긴다는 것 — 테스트용을 버리고 새로 만들었으면 등록을 처음부터 다시 할 뻔했습니다.

💡 외부 서비스 연동은 "제일 작은 것 하나만 먼저 통과시켜보기" 가 거의 항상 이깁니다.

배포하고, 잘 되는 걸 확인하고, 공유했습니다. 그리고 바로 신고가 들어왔어요.

"지도가 안 뜨는데요?"

제 컴퓨터에선 잘 됩니다. 제일 골치 아픈 종류죠. 여기서 감으로 안 찍었습니다.

원인을 추측하지 말고, 페이지 안에 진단 패널을 박아서 재배포하자.
지도 로드에 실패하면 그 자리에, 지금 이 페이지가 실제로 어떤 주소에서
서빙되고 있는지를 화면에 그대로 찍어줘.

재배포하고 "실패 화면 캡처 한 장만 보내주세요" 했더니, 보는 순간 끝났어요. 주소가 저와 달랐습니다. 중간에 붙는 짧은 토막 하나가 "브라우저에 로그인된 구글 계정의 순번" 이었던 거예요. 저는 회사 계정이 첫 번째라 0, 그분은 개인 계정 다음이라 1. 같은 페이지인데 보는 사람에 따라 주소가 달라지고, 등록 안 된 주소라 거부당한 겁니다.

해결은 허무했습니다. 0번부터 3번까지 미리 다 등록. 그리고 4번 이상인 사람을 대비해 진단 패널을 상주시켰어요. 이제 신고가 오면 "캡처 한 장 주세요 → 그 번호 추가" 30초입니다.

💡 "나는 되는데 너는 안 되는" 버그의 정답은 관찰 장치를 심는 것입니다. "원인이 뭘까?"라고 물으면 그럴듯한 가설을 5개 만들어 오지만, "원인을 특정할 정보를 화면에 찍어줘" 라고 물으면 답이 나와요.


③ 레퍼런스 — 캡처가 아니라 대조표로

세 번째 피드백이 제일 애매했습니다. "레퍼런스를 보라"는 게 뭘 하라는 건지 손에 안 잡혔거든요. 참고할 사이트 목록은 뽑아뒀는데 그걸 어떻게 작업에 투입하는지가 문제였어요.

① 같은 카테고리의 실제 제품 화면을 캡처했다. 우리 페이지는 "지도 + 인원 상태 대시보드"입니다. 같은 구조의 실제 서비스 두 개를 골라 화면을 떴어요 — 배송 디스패치 콘솔(지도 위 기사 핀 + 작업 테이블 + 지표 행)과 워크플레이스 프레즌스 맵(평면도 위 좌석 점유 + 구역 라벨). 둘 다 디자이너가 만든 실물이고, 우리 화면과 구성 요소가 거의 1:1로 대응합니다.

② 감상 말고 대조표로 바꿨다. 이게 핵심이었어요.

항목

우리 화면

레퍼런스

진단

컨테이너

박스 18개 (지표 4 + 지도 + 사이드 2 + 인원 1 + 인원카드 10)

지도가 배경, 위젯만 그 위에 뜸 / 박스 대신 얇은 선

모든 걸 박스에 담기

색

출장자 카드 6개가 면 전체 분홍

상태는 작은 점·칩으로만, 면은 무채색

색이 포인트가 아니라 배경

글자 위계

섹션 제목과 데이터가 거의 같은 무게

라벨은 죽이고 데이터를 키움

위계 평평

지도

박스 안에 갇힘, 버튼이 구석에 붕 뜸

지도가 캔버스, 컨트롤이 그 위 유리판처럼 얹힘

지도가 주인공이 아님

③ 로직은 안 건드리고 스타일만 갈았다. 개선안이 전부 CSS 한 장으로 나왔습니다. 박스 18개 → 지도 하나 + 구분선, 출장자 배경색 → 이름 앞 점 하나, 섹션 라벨 축소·데이터 확대, 지도 컨트롤을 왼쪽 위 유리 오버레이로.

그리고 여기서 AI 제안을 하나 되돌렸습니다. 1차 시안이 "첫 지표만 검게, 나머지는 회색으로" 강조를 넣었는데, 렌더해놓고 보니 나머지 셋이 비활성처럼 읽히더군요. 다시 보니 그 규칙은 레퍼런스에 없는 것이었습니다. 레퍼런스는 지표를 죽이지 않아요.

💡 레퍼런스 라운드의 값어치는 "예뻐지는 것"이 아니라 판단의 근거가 생기는 것이었습니다. 근거가 있으면 내 결정도 반박할 수 있어요. "이게 더 나은 것 같아서"는 반박이 안 되지만, "레퍼런스엔 그 규칙이 없다"는 반박이 됩니다.


📊 결과

항목

발표 시점

지금

데이터

3주치 스냅샷 1회 (수동)

원본 캘린더 직독 · 하루 2회 자동 갱신

지도

AI가 그린 약도, 확대 불가

실제 지도 API · 실측 좌표

사용자

없음 (제출용)

회사 계정 로그인한 전 직원

신뢰장치

없음

신선도 배지 · 실패 알림 · 정합 가드 · 자가진단 패널

디자인 근거

없음

실제 제품 화면 2종 대조표

앞의 네 줄은 하루 만에 됐습니다. 빠른 이유는 실력이 아니라 재사용이에요 — 캘린더 파서(기존 봇), 디자인 토큰(파일로 보유), 배포 계정, 스케줄러 전부 이미 있던 것. 새로 만든 건 사실상 페이지 하나였습니다. 마지막 줄은 일주일 뒤 반나절.

💬 배운 것

효과적이었던 것

  1. "이미 돌고 있는 게 있는지 먼저 찾아봐" — AI의 기본값은 새로 만들기입니다. 재사용을 지시하면 검증된 로직이 공짜로 딸려와요

  2. 데이터는 상류로 — 정리된 결과물보다 정리되기 전 원본을 읽게 하면 지연과 사람 손이 동시에 사라집니다

  3. 버그는 가설이 아니라 관찰로 — "원인이 뭘까"가 아니라 "원인을 특정할 정보를 화면에 찍어줘"

  4. 레퍼런스는 대조표로 — 캡처를 그냥 던지면 "느낌"만 반영됩니다. 항목별로 나란히 적으면 고칠 게 목록으로 떨어지고, 나중에 내 결정을 반박할 근거로도 남아요

이렇게 하면 안 돼요

  1. 내가 만든 화면을 레퍼런스로 주기 — AI가 만든 걸 AI에게 보여주면 원래 습관이 강화될 뿐입니다. 레퍼런스는 사람이 만든 실제 제품 화면이어야 해요

  2. 내 브라우저에서 되는 걸로 배포 완료 처리 — 계정 구성·브라우저·기기가 다 다릅니다. 다른 사람 화면에서 한 번은 봐야 끝난 거예요

  3. 자동화 붙이고 안심하기 — 배관이 죽으면 화면은 어제 데이터를 오늘 것처럼 조용히 보여줍니다

🌍 다른 업무에 적용한다면?

  • "사내에서만 보는 페이지" — Apps Script 웹앱은 회사 구글 계정 인증이 공짜로 딸려옵니다. 로그인 시스템을 따로 만들 필요가 없어요 (대신 이 글의 주소 등록 함정은 그대로 만납니다)

  • 캘린더로 굴러가는 업무는 전부 후보 — 회의실·차량·장비 예약, 출장, 교대 근무. 이미 캘린더에 있다면 데이터 입력은 끝난 상태예요

  • "한 번 만든 자료"를 "매일 도는 화면"으로 — 월간 보고서, 재고 현황, 진행률 보드. 스케줄러에 얹는 마지막 한 걸음이 성격을 바꿉니다

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

김민철 프로필 이미지
김민철2026.08.12

실제로 사용하는 결과물을 만드셔서 너무 뿌듯합니다 실제 대시보드 화면을 오늘 스터디때 얼른 보고 싶네요 이따 뵙겠습니다~

oneshot 프로필 이미지
oneshot2026.08.12

정리된 시트 대신 원본 캘린더를 직접 읽고 기존 봇의 검증된 처리 방식을 재사용해 데이터 지연을 없앤 점이 인상적이었어요.

자동화에는 오래된 정보를 경고하는 표시를, 사용자별 오류에는 원인을 화면에 보여주는 진단 장치를 함께 넣어야 한다는 인사이트 얻어갑니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기