주차 회고 10주차 2026-09-23

6일을 비우고 하루에 몰아서 한 주 — 기대한 건 별게 없었고, 안 기대한 게 남았다

다른 프로젝트에 매달려 이 프로젝트를 6일 비웠고, 하루에 UI 개편·정리·애널리틱스·뉴스 소스 확장을 몰아서 했다. 궁금해서 켠 애널리틱스는 3줄로 끝나고 별게 없었고, 내 불편에서 시작한 UI 개편이 제일 남았다. 그리고 하나는 아직 안 끝났다.

이 글의 목차 (11)

한 줄 요약: 매일 못 하는 주가 있다. 이번 주는 6일을 비우고 하루에 네 가지를 몰아서 했는데, 그 하루가 가르쳐준 게 “뭘 먼저 해야 하는가”였다. 비개발자가 자기 사이트를 6일 만에 다시 열어본 이야기다.

이런 분께 도움이 돼요: 매일 하기로 해놓고 며칠씩 비우게 되는 분, 자동으로 쌓이는 자료와 내가 쓴 글이 섞여서 정리가 안 되는 분, 그리고 “이 기능 좋다던데” 하고 켜봤다가 허무했던 경험이 있는 분.


Before → After

Before (~9/21)After (9/22)
상단 메뉴학습위키 하나 — 봇 자료와 내 글이 한 목록에 섞임학습위키 / 개발일지 두 칸으로 분리
모바일에서 본문 시작2,409px 아래 (목록을 다 스크롤해야 글이 나옴)179px
모바일 헤더56px 칸에 65px가 들어가 본문 위로 삐져나옴이름 한 줄 + 메뉴 한 줄로 갈라짐
지식 지도인덱스 SVG + 마인드맵이 같은 내용 두 번 (954줄)인덱스 제거, 가지를 접기로 (475줄)
새 용어6일치 49개가 갈래 밖에 떠 있음미분류 갈래로 회수 (갈래 밖 0개)
방문자 데이터없음Vercel Web Analytics 수집 중
뉴스 소스RSS 3곳3곳 (네이버 추가는 미완)

0) 왜 6일을 비웠나

솔직하게 적자면, 다른 프로젝트 마무리에 매달려 있었다. 이 프로젝트는 9/17부터 9/21까지 손을 안 댔다.

그런데 6일 만에 사이트를 열어보니 오히려 또렷하게 보이는 게 있었다. 매일 보면 익숙해져서 안 보였을 것들이다.

  • 휴대폰으로 열었더니 세로로 보기가 불편했다. 글을 보려면 목록을 한참 내려야 했다.
  • 상단 ‘학습위키’를 눌렀더니 봇이 만든 용어 사전 밑에 내가 쓴 글이 깔려 있었다. 이직 포트폴리오로 보여줄 개발일지가 자동 생성 자료에 묻힌 꼴이었다.
  • 지식 지도를 열었더니 위쪽 그림과 아래쪽 마인드맵이 같은 말을 두 번 하고 있었다.

💡 며칠 비우는 게 꼭 손해만은 아니다. 매일 보면 불편에 적응해버린다. 오랜만에 열어봤을 때 걸리는 것이 진짜 고쳐야 할 것이다. 다만 대가는 있다 — 그 사이 쌓인 게 있다(아래 2번).


1) UI 개편 — 첫 프롬프트는 이거였다 (재현 가능)

방법부터 정하지 않고, 불편한 것 두 개만 적어서 의견을 물었다.

“내 학습 허브의 UI 부분을 개선을 하려고 해 일단 내가 생각하는 것은 다음과 같아 1. 학습 위키와 나의 개발 일지 분리 2. 모바일 가독성 증대 너가 봤을 때는 어때?”

여기서 중요한 건 마지막 줄이다. “너가 봤을 때는 어때?” — 코딩을 모르니까 “이렇게 고쳐줘”라고 방법을 지정할 수 없다. 대신 불편한 현상만 말하고 방법은 되묻는다. 그랬더니 모바일 쪽은 내가 몰랐던 것까지 잡혔다(헤더가 칸 밖으로 삐져나오고 있었던 것).

📷 여기에 개편 전/후 모바일 화면을 나란히 넣으면 좋아요

그다음은 보면서 고치는 일의 연속이었다.

“근데 주차별로 구분하는건 너무 많으니까 주차별 위에 또 다른 항목을 올려서 접을 수 있는게 낫지 않을까 싶어?”

주차가 10개까지 늘어서 목록이 길어진 것을, 목록을 보고 나서야 알았다. ‘주차별 기록’ 한 겹을 더 씌워 지금 보는 글이 든 주차만 펼치게 했다.

“일단 스테이하고, 그리고 지식지도의 경우 이게 중복이 되다보니까 가지 한눈에 보기를 없애고 용어 사전처럼 접기 기능을 추가해서 관리했으면 좋겠어”

