주차 회고 11주차 2026-09-30

숨 고르는 주에 한 일 — 스킬에게 내 사이트를 평가시키고, 용어 30개에 그림을 붙였다

다른 프로젝트를 마무리한 뒤 숨 고르는 주에, 설치한 UI/UX 스킬에게 내 사이트의 개선점을 물어 7가지를 한 번에 고쳤다. 그리고 용어 30개에 구조도를 붙이다 그림이 튀어나오는 버그를 만났다. 다음 주는 네이버 뉴스 API와 온톨로지다.

이 글의 목차 (11)

한 줄 요약: 새 기능을 만든 주가 아니다. 이미 있는 사이트를 “쓰기 편하게” 다듬고, 어려운 용어에 그림을 붙인 주다. 비개발자가 스킬 하나로 자기 사이트의 접근성을 점검하고, 그림 30개를 붙인 이야기다.

이런 분께 도움이 돼요: 코딩을 몰라서 “내 사이트가 뭐가 부족한지”를 모르겠는 분, 다른 일로 바빠서 한동안 못 챙긴 프로젝트를 가볍게 다시 굴리고 싶은 분.


이번 주 한눈에

BeforeAfter
용어 풍선(툴팁)용어마다 따로 붙어 홈에 가로 스크롤바가 생김, 휴대폰 탭 안 됨페이지당 풍선 하나, 탭·키보드(Tab/Esc) 지원, 가로 스크롤바 사라짐
웹폰트넣어둔 폰트가 실제로는 안 불러와지고 있었음 (이름 불일치)실제로 적용
모바일 메뉴 터치 영역손가락으로 누르기 좁음세로 44px
회색 글자 대비4.45.3
12px 미만 작은 글자16곳0곳 (모두 0.75rem 이상)
용어 사전의 그림글자만 빽빽반도체·배터리 용어 30개에 구조도

0) 이번 주는 왜 숨을 골랐나

병행하던 My Career Finder가 마무리됐다. 고칠 것이 남아 있긴 해도 큰 줄기는 끝났다. 10주차 회고에서 “이제 이 프로젝트에도 다시 신경 쓸 수 있을 것 같다”고 적었는데, 막상 그날이 오니 바로 뭔가 크게 벌이고 싶진 않았다. 월·화는 컨디션도 좋지 않아서, 손은 가지만 부담은 적은 일부터 골랐다.

💡 숨 고르는 주에도 “안 한 주”가 되지 않는 법. 크게 새로 만들 힘이 없을 땐 이미 있는 걸 다듬는 일을 고르면 된다. 방향을 잃지 않고 쉴 수 있다.


1) 9/24 — 스킬에게 “내 사이트, 뭐가 문제야?”라고 물었다

전날 밤 UI/UX Pro라는 스킬을 설치했다. (스킬 = AI에게 “이 분야는 이 기준으로 봐”라고 미리 쥐여주는 전문 지식 묶음이다.) 그리고 이게 진짜 되는지 확인할 겸, 내 사이트를 통째로 평가시켰다.

“자 너가 봤을 때 UI-UX-PRO Skill을 사용한다고 가정할 때 지금 웹페이지를 본다면 무엇을 개선해야할까? 너가 한번 말해줘”

여기서 중요한 건 **“말해줘”**다. 고쳐달라고 하지 않고, 먼저 의견만 달라고 했다. 코딩을 모르니까 뭘 고쳐야 하는지를 스스로 짚을 수가 없다. 그래서 진단은 스킬에게, 고칠지 말지의 결정은 내가 했다.

돌아온 건 1번~7번 개선 목록이었다. 읽어보니 대부분 “내가 직접 쓰다 불편했던 것”과 겹쳤다. 그래서 두 번에 나눠 지시했다.

“1번 ~ 4번까지 한번에 고쳐줘” “5~7 이어서 고치고 커밋하고 푸시해줘”

7개를 한 번에 시키지 않고 4개 + 3개로 나눈 건, 중간에 확인하려는 것이었다. 결과는 위 표대로다. 그중 기억에 남는 발견 두 개.

  • 웹폰트가 사실 적용이 안 되고 있었다. 폰트를 넣어두긴 했는데 폰트 이름이 서로 달라서 브라우저가 못 찾고 있었다. 화면만 봐서는 몰랐던 문제다.
  • 홈의 가로 스크롤바의 원인이 용어 풍선이었다. 용어마다 풍선이 하나씩 붙어 있어서 화면 밖으로 삐져나갔다. 풍선을 페이지당 딱 하나만 만들어 돌려쓰게 바꾸니 사라졌고, 덤으로 휴대폰 탭과 키보드도 됐다.

