내 학습허브 — 학습 전자책
학습위키를 책으로 묶었어요. 로드맵이 서문, 주차가 챕터예요. 지금 8꼭지.
내 학습허브
AI와 함께한 한 달의 학습 기록
PRD — 고무 생산 식물 논문 공유 대시보드
로드맵에서 정한 “뭘·왜·누구를 위해”를 그대로 가져오고, 실제로 만들 수 있게 구체적인 것들을 정했다.
뭘·왜·누구를 위해 (로드맵에서 그대로)
- 뭘: 논문 400편 중 대표 카테고리 3개를 뽑아, 각 논문에 영어 한 줄 요약을 붙인, 실제 주소로 열리는 대시보드
- 왜: 고무 생산 식물 관련 논문 약 400편이 D 드라이브 한 폴더에 흩어져 있어서, 동료도 나 자신도 필요한 논문을 다시 찾기 어렵다
- 누구를 위해: 우즈베키스탄과 한국에 있는 연구팀원 + 나 자신 (그래서 영어로 만든다)
카테고리 3개 (확정)
- Canada
- Kazakhstan
- Laticifer
논문 한 편에 담을 정보 (로드맵에서 그대로)
제목 · 저자 · 연도 · 저널 · 카테고리 · 영어 한 줄 요약 · 원문 링크
화면 구성 — 탭 필터형
한 화면에 논문 카드가 다 있고, 카테고리 버튼(Canada / Kazakhstan / Laticifer)을 누르면 새로고침 없이 그 카테고리만 바로 걸러져서 보인다.
꼭 되는 기능
- 검색창: 제목·키워드로 논문 찾기 (논문이 많아질수록 카테고리 3개 필터만으로는 부족해서 추가)
- 원문 링크: 카드에서 누르면 새 창으로 열림 (대시보드 화면은 그대로 남음)
- 정렬: 최신 연도순 (최근 논문이 위로)
- 카테고리별 개수 표시: 버튼 옆에 논문 수 표시 (예: “Laticifer (18)“)
접근 범위
로그인·비밀번호 없이, 링크만 있으면 누구나 볼 수 있는 공개 페이지. (원문이 아니라 제목·요약·링크 정도만 보여서 공개해도 괜찮다고 판단)
데이터 상황 (중요)
- 논문 400편의 제목·저자·연도·저널 정보가 정리된 목록(엑셀 등)이 아직 없다. PDF 파일들만 폴더에 있는 상태.
- 그래서 논문 파일(프론트매터)을 만들려면, PDF에서 정보를 하나씩 확인해서 옮기는 작업이 먼저 필요하다. → 이 작업은 클로드와 함께 진행 (2주차 “클로드로 논문 영어 요약 뽑는 법 연습”과 같이 진행)
MVP 완성 기준 (단계적으로)
한 번에 400편을 다 넣지 않고, 카테고리당 대표 논문 몇 편씩(예: 10~20편) 먼저 넣어서 작동하는 대시보드를 빨리 만들고, 이후 나머지 논문을 점차 채워나간다.
- 1주차: 카테고리 1개로 논문 몇 편 시범 제작 (뼈대 확인)
- 2주차: 카테고리 3개 전체, 대표 논문 위주로 채워서 “작동하는 대시보드” 완성
- 3주차: 남은 논문 마저 채워서 400편 반영 완료, 디자인·필터·링크 다듬기
만드는 방법 (최신 기준으로 조사)
이미 있는 사이트 방식(마크다운 파일 하나 = 페이지 하나, Astro 콘텐츠 컬렉션)을 그대로 활용한다. 별도 데이터베이스나 로그인 서버가 필요 없다.
- 논문마다 파일 하나 (제목·저자·연도·저널·카테고리·요약·링크를 담은 프론트매터)
- 탭 필터·검색은 간단한 자바스크립트로 구현 (카테고리 버튼·검색어에 맞는 카드만 화면에서 보이고 숨기는 방식) — 지금 소규모 정적 사이트에서 가장 흔히 쓰는, 가장 가벼운 방법
- 더 알아보고 싶으면: Astro 콘텐츠 컬렉션 공식 문서, 필터 구현 예시
실행 계획 — 논문 대시보드, 하루 단위로 쪼개기
PRD까지 정해졌으니, 이제 “진짜 만들기”만 남았다. 코딩을 몰라도 매일 하루치만 따라오면 4주 뒤 완성되도록, 하루 안에 끝날 크기로 쪼갰다.
먼저 확인한 것 — 지금 이 방식이 맞나?
만들기 전에 “요즘 제일 쉬운 방법”이 뭔지부터 최신 기준으로 찾아봤다.
- Astro가 최근 Content Layer API라는 새 방식을 냈는데, 이건 외부 CMS·데이터베이스를 연결할 때 쓰는 확장판이다. 우리처럼 로컬 마크다운 파일만 쓰는 소규모 사이트엔 오히려 배우기 어렵고 불필요하다.
- 지금 쓰고 있는 콘텐츠 컬렉션(마크다운 파일 하나 = 데이터 한 줄) 방식이, 논문 몇백 편 규모에서는 지금도 가장 쉽고 널리 쓰는 방법으로 확인됐다.
- 검색·필터도 별도 검색엔진 없이 바닐라 자바스크립트(버튼 누르면 카드를 보였다 숨겼다 하는 가장 단순한 코드)로 충분하다는 게 확인됐다.
→ 결론: PRD에서 정한 방향 그대로 진행. 방향을 바꿀 필요 없음.
참고: Astro 콘텐츠 컬렉션 공식 문서, 콘텐츠 컬렉션 vs Content Layer 비교
어떻게 나눴나
- 한 걸음 = 하루 안에 끝나는 크기. 그날그날 결과물이 눈에 보이게 나눴다.
- 오로라님이 할 일은 대부분 “PDF 열어서 정보 확인하고 알려주기”뿐. 파일 만들기·화면 코드는 모모가 처리한다.
- 각 걸음 끝에 그날의 학습일지 소재가 자연스럽게 남도록 짰다.
1주차 마무리 (뼈대 확인) — 이미 진행 중, 남은 두 걸음
걸음 1 — 논문 파일 틀 만들고 5편 시범 제작
- 오로라님: Laticifer 카테고리 논문 중 5편을 골라 PDF를 열어, 제목·저자·연도·저널을 확인해서 알려주기
- 모모: 논문 파일 틀(스키마) 만들고, 알려준 정보 + 클로드가 뽑은 영어 한줄요약으로 파일 5개 생성
- 오늘의 결과물: 논문 파일 5개 (Laticifer)
걸음 2 — 화면에 처음 띄워보기
- 모모: 카드 목록 화면 초안 만들어서 5편이 카드로 뜨는지 확인, 로컬 미리보기로 오로라님께 보여줌
- 오로라님: 미리보기 보고 “이대로 괜찮은지” 확인만
- 오늘의 결과물: 카드 화면 초안 + 배포 (뼈대 확인 완료 → 1주차 목표 달성)
2주차 (본격 제작) — 5걸음
걸음 1 — 카테고리 3개 틀 확정 + 요약 뽑는 법 연습
- 모모: 논문 파일 틀에 카테고리(Canada / Kazakhstan / Laticifer) 3개 다 반영
- 오로라님 + 모모: 클로드로 PDF → 영어 한줄요약 뽑는 프롬프트를 논문 3~5편으로 같이 테스트해서 방식 확정
- 오늘의 결과물: 확정된 요약 뽑는 방법 + 테스트 논문 몇 편
걸음 2 — Canada 대표 논문 채우기
- 오로라님: Canada 카테고리 대표 논문 10~20편 PDF 확인
- 모모: 정보 옮기고 요약 붙여서 파일 생성
- 오늘의 결과물: Canada 논문 파일 10~20개
걸음 3 — Kazakhstan 대표 논문 채우기
- 위와 동일한 방식으로 Kazakhstan 진행
- 오늘의 결과물: Kazakhstan 논문 파일 10~20개
걸음 4 — Laticifer 마저 채우고 탭 3개 다 연결
- Laticifer 대표 논문 나머지 채우기
- 모모: 카테고리 버튼(탭) 3개 누르면 각각 걸러지도록 화면에 연결
- 오늘의 결과물: 탭 필터 3개 다 작동
걸음 5 — 검색·정렬·개수 표시 붙이고 배포
- 모모: 검색창, 최신 연도순 정렬, 카테고리 옆 논문 수 표시 기능 추가
- 오늘의 결과물: “작동하는 대시보드” 완성 + 배포 (2주차 목표 달성)
3주차 (완성 채우기) — 5걸음
걸음 1~4 — 남은 논문 채우기 (배치 작업)
- 하루에 한 카테고리씩, 남은 논문을 클로드로 한번에 여러 편씩 요약 뽑아 채우기
- 오로라님: PDF 폴더 열어 카테고리별로 분류만 확인해주기 (내용 검토는 클로드가 초안 작성)
- 나흘에 걸쳐 400편 전체 반영 완료
걸음 5 — 디자인·오류 점검
- 모모: 카드 디자인 다듬기, 원문 링크 깨진 곳 점검, 모바일 화면에서도 보기 편한지 확인
- 오늘의 결과물: 완성된 영어 대시보드 (3주차 목표 달성)
4주차 (회고·발표) — 5걸음
걸음 1 — 최종 점검
- 전체 화면 훑어보며 오탈자·링크 오류 마지막 점검
걸음 2 — 팀원 공유
- 우즈베키스탄·한국 팀원에게 대시보드 링크 전달 + 사용법 짧게 안내
걸음 3 — 회고일지 작성
- “이번 주 회고일지랑 종합사례글 써줘” (주간종합 스킬)로 한 달 되돌아보기
걸음 4 — 발표 준비
- 강사 제출용 요약 + 종합사례글로 발표자료 정리
걸음 5 — 전자책 마무리
- 그동안 쌓인 위키 글을 전자책으로 마무리 → 완주
오늘 당장 할 일
1주차 걸음 1: Laticifer 카테고리 논문 5편을 골라 PDF 제목·저자·연도·저널을 확인해서 모모한테 알려주기. 이것부터 시작하면 돼요, 오로라님!
4주 로드맵 — 고무 생산 식물 논문 공유 대시보드
4주 뒤, 내 손에 남는 것
- 나를 아는 AI, 학습메이트 모모 — 이미 만들어짐
- 확정된 주제 + 4주 로드맵 — 고무 생산 식물 논문 공유 대시보드
- 작동하는 MVP — 논문 400편 중 주제 3개 카테고리를 뽑아, 각 논문 한 줄 요약(영어)이 붙은, 실제 인터넷 주소로 열리는 대시보드
- AI 활용 근육 — 클로드 코드로 데이터 정리·분석·배포를 겁내지 않고 시도해보는 힘
왜 이 프로젝트를 하는가
고무 생산 식물 관련 논문 약 400편이 D 드라이브 한 폴더에 흩어져 있어서, 동료도 나 자신도 필요한 논문을 다시 찾기 어렵다. 이걸 주제별로 분류하고 한 줄 요약을 붙인 대시보드로 만들어, 우즈베키스탄과 한국에 있는 연구팀원과 함께 보고 싶다. (그래서 대시보드는 영어로 만든다.)
지금 나 → 되고 싶은 나
- 지금: AI로 문서 정리 정도는 해봤지만, 코딩은 전혀 몰라서 대시보드를 만들어 공개하는 게 막막하다. 클로드 코드는 오늘 처음 써본다.
- 4주 뒤: 클로드로 데이터를 분석하거나 결과물을 대시보드로 공개하는 일을 겁내지 않고 시도해보는 사람이 되고 싶다.
참고한 실제 방법
연구팀들이 논문을 나눠 보는 방법을 먼저 찾아봤다. 가장 흔한 조합은 Zotero(문헌 저장) + Notion/Airtable(구조화된 표로 공유) 였고, Zotero-Notion 연동 도구(Notero)가 논문마다 제목·저자·연도·저널·메모를 자동으로 표로 옮겨준다는 걸 확인했다. 즉 연구자들이 실제로 논문을 공유할 때 쓰는 최소 정보 단위는 제목·저자·연도·카테고리·한줄요약·원문 링크였다.
오로라님은 Notion 대신, 이미 만든 내 사이트 위에 같은 구조를 얹기로 했다. 논문 한 편 = 파일 하나(같은 필드를 담은 프론트매터)로 만들고, 카테고리별로 걸러 보는 페이지를 클로드 코드로 만드는 방식. 아래 1~3주차는 이 방법에 맞춰 구체화했다.
4주 로드맵
| 주차 | 할 일 | 그 주 결과물 | 사례글 예시 |
|---|---|---|---|
| 1주차 (기획+착수) | 학습메이트 만들기, 주제 확정, 로드맵 작성, 대시보드 뭘·왜·어떻게 구체화 — 논문 정보를 제목·저자·연도·저널·카테고리·영어 한줄요약·원문 링크(Zotero·Notion식 문헌 데이터베이스 구조) 형식으로 설계, 400편 중 대표 카테고리 3개 후보 고르기, 사이트 배포 연습, 카테고리 1개로 논문 파일 몇 편 시범 제작해 MVP 뼈대 착수 | 이 로드맵 + 설계 문서(PRD) + 배포된 사이트 + 카테고리 3개 후보 + 논문 파일 시범 몇 편 | ”AI 학습메이트 모모 만들기”(완료), “논문 폴더에서 카테고리 3개 고르고 PRD 세우기” |
| 2주차 (MVP 본격 제작) | 클로드로 논문 영어 요약 뽑는 법 연습, 카테고리 3개 전체의 논문 파일을 실제로 만들고, 카테고리별로 걸러 보는 대시보드 페이지 제작, 반복되는 요약 작업 자동화 | 카테고리 3개의 논문 목록·요약 상당수 + 걸러보는 대시보드 페이지 초안 | ”클로드로 논문 한 줄 요약을 영어로 뽑아본 이야기”, “논문 여러 편을 한 번에 요약해서 대시보드에 넣은 방법” |
| 3주차 (MVP 완성·다듬기) | 남은 논문 마저 정리해 400편 반영 완료, 대시보드 디자인·필터·링크 점검 및 오류 수정, 우즈베키스탄·한국 팀원이 보기 편하게 다듬기 | 작동하는 완성된 영어 대시보드 (카테고리 3개 + 논문 목록 + 한 줄 요약 + 원문 링크) | “대시보드를 다듬어 완성한 이야기” |
| 4주차 (회고·발표) | 한 달 되돌아보기, 우즈베키스탄·한국 팀원에게 대시보드 공유, 발표 준비, 전자책 마무리 | 회고글 + 동료 공유 + 완성된 전자책 | ”4주 만에 논문 대시보드를 만들어 동료에게 공유한 날” |
1주차
코딩 몰라도 "인터뷰"만으로 내 AI 학습메이트 만들기
Before — 왜 이걸 했나
4주짜리 AI 학습 여정을 시작하면서, 매번 “너는 다정하게 대답해줘”, “나는 이런 사람이야” 같은 설명을 처음부터 다시 하고 싶지 않았다. 코딩은 전혀 모르는 상태라, 복잡한 설정 없이도 AI가 내 상황을 기억한 채 매번 같은 성격으로 도와줬으면 했다.
어떻게 — 인터뷰 → 파일 4개
AI에게 아래처럼 역할을 나눠서 부탁했다.
학습메이트는 파일 4개로 만들 거야. 네가 이 파일들을 읽으면 그대로 내 학습메이트가 되는 거야:
- SOUL.md — 네 성격 (이름·말투·행동 원칙)
- USER.md — 나에 대해 (누구인지·뭘 배우려는지)
- AGENTS.md — 작업 규칙 (내 사이트 다루는 법·매일 루틴)
- CLAUDE.md — 입구 ("대화 시작 전에 위 세 파일을 먼저 읽고 그대로 행동해"라고 적는 연결 파일)
그다음 AI가 한 번에 하나씩 질문해줬다.
- “네 이름 후보를 제안해줘” → 다솜·모모·하루·온이 중에서 모모를 골랐다.
- “나를 어떻게 부르고 어떤 말투로 도와줄지” → 오로라님이라고 부르고, 존댓말이지만 다정한 톤으로.
- “나에 대해” → 고무 생산 식물을 연구하고, 논문 공유 대시보드를 만들고 싶고, 한 달 뒤엔 그걸 완성해서 동료에게 보여주고 싶다고 답했다.
질문 하나에 답하면 다음 질문이 오는 식이라 부담이 없었다. 답이 다 모이자 AI가 그 자리에서 파일 4개(SOUL.md, USER.md, AGENTS.md, CLAUDE.md)를 프로젝트 최상위 폴더에 만들어줬다.
막힘 → 해결
특별히 막힌 곳은 없었다. 다만 질문 하나(한 달 뒤 목표)에 처음엔 두 개만 답했더니, AI가 “하나만 더 여쭤볼게요”라고 다시 짚어줘서 빠뜨리지 않고 채울 수 있었다.
After — 결과
이제 이 폴더에서 대화를 시작하면 AI가 자동으로 CLAUDE.md → SOUL.md/USER.md/AGENTS.md 순서로 읽고, 스스로 “모모”가 되어 오로라님이라고 부르며 다정한 존댓말로 답한다. “너 이름이 뭐야?”라고 물어봤더니 바로 “제 이름은 모모예요”라고 답해서, 설정이 실제로 적용된 걸 확인했다.
배운 것 / 재사용 자산
다른 사람도 그대로 복사해서 쓸 수 있는 프롬프트 뼈대:
학습메이트는 파일 4개로 만들 거야:
- SOUL.md — 성격 (이름·말투·행동 원칙)
- USER.md — 나에 대해 (누구인지·뭘 배우려는지)
- AGENTS.md — 작업 규칙 (사이트 다루는 법·매일 루틴)
- CLAUDE.md — 입구 (대화 시작 전에 위 세 파일을 먼저 읽고 행동하라고 적는 파일)
[A. 나한테 물어볼 것]은 하나씩 인터뷰해줘.
[B. 그냥 넣을 규칙]은 묻지 말고 아래 내용 그대로 반영해줘.
- 파일을 성격/사용자정보/규칙/입구로 역할별로 쪼개면, AI에게 매번 같은 설명을 반복하지 않아도 된다.
- 질문은 한 번에 하나씩 받는 게 훨씬 편했다 — 여러 개를 한꺼번에 받았으면 부담스러웠을 것 같다.
코딩 몰라도 GitHub·Vercel로 내 사이트 배포한 날
Before — 왜 이걸 했나
로컬(내 컴퓨터)에서만 보이던 사이트를, 우즈베키스탄·미국에 있는 동료들도 볼 수 있는 진짜 인터넷 주소로 만들고 싶었다. 문제는 나는 코딩을 전혀 모르고, git이니 터미널이니 하는 말 자체가 낯설다는 것. 명령어를 직접 칠 자신이 없어서, 클로드에게 “네가 대신 실행해줘”라고 통째로 맡겼다.
어떻게 — 프롬프트와 진행 과정
처음엔 이렇게 요청했다.
지금 필요한 도구를 전부 확인해줘: Git, GitHub CLI(gh), Node.js.
없는 것만 지금 내 컴퓨터에 맞게 설치해줘. "깔까요?"라고 되묻지 말고 바로 진행해줘.
설치 중에 내가 직접 클릭해야 하는 화면이 나올 때만, 뭘 눌러야 하는지 알려줘.
확인해보니 Git·Node.js는 이미 있었고, GitHub CLI(gh)만 없어서 그것만 새로 설치됐다.
막힘 1 — GitHub 로그인, 비밀번호가 자꾸 틀렸다고 나옴
로그인 코드(예: 9115-E120)를 받아서 github.com/login/device에 입력하는 순서였는데, 로그인 화면에서 비밀번호가 계속 틀렸다고 나왔다. 알고 보니 이메일 계정 자체의 비밀번호를 넣어야 하는 자리에 GitHub 비밀번호를 넣고 있었다. 이메일 로그인과 GitHub 로그인이 다른 단계라는 걸 헷갈렸던 것. 이메일 비밀번호를 재설정하고 나서야 넘어갈 수 있었다.
막힘 2 — 로그인 절차가 중간에 멈춤
터미널이 자동으로 실행되다 보니 “Enter를 눌러 계속하세요” 같은 확인을 못 받아서 로그인 절차가 멈춰버렸다. 그 사이 인증 코드가 만료돼서, 코드를 세 번이나 새로 받아야 했다. 세 번째 시도에서야 “Authentication complete” 메시지가 떴다.
막힘 3 — 저장소가 하마터면 남의 것으로 갈 뻔함
내 프로젝트 폴더가 원래 강의용 템플릿 저장소(mumyungsee/learning-hub-template)에 연결돼 있었다. 그대로 git push를 했다면 내 개인 기록이 남의 저장소로 올라갈 뻔했다. 클로드가 이걸 먼저 확인하고, 내 계정 아래 새 저장소를 만들어 연결을 바꿔줬다. 이때 저장소를 공개로 할지 비공개로 할지도 먼저 물어봤는데, 학습일지(비공개 폴더)가 원본 그대로 GitHub에 노출될 수 있다는 걸 짚어줘서 **비공개(private)**로 선택했다.
막힘 4 — git push가 이유 없이 멈춤
마지막으로 git push를 실행했는데 2분째 아무 반응이 없었다. 원인은 자격 증명 확인 방식(credential helper)이 화면에 안 보이는 팝업을 기다리고 있었던 것. gh auth setup-git 명령으로 GitHub CLI의 로그인 정보를 그대로 쓰게 바꾸자 바로 해결됐다.
배포
GitHub 업로드가 끝난 뒤, Vercel도 같은 방식으로 CLI 설치 → GitHub 계정으로 로그인 → 배포까지 이어졌다. 이번엔 로그인이 막히지 않고 한 번에 끝났고, 배포도 자동으로 완료됐다. GitHub 저장소와 Vercel이 자동으로 연결돼서, 앞으로 GitHub에 새로 올릴 때마다 사이트가 저절로 다시 배포된다.
After — 결과
내 사이트가 실제 주소로 열린다: https://gpters-study23.vercel.app
로컬에서만 보던 화면이 그대로, 인터넷 어디서나 열리는 걸 확인했다. 동료들에게 이 주소 하나만 보내면 된다.
배운 것 / 재사용 자산
막혔을 때 되짚어볼 체크리스트
| 증상 | 원인 | 해결 |
|---|---|---|
| GitHub 로그인 시 “비밀번호가 틀렸다” | 이메일 계정 비밀번호와 GitHub 비밀번호를 헷갈림 | 로그인 화면이 “이메일 로그인”인지 “GitHub 로그인”인지 먼저 확인 |
| 인증 코드 입력했는데 로그인이 안 끝남 | 터미널이 자동 진행이라 확인 입력을 못 받음 | 코드를 새로 받아서 재시도 |
git push가 계속 멈춤(응답 없음) | credential helper가 안 보이는 팝업을 기다림 | gh auth setup-git 실행 후 재시도 |
| 저장소를 만들기 전에 꼭 확인할 것 | 원래 연결된 저장소가 내 것이 아닐 수 있음(git remote -v) | 남의 저장소면 새 저장소 만들어 연결 바꾸기 |
다른 사람도 그대로 쓸 수 있는 요청 프롬프트
지금 필요한 도구를 전부 확인해줘: Git, GitHub CLI(gh), Node.js.
없는 것만 내 컴퓨터에 맞게 바로 설치해줘. 되묻지 말고 진행해줘.
설치 중 내가 직접 클릭해야 하는 화면이 나올 때만 알려줘.
- 코딩을 몰라도, “네가 대신 실행해줘”라고 하면 설치·로그인·배포까지 대부분 대신 해준다. 다만 로그인처럼 내 계정 승인이 필요한 부분은 내가 직접 눌러야 한다.
- 저장소를 공개로 할지 비공개로 할지는 미리 생각해두면 좋다. 특히 개인 기록(학습일지 등)이 섞여 있다면 비공개를 추천.
로드맵을 PRD로 구체화한 날 — 인터뷰만으로 화면·기능까지 정하기
로드맵에는 “논문 대시보드를 만든다”까지만 정해져 있었다. 화면에 뭐가 보이고, 뭐가 꼭 되어야 하는지는 여전히 막연했다. 이걸 실제로 만들 수 있는 수준으로 뾰족하게 만드는 문서를 PRD라고 부른다는 걸 처음 알았고, 인터뷰만으로 오늘 그걸 완성했다.
누구에게 도움이 될까: 나처럼 “만들긴 만들어야 하는데 뭐부터 구체적으로 정해야 할지” 막막한 초보에게.
Before — 로드맵엔 있고, PRD엔 없던 것
로드맵에는 이미 “뭘·왜·누구를 위해”가 있었다.
- 뭘: 논문 400편 중 카테고리 3개를 뽑아 한 줄 요약을 붙인 대시보드
- 왜: 논문이 폴더에 흩어져 있어 찾기 어려움
- 누구를 위해: 우즈베키스탄과 한국 팀원
하지만 정작 “화면에 뭐가 보이는지”, “뭐가 꼭 되어야 하는지”는 하나도 안 정해져 있었다. 이대로는 만들기 시작할 수가 없었다.
어떻게 — 있는 건 재사용, 없는 것만 인터뷰
이렇게 요청했다.
“내 로드맵에서 만들기로 한 걸 이제 실제로 만들 수 있게 구체화하고 싶어. 이걸 PRD라고 하지. 로드맵에서 이미 정한 ‘뭘·왜·누구를 위해’는 그대로 가져오고, 거기서 빠진 구체적인 것만 나한테 하나씩 물어봐줘.”
모모(AI 학습메이트)가 먼저 로드맵에 있던 내용을 그대로 정리해서 보여주고, 지금 쓰는 사이트 구조 위에서 제일 쉬운 만드는 방법(탭 필터형 vs 카테고리별 별도 페이지)을 찾아본 뒤, 로드맵에 없던 것만 골라 하나씩 선택지로 물었다.
| 물어본 것 | 내가 고른 답 |
|---|---|
| 화면 구성 | 탭 필터형 (카테고리 버튼 누르면 즉시 걸러짐) |
| 검색 기능 필요한가 | 필요함 (논문 많아지면 카테고리만으론 부족) |
| 카드에서 꼭 되는 동작 | 원문 링크 새 창, 최신 연도순 정렬, 카테고리별 개수 표시 |
| 공개 범위 | 로그인 없이 링크만으로 공개 |
| 카테고리 확정 여부 | 이미 확정 — Canada, Kazakhstan, Laticifer |
| 데이터 상황 | 정리된 목록 없음, PDF만 폴더에 있음 |
| MVP 완성 기준 | 카테고리당 대표 논문 몇 편씩 먼저, 이후 점차 채움 |
막힘 → 해결
질문 카드를 실수로 닫아버려서(제대로 안 고르고 넘겨버려서) 인터뷰가 한 번 끊겼다. 마침 그때 로드맵의 팀원 소재지(“미국”으로 잘못 적힌 부분을 “한국”으로) 수정이 먼저 필요해서, 그것부터 처리한 뒤
“PRD 인터뷰를 다시 이어가요”
라고 하니, 같은 질문 카드로 정확히 이어졌다. 중간에 다른 일을 처리해도 인터뷰가 끊기지 않는다는 걸 알게 됐다.
After — 완성된 PRD
인터뷰가 끝나자 로드맵 항목 + 인터뷰 답 + 조사한 만드는 방법을 합쳐 PRD 문서로 저장됐다. 이제 “뭘 만들지”뿐 아니라 “화면에 뭐가 보이고, 뭐가 꼭 되어야 하고, 어디까지 되면 완성인지”까지 다 정해진 상태다.
배운 것 / 재사용 자산
PRD를 처음부터 다시 만들 때, 아래 다섯 갈래로 물어보면 웬만한 프로젝트는 다 구체화된다.
- 화면 구성 (첫 화면이 어떤 모습인지)
- 핵심 기능 (꼭 되어야 하는 동작)
- 접근 범위 (공개 vs 제한)
- 데이터 상황 (이미 정리돼 있는지, 원본만 있는지)
- 완성 기준 (한 번에 다 채워야 하는지, 일부만 있어도 되는지)
이 인터뷰 과정 자체를 앞으로 “PRD 만들어줘” 한마디로 다시 쓸 수 있도록 스킬로 만들어뒀다.
2주차
논문 대시보드 첫 조각 완성 — PDF 29편을 직접 확인해서 채워 넣은 날
PRD까지는 “무엇을 만들지”만 정해져 있었다. 오늘은 그걸 실제로 눌러볼 수 있는 화면으로 만들고, 논문 29편을 직접 채워 넣었다.
누구에게 도움이 될까: PDF만 잔뜩 있고 정리된 목록은 없는 상태에서, 코딩 없이 필터형 대시보드를 만들어보고 싶은 사람에게.
Before — 계획만 있고 화면은 없던 상태
PRD에는 “카테고리 버튼을 누르면 그 카테고리만 걸러져 보인다”, “논문 한 편에 제목·저자·연도·저널·요약·링크가 담긴다”까지 정해져 있었다. 하지만 실제로 누르면 걸러지는 화면도, 채워진 논문 한 편도 없는 상태였다.
어떻게 — 화면부터 만들고, 폴더 하나씩 채우기
1) 화면 뼈대 먼저 논문 한 편 = 파일 하나 구조를 사이트에 추가하고, 카테고리 버튼(Canada / Kazakhstan / Laticifer)을 누르면 그 카테고리만 걸러지는 화면을 만들었다.
2) 폴더를 하나씩 알려주며 채우기 정리된 논문 목록이 없어서, 폴더 경로를 주면서 그 안의 PDF를 하나씩 확인해달라고 요청했다.
“Laticifer 논문은 아래 폴더에 있어요. 이 논문에서 시작해요. D:\Lubber Papers\Laticifer”
모모가 PDF를 열어 제목·저자·연도·저널을 확인하고, 영어 한줄요약과 원문 주소(DOI)를 붙여서 카드를 만들었다. 이 방식 그대로 Canada, Kazakhstan 폴더도 이어서 채웠다. 총 29편(Laticifer 6·Canada 5·Kazakhstan 18)이 이렇게 채워졌다.
3) 중간에 언어 규칙 정정 카드가 쌓이는 걸 보다가, 이 대시보드는 우즈베키스탄·한국 팀원이 같이 보는 화면이라는 걸 다시 짚었다.
“잘 만들었어요. ‘원문보기’를 영어로 바꿔요. 앞으로 만드는 것은 모두 영어로 작성하세요.”
이후로 페이지 제목·버튼·설명 문구까지 전부 영어로 바뀌었다.
막힘 → 해결
파일명 정리 중 발견한 함정 Kazakhstan 폴더 파일명에 한글이 섞여 있어서 정리를 요청했다.
“pdf 파일 이름에서 한글만 삭제해. 영어 이름은 그대로 두고 손대지마.”
그런데 한글만 지우고 나니 두 파일이 똑같은 이름(“Uteulin 2023.pdf”)이 될 뻔했다. 그대로 두면 하나가 다른 하나를 덮어써서 파일이 사라지는 상황이었다. 영어 키워드(gene review / soil)를 붙여서 구분했다.
파일명과 실제 내용이 다른 파일 PDF를 하나씩 직접 열어 확인하는 과정에서, “Bakirov 2021.pdf”라는 파일을 열었더니 앞부분이 고무 식물과 전혀 상관없는 밀 병해 논문이었다. 뒤로 넘겨보니 진짜 코크사기즈 논문이 섞여 있었는데, 정작 저자는 Bakirov가 아니라 Bari였다. 관련 없는 밀 논문 부분은 대시보드에서 빼고, 파일 이름도 실제 저자에 맞게 “Bari 2021 selection.pdf”로 바로잡았다.
After — 결과
대시보드에 논문 29편이 채워졌고, 카테고리 탭을 누르면 실제로 걸러진다. Canada를 누르면 5편만, Kazakhstan을 누르면 18편만 남는 걸 직접 확인했다.
배운 것 / 재사용 자산
PDF 폴더를 대시보드에 채울 때 이 순서를 그대로 다시 쓸 수 있다.
- 폴더 경로를 알려주고 “이 논문들부터 확인해줘”라고 요청한다.
- PDF를 열어 제목·저자·연도·저널을 확인한다. DOI가 안 보이면 추측하지 말고 검색해서 정확한 링크를 찾는다.
- 파일 이름을 정리할 때는 겹치는 이름이 생기지 않는지 한 번 더 확인한다.
- 폴더 이름과 실제 내용이 항상 같지는 않다 — PDF를 직접 열어 확인해야 걸러낼 수 있다.
느낀 점
연구팀과 논문을 공유하는 대시보드의 첫 조각을 만들어 보니 재미있다. 빨리 완성해서 연구팀에 공유하고 싶다.
3주차
논문 대시보드 국가·주제별로 확장 — 29편에서 97편, 탭 3개에서 8개로
지난번엔 Canada·Kazakhstan·Laticifer 탭 3개에 논문 29편을 채운 “첫 조각”이었다. 오늘은 검색창을 마저 달고, 대시보드를 국가별·주제별 탭 8개, 논문 97편으로 크게 늘렸다.
누구에게 도움이 될까: 처음엔 카테고리 몇 개로 시작했지만 자료가 계속 늘어나면서 “이 카테고리를 어떻게 쪼갤까”를 고민하는 사람, 그리고 논문 파일을 검색해서 채울 때 저자 국적·중복·오래된 문헌 같은 애매한 경우를 어떻게 판단할지 궁금한 사람에게.
Before — 탭 3개, 검색 기능 없음
지난 조각에서 카테고리 탭(Canada·Kazakhstan·Laticifer)과 카드 목록은 만들었지만, 검색창은 없었고 논문도 29편뿐이었다. “TKS Genes & Genome” 폴더처럼 국가가 섞인 채로 쌓여있는 자료도 아직 정리 전이었다.
어떻게 — 검색 붙이고, 카테고리를 쪼개며 채우기
1) 검색창 먼저 — 새 라이브러리 없이 검색을 어떻게 만들지 먼저 오픈소스를 찾아보고 비교했다. Pagefind(사이트 전체 검색)와 Fuse.js(오타 허용 검색) 둘 다 이 규모(논문 수백 편, 한 페이지 안 필터링)엔 과했다. 이미 탭 필터가 순수 자바스크립트로 되어 있어서, 검색창도 라이브러리 설치 없이 같은 방식으로 붙였다.
2) 웹 검색으로 논문 찾아 채우기 — Laticifer 6편 추가 PDF가 없는 상태에서 “식물의 Laticifer만 검색해줘”라는 요청을 받고, 학술 데이터베이스를 검색해 논문 6편을 새로 찾았다. 페이월에 걸려 자동으로는 못 받은 논문 4편은 오로라님이 직접 다운로드해주셨고, PDF를 열어 제목·저자가 실제로 맞는지 다시 확인했다.
3) 새 카테고리 만들기 — TTS, China, Germany, USA, Cultivation “TTS라는 새로운 대시보드를 만들어요” 같은 요청이 이어지면서, 폴더 하나 = 탭 하나 = 카테고리 하나 구조를 반복해서 늘렸다. 매번 같은 순서를 따랐다.
“TTS 논문을 어떤 형태로 보여줄까요?” → 기존 대시보드에 탭 추가 (기존 화면 안에 탭만 늘리는 쪽으로 방향부터 확인)
- 스키마(
config.ts)의 카테고리 목록에 이름 추가 papers.astro의 탭 배열에 같은 이름 추가- 폴더 속 PDF를 하나씩 열어 제목·저자·연도·저널 확인, 파일 하나 = 논문 파일 하나로 생성
- 로컬 화면에서 탭을 눌러 개수가 맞는지 실제로 확인
- 커밋 → 배포
이 순서로 TTS(14편), China(20편), Germany(처음 4편 → 이후 세 번에 걸쳐 12편까지), USA(11편), Cultivation(8편)을 채웠다.
4) 국가는 어떻게 판별했나 — 이름이 아니라 소속으로 “독일 그룹 논문을 찾아서 옮겨주세요” 요청을 받았을 때, 성이 독일어처럼 들려도(Panara, Lopez, Fantini 등) 실제 소속이 이탈리아·미국이면 제외했다. 반대로 저자 소속 주소에 “Germany”, “Julius Kühn-Institute”, “University of Münster” 같은 표기가 실제로 있는지 PDF 첫 페이지를 열어 하나하나 확인한 뒤에만 옮겼다.
막힘 → 해결
작업 중 폴더가 갑자기 반토막 났을 때
“TKS Genes & Genome” 폴더에서 독일 논문을 찾던 중, 다음 명령을 실행하니 폴더 파일 수가 31개에서 11개로 줄어 있었다. 알고 보니 오로라님이 같은 시간에 파일탐색기로 “TKS Genes & Genome_China” 폴더를 따로 만들어 중국 저자 논문을 옮기고 계셨던 것 — 삭제가 아니라 동시 작업이었다. find로 옮겨진 파일들을 다시 찾아 상황을 확인하고, 겹치지 않게 작업을 이어갔다.
파일명에 특수문자가 있으면 PDF를 못 여는 문제
“rubber‐related”처럼 일반 하이픈이 아닌 특수 하이픈이 파일명에 섞인 PDF 몇 개는 텍스트 추출 도구가 계속 빈 결과를 냈다. 파일을 임시로 영문 이름(tmp_fan.pdf)으로 복사한 뒤에는 정상적으로 열렸다 — 인코딩 문제였다.
같은 논문이 폴더 두 곳에 있을 때
“TTS 논문 중 빠진 것 있으면 올려주세요” 요청에 새 파일을 열어보니, 파일명만 다르고(Uteulin 2023 gene review.pdf vs Kuluev 2023 Molecular Genetic Research.pdf) 내용은 완전히 같은 파일이었다. md5sum으로 두 파일을 비교해 완전히 같은 해시임을 확인하고, 중복 등록을 막았다. Boguspaev NMR 논문, Puskas 논문, Kaiser 2026 논문에서도 같은 방식으로 중복을 걸렀다.
저자 목록이 PDF 추출 중 깨졌을 때 Mutalkhanov 2021 논문의 저자 줄에서 1저자(M. Mutalkhanov)가 통째로 빠진 채 대시보드에 올라간 적이 있었다. 오로라님이 “첫번째 줄에 있는 저자들을 추가해달라”고 짚어주셔서, PDF 첫 페이지를 이미지로 직접 렌더링해 저자 순서를 눈으로 다시 확인하고 바로잡았다.
하나의 논문, 두 개의 카테고리 딜레마 Cultivation 탭을 만들 때, Eggert 2018·Kreuzberger 2016·King-Smith 2025(재배 밀도) 세 논문은 이미 각각 Germany·USA 탭에 올라가 있었다. 지금 구조는 논문 한 편에 카테고리 하나만 붙을 수 있어서, 그대로 둘지 옮길지 오로라님께 먼저 확인부터 하고 진행했다.
DOI 없는 옛날 논문
1941년에 나온 Bondarenko & Tarakanov 논문은 온라인에서 정확한 링크를 못 찾아 추측으로 채우지 않고 일단 빼뒀다. 오로라님이 직접 찾은 링크(heritage.jscc.ru)를 알려주신 뒤에야 등록했다.
After — 결과
대시보드가 탭 3개·29편에서 탭 8개(Canada·China·Germany·Kazakhstan·USA·Cultivation·Laticifer·TTS)·논문 97편으로 늘었다. 국가 탭은 알파벳순으로, 그 뒤에 주제 탭(Cultivation·Laticifer·TTS)이 오도록 순서도 정리했다. 검색창에 저자 이름을 치면 카테고리 필터와 같이 작동하는 것도 확인했다.
배운 것 / 재사용 자산
카테고리를 새로 늘릴 때 이 다섯 단계를 그대로 반복하면 된다.
- 스키마와 탭 배열, 두 곳에 카테고리 이름을 추가한다.
- 폴더 속 파일을 열어 정보를 확인하되, 저자 국적처럼 판단이 필요한 항목은 파일명이 아니라 실제 소속 주소를 본다.
- 새로 채우기 전에
md5sum으로 기존 파일과 겹치는지 먼저 확인한다. - 링크(DOI)가 안 보이면 추측하지 않고, 못 찾으면 사용자에게 솔직히 알리고 기다린다.
- 로컬 화면에서 탭을 눌러 개수가 맞는지 실제로 검증한 다음에만 커밋·배포한다.
느낀 점
하루 만에 대시보드가 세 배 넘게 커졌다. 카테고리가 늘어날수록 “이게 정말 같은 논문인가”, “이 저자가 정말 이 나라 소속인가” 같은 판단이 계속 필요했는데, 매번 직접 열어서 확인하는 습관이 결국 제일 빠른 길이었다.