“일단 스테이하고” — 이게 이번 주에 제일 잘한 말이다. 하던 작업을 멈춰 세우고 다른 걸 먼저 하자는 뜻인데, 이 한 마디 덕에 중복된 SVG를 지우는 일이 그날 안에 들어왔다. 지도 4개가 954줄 → 475줄이 됐다.

💡 방법 말고 증상을 말한다. “학습위키랑 개발일지를 분리해줘”는 방법이고, “둘이 같이 있으면 복잡해”는 증상이다. 증상을 말하면 내가 못 본 원인까지 나온다. 방법부터 지정하면 딱 그것만 나온다.


2) 막힘 → 해결: 갈래 밖에 떠 있던 용어 49개

UI를 손보다가 화면에 이상한 게 보여서 물었다.

“근데 이건 아무 분류에도 안 들어가는 거야?”

확인해보니 새 용어 49개가 어느 갈래에도 안 들어간 채 파일 맨 끝에 떠 있었다. DDR5 모듈 해외 생산 확대, 페로브스카이트, 고방열 EMC 같은 것들이다.

원인은 구조였다. 봇은 새 용어를 파일 맨 끝에 붙이고, 갈래에 넣는 건 주간 정리 때 사람이 한다. 그런데 내가 6일을 비우는 동안 봇은 계속 돌았다. 자동으로 도는 쪽과 사람이 도는 쪽의 주기가 어긋난 것이다.

고친 방법은 판단이 필요한 것과 아닌 것을 나눈 것이었다.

어느 갈래에 넣을지갈래 밖에 떠 있는 것
판단 필요?필요 (뜻을 읽고 정해야 함)불필요 (기계적)
그래서주간 정리로 미룸지금 바로 처리

각 파일에 이미 있는 ‘미분류’ 갈래 안으로만 옮겼다. 그 칸이 원래 이 자리를 위한 것이니까. 검증도 같이 했다 — 갈래 밖 용어 0개, <details> 태그 짝 맞음, 용어 총개수 이동 전후 동일, 빌드 45개 페이지 통과.

그리고 작업이 끝나갈 때 또 하나가 보였다.

“근데 또 이게 생기네 야도 집어넣고 마무리하자”

💡 밀린 일이 보이면, 그 안에서 “지금 당장 되는 것”을 잘라낸다. 49개를 제대로 분류하려면 한 시간이 걸리지만, 갈래 밖에서 안으로 옮기는 건 5분이다. 다 못 할 것 같아서 아예 안 하는 것보다, 기계적으로 되는 절반만 먼저 해두는 게 낫다.


3) 기대한 건 별게 없었다 — Vercel Web Analytics

“Vercel에 뭐가 더 있나” 궁금해서 눌러본 것이었다. 배포 대시보드에 프로덕션 체크리스트가 있길래 채워봤다.

항목결과
Connect Git Repository✅ 이미 돼 있었음
Preview Deployment✅ 브랜치 하나 push해서 체크
Enable Web Analytics✅ 켬 (로그인은 직접)
Custom Domain⬜ 도메인 구매 필요 — 생략
Speed Insights Plus⬜ 유료 — 생략

그런데 막상 켜보니 별게 없었다. 방문자 수 세는 정도다. 솔직히 허무했다.

대신 다른 걸 알았다. 예전에 다른 프로젝트(Python)에서 같은 걸 붙일 때는 <script> 태그를 손으로 심고 프리뷰 500 에러까지 잡느라 한참 걸렸는데, 이번엔 이게 끝이었다.

npm install @vercel/analytics
import Analytics from '@vercel/analytics/astro';
<Analytics />

그래서 물었다.

“엉 벌써?.. 이건 npm 버전이라 순식간에 끝난 건가?”

답은 프레임워크 공식 지원 때문이었다. 이 사이트는 Astro라 Vercel이 공식으로 지원한다. 지원되면 3줄, 안 되면 직접 심고 디버깅.

💡 “그 기능 붙이기 쉬워요?”의 답은 기능이 아니라 내 프레임워크에 달려 있다. 같은 기능이라도 공식 지원 목록에 내 도구가 있으면 3줄이고, 없으면 하루다. 붙이기 전에 “내 프레임워크가 공식 지원되나”부터 확인하면 걸릴 시간을 미리 안다.

📷 여기에 Vercel 체크리스트 3/5 화면을 넣으면 좋아요


4) 안 끝난 이야기 — 네이버 뉴스 API

지금 뉴스 봇이 긁어오는 곳은 한국경제·ZDNet·The Elec 세 곳뿐이다. 자원풀이 좁아서 자원이 많은 네이버까지 붙이고 싶었다. 마침 K-skill(한국 서비스용 스킬 모음)에 naver-news-search가 있길래 꺼냈다.

