한 줄 요약: 매일 못 하는 주가 있다. 이번 주는 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곳으로 늘린다.
이번 주 판단 근거는 지식 지도 분류 결정 기록에, 누적 교훈은 만들며 배운 것에 정리해두고 있어요.