💡 평가와 수정을 나눠 시킨다. “고쳐줘”보다 “뭐가 문제인지 말해줘”를 먼저 하면, 내가 모르던 문제(폰트 불일치처럼)까지 목록에 올라온다. 고치는 건 목록을 보고 골라서 시키면 된다.

📷 여기에 개선 목록 화면(1~7번)을 넣으면 좋아요


2) 9/28 — 용어 30개에 그림을 붙였다

용어 사전은 글자만 있으면 낯선 개념이 안 그려진다. 그래서 이렇게 요청했다.

“반도체/배터리 용어란에 있는 거 svg 형식으로 사진 추가 해줄래?”

결과는 새 SVG 22개(반도체 16, 배터리 6). 원리가 같은 용어 8개는 그림을 다시 그리지 않고 기존 걸 재사용했다. 그래서 그림 22개로 용어 30개를 덮었다.

이 그림은 분류 카드가 아니다. 그 개념이 실제로 어떤 구조인지를 그린 그림이다. (HBM은 어떻게 쌓이는지, 열폭주는 어떤 순서로 번지는지처럼.)

📷 여기에 구조도 예시(예: 열폭주 연쇄, HBM 적층) 두세 장을 넣으면 좋아요


3) 막힘 → 해결: 그림이 오른쪽으로 튀어나왔다

그림을 올리고 나서 화면을 보니 몇몇 그림이 글 폭보다 오른쪽으로 삐져나와 있었다. 스크린샷을 찍어서 그대로 보여주며 이렇게 시켰다.

“그리고 요렇게 사진이 우측으로 튀어나온 거 있지? 이렇게 되어 있는거 싹 다 맞춰줘”

원인은 이랬다. 그림을 감싼 접는 칸(<details>)에는 이미 좌우 여백 16px이 있는데, 그림에 width:100%까지 줬다. 그러면 “칸 폭 100% + 여백 32px”이라 글 폭보다 넓어진다. width:100%를 빼서 해결했다.

💡 “싹 다 맞춰줘”보다 먼저 스크린샷 한 장. 튀어나온 그림을 눈에 보이게 한 장 보여주고 “이런 거 전부”라고 하면, 하나만 고치고 끝나지 않고 같은 원인의 모든 곳을 한 번에 찾아 고친다.

📷 여기에 튀어나온 그림 스크린샷(전)과 맞춰진 화면(후)을 나란히 넣으면 좋아요


4) 이번 주가 가르쳐준 것

쉬는 주에도 남는 게 있다. 새로 만든 건 없는데, 사이트가 처음 보는 사람이 쓰기 편한 곳에 한 걸음 가까워졌다. 그리고 UI/UX 스킬 덕에 **내가 몰랐던 문제(폰트)**를 찾았다. 내 눈으로는 절대 못 봤을 것이다.

다음 주는 다시 만드는 주다. 이 프로젝트에 힘을 다시 실을 수 있게 됐다.

  1. 네이버 뉴스 API 연결 — 지금 뉴스 소스는 3곳뿐이라 좁고 배터리 섹터가 자주 비는데, 키워드로 직접 검색하는 네이버가 이를 도와줄 수 있다. 지난주에 키 발급에서 멈췄다.
  2. 온톨로지로 위키 강화 — 온톨로지는 용어들의 관계를 정리한 지도다. 지금 지식 지도는 “이 용어는 저 갈래 밑”까지만 말하는데, 여기에 “A는 B의 부품이다”, “A는 B를 대체한다” 같은 관계를 더하려 한다. 어떻게 할지는 다음 주에 정한다.

재사용 자산

① 내 사이트를 스킬에게 평가시키는 프롬프트

지금 웹페이지를 [스킬 이름]을 사용한다고 가정할 때
무엇을 개선해야 할까? 고치지는 말고 목록으로 말해줘

받은 목록을 보고 4개 + 3개처럼 나눠서 고치라고 하면 중간 확인이 된다.

② 그림 붙이기 프롬프트

[어느 페이지]에 있는 [어떤 용어들]에 SVG 형식으로 그림을 추가해줄래?
(원리가 같은 건 기존 그림을 재사용해줘)

③ 그림이 튀어나올 때

이렇게 [그림]이 우측으로 튀어나온 거 있지? (스크린샷 첨부)
이렇게 되어 있는 거 싹 다 맞춰줘

원인 체크: 바깥 칸에 이미 여백이 있는데 안쪽에 width:100%를 또 줬나?

④ 숨 고르는 주 체크리스트

  • 크게 새로 만들 힘이 없으면 이미 있는 걸 다듬는 일을 고른다
  • 진단(뭐가 문제야?)과 수정(고쳐줘)을 나눠서 시킨다
  • 한 번에 다 시키지 말고 몇 개씩 끊어 확인한다
  • 다음 주 할 일을 한두 개로 미리 적어둔다