여기서 중요한 걸 하나 알았다.

스킬은 대화 안에서 쓰는 도구라, n8n 같은 자동화에 그대로 못 꽂는다. n8n은 별도 엔진이라 HTTP Request 노드로 API를 직접 불러야 한다.

다행히 그 스킬이 안에서 쓰는 건 네이버 검색 Open API라, n8n에서 재현은 가능하다. 그리고 RSS와 성격이 다르다는 걸 알았다.

지금 (RSS 3곳)네이버 뉴스 검색
방식매체 전체 최신 기사를 긁어와 LLM이 분류키워드로 직접 검색
그래서그날 그 매체가 안 썼으면 그 분야가 빔”배터리”로 검색하면 배터리가 나옴

지금 배터리 섹터가 자주 비는 문제가 있는데, 키워드 검색이면 그게 완화될 수 있다.

그다음 내가 걱정한 건 이거였다.

“Open API를 긁어오는 과정은 좀 복잡하지 않나? 네이버 측에서도 허가를 받아야 되는 사항인 것 같은데?”

확인해보니 심사도 승인 대기도 없었다. 로그인 → 애플리케이션 등록 → “검색” 체크 → 그 자리에서 Client ID/Secret 발급. 무료 한도는 하루 25,000건인데, 내가 쓸 건 하루 9번(3회 × 키워드 3개)이라 한도의 1%도 안 된다.

그리고 여기서 멈췄다. 키 발급은 네이버 로그인이 필요해서 내가 직접 해야 하는 단계다. 어려워서가 아니라 내 손이 필요한 자리에서 그날이 끝났다.

💡 “어려울 것 같아서 미뤘던 것”의 절반은 안 알아봐서 어려운 것이다. 허가·심사가 필요할 줄 알고 몇 주를 미뤘는데, 실제로는 클릭 네 번이었다. 붙일지 말지 정하기 전에 “이거 승인 필요해?”부터 물어보면 미룰 이유가 사라지는 경우가 있다.


재사용 자산

① 며칠 비운 뒤 다시 여는 체크리스트

몰아서 하는 주에 실제로 도움이 된 순서다.

1. 먼저 사용자처럼 열어본다 (특히 휴대폰으로)
   → 오랜만에 봐서 걸리는 것이 진짜 고칠 것
2. 자동으로 도는 것이 그동안 뭘 쌓았는지 확인한다
   → "이거 아무 분류에도 안 들어가는 거야?"
3. 쌓인 것 중 '판단 없이 되는 것'만 먼저 처리한다
   → 나머지는 주간 정리로 미룬다
4. 불편한 증상을 적어서 방법은 되묻는다
   → "너가 봤을 때는 어때?"
5. 작업 중 다른 게 보이면 "일단 스테이하고" 를 쓴다

② 방법 대신 증상을 말하는 프롬프트 틀

[내 사이트/프로그램]의 [어느 부분]을 개선하려고 해
일단 내가 생각하는 것은 다음과 같아
1. (불편한 증상 1 — 방법 말고 현상으로)
2. (불편한 증상 2)
너가 봤을 때는 어때?

마지막 줄을 빼면 내가 적은 두 개만 나온다. 넣으면 내가 못 본 것까지 나온다.

③ 새 기능 붙이기 전 확인 3개

  • 내 프레임워크가 공식 지원 목록에 있나 (3줄 vs 하루가 갈린다)
  • 이 API/서비스가 심사·승인이 필요한가 (의외로 대부분 아니다)
  • 무료 한도가 내 사용량보다 큰가

마무리

이번 주에 제일 의외였던 건 기대와 결과가 반대였다는 점이다.

궁금해서 켜본 애널리틱스는 막상 별게 없었고, 별 기대 없이 손댄 UI 개편이 제일 많이 남았다. 차이는 하나다 — 애널리틱스는 “뭐가 있나” 해서 켠 거고, UI 개편은 내가 직접 불편해서 손댄 것이다. 내 불편에서 출발한 게 더 오래 남았다.

그리고 6일을 비운 것에 대해. 매일 못 한 건 사실이지만, 6일 만에 여니까 불편한 게 더 잘 보였다. 대신 그동안 봇이 쌓아둔 49개가 갈래 밖에 떠 있었다. 자동으로 도는 쪽과 사람이 도는 쪽의 주기가 어긋나면, 어긋난 만큼이 어딘가에 쌓인다. 그걸 눈으로 확인한 게 이번 주의 수확이다.

다음 주엔 이번 주에 못 끝낸 걸 먼저 한다 — 네이버 API 키를 발급받아 n8n에 붙이고, 뉴스 자원풀을 3곳에서 4곳으로 늘린다.

이번 주 판단 근거는 지식 지도 분류 결정 기록에, 누적 교훈은 만들며 배운 것에 정리해두고 있어요.