kb

kb 사용 가이드

기록하면 옵시디언처럼 연결되는 지식 베이스가 됩니다. 핵심 원칙은 단 하나 —

당신은 .md만 쓴다. 나머지(HTML·그래프·대시보드)는 전부 자동으로 만들어진다.

3단계로 시작하기

1

노트 만들기

설명만 주면 본문까지 써주고 관련 노트를 자동 연결합니다.

/note-draft 쿠버네티스 PDB로 무중단 배포

직접 쓰고 싶으면 /note-new worklog "제목" 으로 빈 스켈레톤을 만들어 content/에서 채웁니다.

2

빌드하기

모든 .md를 HTML로 렌더하고 링크·그래프·대시보드를 생성합니다.

/kb-build --open

깨진 링크가 있으면 빌드가 알려줍니다.

3

보기

로컬 서버로 대시보드를 엽니다. (또는 Vercel로 배포해 휴대폰에서)

/kb-serve

대시보드 · 그래프 · 노트가 서로 링크되어 있습니다.

6가지 노트 타입

업무기록

회사에서 일한 기록·인시던트·트러블슈팅을 매일 남깁니다.

/note-new worklog "제목"
content/worklog/2026/05/…
학습

일하며 배운 개념을 정리합니다. seedling→evergreen으로 키워가세요.

/note-new learning "Pod Eviction"
content/learning/<도메인>/…
독서

주말에 읽은 책의 챕터별 노트. 업무 경험과 연결하면 더 강력합니다.

/note-new book "SRE Workbook Ch.1"
content/book/<책>/…
면접

회사 JD를 미리 적어두고, 단계별 대화형 모의면접으로 약점을 찾습니다.

/note-new jd Kakao
content/interview/<회사>/_jd.md
스토리

worklog를 면접용 STAR 스토리로. 정량 임팩트·예상 꼬리질문까지 자동 정리합니다.

/story-forge <worklog-슬러그>
content/story/…
시스템설계

NALSD식 용량 추정부터 트레이드오프까지, 시스템 디자인 연습을 단계별로 기록합니다.

/sd-drill <주제>
content/sysdesign/…

🔗 노트끼리 연결하기 (옵시디언식)

본문 어디서든 [[슬러그]]로 다른 노트를 가리키면, 빌드 시 자동으로 링크 + 백링크(누가 나를 참조했는지) + 지식 그래프가 만들어집니다.

DNS TTL 함정은 [[rds-multi-az]] 노트 그대로였다.
표시 텍스트 지정: [[pod-eviction|파드 축출]]
특정 섹션으로:   [[rds-multi-az#함정]]

대상이 없으면 빨간 끊긴 링크로 표시되고 대시보드 경고에 모입니다 — 오타를 바로 잡을 수 있습니다.

Claude 스킬

/note-draft <아이디어/설명>설명만 주면 본문까지 채운 노트 초안 작성 + 관련 노트 자동 [[링크]]
/note-new <타입> "제목"빈 스켈레톤 생성 (직접 채울 때 · 자동 경로·frontmatter)
/story-forge <worklog/설명>경험을 면접용 STAR 스토리로 — 정량 임팩트·예상 꼬리질문·30초/2분 버전
/sd-drill <주제>시스템 디자인 단계별 연습(요구사항→용량추정→설계→트레이드오프) → sysdesign 노트
/mock-interview <회사> [--stage …]단계별(tech·sysdesign·behavioral·culturefit) 대화형 모의면접 → 점수·약점 추적
/kb-build [--open]전체 빌드 — HTML·링크·그래프·대시보드 재생성, 깨진 링크 리포트
/kb-serve로컬 서버를 띄워 브라우저로 대시보드 열기

실전 워크플로우

매일 · 퇴근 전 5분

/note-new worklog → 오늘 한 일·트러블슈팅 작성 → 재사용 개념은 /note-new learning으로 분리 → 본문에 [[…]] 링크 → /kb-build

주말 · 독서

/note-new book → 챕터별 정리 → 실무 경험과 [[worklog-슬러그]]로 연결 → 백링크가 "이론↔실무"를 자동으로 이어줍니다.

이직 준비 · 수시

공고 → /note-new jd <회사> → 강한 worklog는 /story-forge로 STAR 스토리화 → /sd-drill로 설계 연습 → /mock-interview <회사> --stage tech → 대시보드에서 점수·약점 추세를 보고 보강.

🎯 면접·이직 준비 워크플로우

기록한 경험과 학습을 면접에서 꺼낼 수 있는 자산으로 바꾸는 흐름입니다.

/story-forge <장애-worklog>경험 → 스토리: 장애 worklog를 STAR(상황·과제·행동·결과) + 정량 임팩트로. 면접 답변 대본이 됩니다.
/sd-drill "분산 rate limiter"시스템 디자인: 추상 박스가 아니라 QPS·대역폭·스토리지를 숫자로 추정하는 NALSD 연습.
/mock-interview <회사> --stage sysdesign단계별 모의면접: 실제 빅테크 파이프라인(기술·설계·행동·컬처핏)을 단계별로 리허설.

면접을 반복하면 대시보드 면접 위젯에 회사별 점수 추세와 반복되는 약점이 쌓이고, 약점 칩을 클릭하면 탐색에서 보강할 노트를 찾아줍니다.

📱 모바일에서 보기 (Vercel 배포)

.md를 git에 push하면 Vercel이 자동으로 다시 빌드합니다. 휴대폰에서 언제든 최신 지식 베이스를 확인하세요.

npm i -g vercel
vercel          # 최초 1회 링크
vercel --prod   # 배포
대시보드로 가기 → 지식 그래프 보기