Architecture Analysis

AX-Wiki
LKB Knowledge Base

프로젝트 파일과 회의록을 업로드하면 LLM이 자동으로 위키를 생성하는 지식 관리 플랫폼. 문서 간 관계를 자동 발견하고, 자연어로 프로젝트 지식을 검색할 수 있다. Karpathy의 LKB 개념 기반. Zero-Build SPA + Serverless Python + Supabase.

12
API Endpoints
11
CLI Commands
3
Claude Models
3
DB Tables
Section 01
업로드하면 위키가 만들어진다

프로젝트 파일(회의록, 기획서, 메일, 레퍼런스)을 업로드하면 LLM이 자동으로 위키를 생성한다. 문서 간 [[위키링크]]를 자동으로 만들고, 백링크와 관련 문서를 발견하고, 자연어 질문에 답한다. 사람이 위키를 정리할 필요가 없다 — 업로드만 하면 프로젝트 지식 베이스가 자동으로 구축된다.

Upload → Auto Wiki Generation → Knowledge Network → Q&A Upload 회의록 드래그&드롭 기획서 업로드 메일, 레퍼런스 .md .txt .html Auto Compile Claude가 구조화 카테고리 자동 분류 [[위키링크]] 생성 사람 개입 불필요 Wiki Network 문서 간 자동 연결 백링크 추적 관련 문서 발견 Lint: 깨진 링크 탐지 Q&A 자연어 질문 날짜/동의어 확장 Claude 멀티모델 이력 영구 저장 핵심: 업로드만 하면 프로젝트 위키가 자동 생성된다 새 회의록 추가 → 기존 문서와의 관계 자동 발견 → 위키 네트워크가 점점 풍부해짐 "지난주 논의한 내용 정리해줘" → 날짜 확장 + 전체 위키 검색 → Claude가 요약
Section 02
시스템 아키텍처
3-Layer Architecture: SPA → Serverless Python → Supabase + Claude Zero-Build SPA 순수 HTML/CSS/JS 사이드바 + 탭 인터페이스 Dashboard SPA 진행률, 커밋, 배포 상태 To-Do (드래그 정렬) LKB Viewer SPA Wiki + Q&A + 문서 관리 Markdown 뷰어 Vercel Serverless Python — 12 API Endpoints 프레임워크 없음 (직접 HTTP 핸들링) · urllib · cold start 최적화 Anthropic Claude (3 models) Supabase (DB + Storage) Local Filesystem (raw/)
Section 03
하네스 기반 자동화 파이프라인
기획 자동화: INPUT → Harness Build (70%) → QA 반복 → OUTPUT (95%) INPUT 기획 자료 메뉴 단위 정보 Harness Build 초기 빌드 완성도 70~80% QA 자동 생성 QA 항목 자동 피드백 5~10회 반복 OUTPUT 완성도 90~95% 자동 생성 기획서 피드백 → 재빌드 루프 자가개선: 실수 → SOFT 규칙 → 재발 → HARD 승격 → exit 2 차단 반복할수록 QA 항목 감소 — 시스템이 학습하며 강해진다
Section 04
핵심 기능
Compile

LLM 자동 컴파일

Raw 문서(회의록, 기획서)를 Claude가 읽고 구조화된 위키 문서로 변환. [[위키링크]] 자동 생성. 백링크 + 관련 문서 자동 발견 (키워드 유사도 5개+ 매칭).

Search

키워드 확장 Q&A

"어제 회의" → 2026-04-09로 날짜 변환. 동의어 확장. 멀티 문서 검색 후 Claude 답변 생성. Sonnet/Haiku/Opus 모델 선택 가능. 이력 영구 저장.

Monitor

대시보드 + To-Do

프로젝트 진행률, GitHub 커밋, 배포 상태를 한 화면에. To-Do 관리 (드래그 정렬, 인라인 편집, Supabase 동기화).

Quality

위키 건강 검진 (Lint)

깨진 링크, 고아 문서, 빈 문서, 제목 누락 자동 탐지. 연결 가능한 문서 쌍 제안. 단어 수 통계.

Section 05
설계 패턴

No-Build SPA

빌드 도구 없이 HTML/CSS/JS 직접 배포. 프레임워크 의존성 제로. 빠른 반복. Vercel에 그대로 배포.

Frameworkless Serverless

Flask/FastAPI 대신 직접 HTTP 핸들링. urllib으로 외부 API. cold start 최소화. 60초 실행 제한.

Multi-Source Indexing

로컬 파일시스템(raw/, wiki/) + Supabase Storage를 통합 인덱싱. seen set으로 중복 방지.

Keyword Expansion

"어제"→날짜, "회의"→동의어 확장. 컨텍스트 인식 검색으로 자연어 질의를 정확한 문서 매칭으로 변환.

Karpathy LKB 철학

지식은 Raw → Compile → Search → Q&A의 파이프라인으로 흘러야 한다. 사람이 읽는 문서와 AI가 읽는 문서를 분리하고, 컴파일 과정에서 구조를 부여한다. 위키링크로 문서 간 관계를 자동 생성하고, Q&A로 즉시 접근 가능하게 만든다.

Related Docs
함께 읽으면 좋은 문서