LLM-wiki — 제자리 색인 개인 위키

개인 작업 폴더의 프로젝트 약 90개·파일 약 6.8만 개를 복사하지 않고 제자리에서 색인한다. 사람은 로컬 웹에서, LLM 에이전트(Claude Code·Codex)는 CLI(JSON)로 같은 인덱스를 찾고, 결과는 늘 원본 경로로 이어진다. v2.0(2026-10-29)은 이 색인 위에 분류 구조의 포털·상세 검색·YouTube 요약 탭을 얹었다. 이 포트폴리오 사이트의 디자인은 LLM-wiki v2.0 화면의 디자인 언어(분류 구조·무채색과 파란 강조 하나·외부 의존 0)를 이어받았다.

착수를 요청했고, v2.0 요구 9건(탭·영상 링크·애플 웹사이트식 분류 구조·다중 분류·상세 검색 등)을 제기했다. v2.0 에서 애플 웹사이트의 분류 구조만 빌리고 제품 이름·모양은 쓰지 않기로, 영상은 링크 먼저, 옛 화면은 남기지 않고 롤백 절차만 두기로 정했으며, 디자인 시안을 확인했다. 재색인 버튼을 요청하고 검색을 흐리는 실행 데이터 폴더를 색인에서 빼도록 지정했으며, codex 검증 횟수를 정했다. 설계·구현·실측·문서는 AI 에이전트(실행 Claude Code · 검증 codex)가 했다.

• 원본을 복사하지 않고 제자리에서 색인한다. 첫 안(v0.5)은 원본을 복사해 LLM 이 위키를 합성하는 구조였는데, 원본이 이미 프로젝트 폴더에 정리돼 있어 복사본은 이중 관리만 늘렸다. 복사를 그만두자 티어링·다중 기기 동기화·중복 관리가 통째로 필요 없어졌다.
• 민감 파일은 두 수준으로 막는다. 경로조차 남기지 않는 제외 / 경로만 남기는 메타데이터로 나누고, 출력 전수 검사를 시험으로 고정했다.
• 기존 CLI 계약을 깨지 않는다. v2.0 에서도 기본 search 는 v1 코드 그대로 두고, 새 엔진은 별도 옵션으로만 열었다.

• v2.0 운영 전환(2026-10-29): 리허설에서 실패 주입 3종 자동 롤백 1.21~1.59초, 실제 운영 전환은 전환 실행(run) 74.1초·게시 전 검증 8/8·스모크 8/8 을 기록했다(실측).
• v2.0 후보 실측: 전체 색인 54.7~61.3초(파일 67,677) · 시험 301 통과·건너뜀 0 · v1 CLI 호환 32/32 바이트 동일 · DB 401MB.
• v1.0(2026-09-23 실측)은 목표 7항목 중 6개 충족 — 검색 p95 231ms(목표 300ms 이하), 증분 색인 31~35초는 목표 30초 소폭 초과로 그대로 뒀다.

• 2주 실사용 평가 같은 사용 효과 기록은 없다. 시안과 다른 곳 8건·카테고리 지정·카드 이미지·문서 유형 분류가 본인 확인 대기다. 문서 유형 분류는 베타로, 원자료 기록상 표본 정확도는 92.5%, 범위 밖 표본은 56.7% 로 평가 범위에 따라 차이가 커서 분류 품질을 더 확인해야 한다.
• v2.0 PRD 와 실행계획은 각각 codex 2회 검토에서 반려된 뒤 수정하고 본인이 정한 상한에서 진행했다(통과 아님). 이후 계약·코드 검증과 운영 전환 시험은 별도로 했다. v1 호환 API 시간 상한·위키 자기 폴더 검색 잡음은 v2.1 후보이고, 운영 폴더는 git 미초기화다.

Python 3.14 표준 라이브러리(필수 의존성 0) · SQLite FTS5 두 색인(unicode61 · trigram) · 제자리 색인 + 원자 교체 재색인 · 127.0.0.1 전용 정적 웹(바닐라 JS·자체 CSS) · CLI(JSON) · pytest · codex-cli