개요

llm-wiki와 OpenWiki는 모두 AI 에이전트를 위한 지식 베이스를 지향하지만, 접근 방식과 운영 모델에서 핵심 차이가 있다.

구분llm-wikiOpenWiki
출처Karpathy식 LLM Wiki 패턴LangChain 공식 공개 CLI
데이터 저장소로컬 파일 시스템 (마크다운)로컬 파일 시스템 (마크다운)
주도 주체에이전트 + 사람 (공동 편집)에이전트 (자동 생성·유지)
설정 파일AGENTS.md / CLAUDE.mdopenwiki.yaml 설정
트리거사람이 수동으로 페이지를 작성·편집CLI 명령으로 코드베이스 스캔 후 문서 자동 생성
링크 구조[[slug]] wikilink (basename 기준)명시적 참조 ([[ref:...]] 등)
타입 디렉토리entity / concept / comparison / summary / querywiki/overview / wiki/codebase 등
웹 호스팅선택 (별도 웹 서버)기본 로컬 파일
핵심 철학사람이 구조를 설계하고 에이전트가 채움에이전트가 코드를 읽고 스스로 문서를 갱신

llm-wiki

출처: Karpathy의 LLM Wiki 패턴에서 유래. Hermes Agent의 표준 구조로 통합.

  • 파일 하나 = 문서 하나, 앞뒤 링크로 지식 그래프 구성
  • type: frontmatter로 문서 타입 자동 분류
  • scripts/build_index.py로 인덱스 자동 생성
  • raw/ 계층(불변 원본)과 entities//concepts/ 등 가공 계층 분리
  • 사람과 에이전트가 공동으로 작성, 에이전트 세션 간 영속 메모리 역할

OpenWiki

출처: LangChain의 OpenWiki CLI — AI Sparkup 위키 문서.

  • 코드베이스를 읽고 AGENTS.md·CLAUDE.md에서 참조하는 형태의 문서를 자동 생성·유지
  • npx -y openwiki generate 같은 명령으로 에이전트용 코드 문서화
  • 코드 변경 시 문서 자동 동기화를 목표
  • LangChain 생태계와의 긴밀한 통합 (LangGraph, LangSmith 연동 가능)

핵심 차이 요약

관점llm-wikiOpenWiki
문서 출처사람·에이전트 혼합 작성에이전트가 코드로 부터 자동 생성
목표에이전트의 2차 뇌 (넓은 지식 그래프)코드 문서 자동화 (특정 코드베이스 대상)
범위일반 지식, 프로젝트, 검색 결과, 정리 노트코드베이스 문서, API 레퍼런스
편집 주체사람도 주체적으로 작성주로 에이전트가 갱신
확장성파일 시스템만 되면 어디든 운영 가능LangChain CLI 의존

언제 무엇을 쓰나

  • llm-wiki: 프로젝트 전반의 지식, 검색 결과 정리, 에이전트 간 협업 메모리, 일반 문서화
  • OpenWiki: 코드베이스 문서 자동화, AGENTS.md/CLAUDE.md 생성, 코드리뷰 문서화

출처