본문으로 건너뛰기

위키가 두서없어진 걸 발견하고 바로잡은 날

John

2026.07.31

로드맵 자리에 문서 3개가 겹쳐 나온 원인을 코드에서 찾아내고, 새 분류(계획)를 만들고 제목까지 통일한 정리 기록.

뭐가 이상했나

PRD와 4주 세부 실행계획을 위키에 올린 뒤, "제목부터 순서까지 두서없는 느낌이 있다"는 얘기를 들었다. 딱 보기엔 뭐가 문제인지 애매했는데, 사이트 코드를 열어보니 이유가 명확했다.

이 위키는 종류(로드맵/개념/사례/회고)라는 값으로 글을 자동 정렬하는데, 로드맵은 코드에서 아예 "전체 지도" 자리에 딱 1개만 맨 위 고정으로 보이게 설계돼 있었다. 그런데 PRD와 실행계획도 급한 대로 종류: 로드맵으로 저장하는 바람에, 지도 자리에 문서 3개가 나란히 꽂혀버린 것이었다. 막연한 "느낌"이 아니라 실제 분류 실수였던 셈이다.

어떻게 고쳤나

  • 새 분류 '계획' 추가: 로드맵(전체 지도, 1개 고정) 아래 · 개념 위에 자리 잡는 종류를 새로 만들어서, PRD·실행계획처럼 "구체적인 계획 문서"를 이쪽으로 옮겼다.

  • 정렬 순서 확정: 로드맵 → 계획 → 개념 → 사례 → 회고

  • 제목 형식 통일: 개념 글들은 이미 "1주차 개념 — X" 형식으로 통일돼 있었는데, 사례 글 6개는 "Day 1 —", "참고 사이트 —", "일부러 —" 처럼 시작이 제각각이었다. 전부 "1주차 사례 — X" 형식으로 맞추되, 원래 있던 말맛("~한 하루", "~후기")은 최대한 살렸다.

  • AGENTS.md에 분류 기준 문서화: 로드맵은 1개만, 계획은 이럴 때 쓴다는 기준을 남겨서 같은 실수가 반복되지 않도록 해뒀다.

확인 방법

말로만 "고쳤다"고 끝내지 않고, 로컬 미리보기 서버를 띄워서 실제 위키 목록·글 상세 페이지·전자책 페이지까지 전부 열어봤다. 콘솔 에러가 없는지, 순서가 의도대로(지도 1개 → 계획 2개 → 개념 4개 → 사례 6개) 나오는지 확인한 뒤에야 마무리했다.

배운 것

"느낌이 이상하다"는 말은 대부분 코드 어딘가에 실제 원인이 있다. 눈에 보이는 결과(제목·순서)만 손보는 게 아니라, 그 결과를 만들어내는 규칙(정렬 로직·타입 스키마)까지 함께 확인해야 재발을 막을 수 있었다. 이후로는 새 글을 추가할 때마다 같은 종류의 기존 글들과 형식(제목 패턴·분류)이 맞는지 먼저 확인하기로 했다.

2

함께 이야기해요 2

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

뽀짝이 프로필 이미지
뽀짝이2026.07.31
"느낌이 이상하다"는 말을 막연하게 넘기지 않고 코드에서 실제 원인을 찾아낸 부분이 이 글의 핵심인 것 같아요. 로드맵 타입이 단 1개만 고정되게 설계된 로직을 직접 열어서 확인하셨잖아요. '계획' 분류를 새로 만들고 AGENTS.md에 기준까지 문서화해둔 것도 인상적이에요. 나중에 같은 상황이 생겼을 때 다시 코드를 뜯어볼 필요 없이 기준을 보면 되니까요. 로컬 미리보기로 목록·상세·전자책 페이지까지 전부 확인하고 마무리하신 것, 말로만 "고쳤다"고 끝내지 않는 태도가 이 글에서도 잘 드러나요. 꼬리 탁! 치고 응원하고 갈게요 🐈‍⬛
김준희 프로필 이미지
김준희2026.08.06

이건 단순히 제목을 예쁘게 맞춘 작업이라기보다, “로드맵은 전체 지도, 계획은 실행 문서”라는 기준을 새로 세운 기록처럼 읽혔습니다. 앞으로 글이 늘어날수록 이런 분류 기준 하나가 위키를 덜 어지럽게 만들어줄 것 같아요.

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

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

이런 사례도 있어요

사례 전체 보기