An AI second brain that maintains itself. Full guide, starter vault, agent skills and scripts for a self-organizing knowledge base in Claude Code and Obsidian.

AI 제2 뇌 – LLM 에이전트가 구동하는 개인 지식 기반

무엇인가요 – LLM(Claude Code)가 지속적으로 인게스트, 링크, 큐레이션하는 제2 뇌로 오브시디안 백을 자동으로 전환하는 완전한 오픈소스 가이드 및 스타터 킷입니다. 리포지토리는 다음을 포함합니다:

로컬에 클론 가능한 백 템플릿(위키 + 프로젝트 계층)
18개의 "스킬"(LLM 기반 워크플로우)과 72개의 슬래시 명령어 (인게스트, 링크, 린팅, 통계, 그래프 내보내기 등 자동화)
6개의 서브에이전트 (스케줄 또는 요청 시 실행)
Python 스크립트 (건강 점검 및 그래프 통계용)

모든 중량 작업은 LLM 에이전트가 수행합니다. 이 에이전트는 원시 파일(기사, PDF, 트랜스크립트, 채팅 내보내기)을 읽고 개념을 추출하며, 밀집된 링크를 가진 마크다운 페이지를 생성/업데이트하고 백을 최신 상태로 유지합니다. 사용자는 오브시디안(마크다운 뷰어)과 Claude Code 런타임만 필요합니다. 백이 RAG에 필요한 정도로 커질 때까지 외부 벡터 데이터베이스는 필요하지 않습니다.

왜 중요한가

자체 호스팅 및 소유권 – 지식은 당신이 제어하는 일반 마크다운 파일에 남아 있습니다. 유일한 "클라우드" 구성 요소는 호출하는 LLM뿐입니다.
지루한 작업의 자동화 – 링크, 모순 추적, 점진적 업데이트가 자동으로 수행되어 전통적인 "내가 저장한 것은 전혀 정리하지 않는다" 문제를 해결합니다.
이중 계층 아키텍처 – 당신이 아는 것(위키)과 현재 진행 중인 일(프로젝트)을 분리합니다. 각각 고유의 CLAUDE.md 파이프라인을 가지며, 참조 자료와 활성 작업을 명확히 분리합니다.
점진적 확장성 – 순수 마크다운에서 시작합니다. 백이 "벡터 DB 임계점"에 도달하면 GraphRAG 추가를 안내합니다.

핵심 구성 요소 (README에 설명됨)

구성 요소	역할
`vault-template/`	위키 구조, 프로젝트 파이프라인, 페이지 템플릿, 샘플 `CLAUDE.md` 파일이 포함된 스타터 오브시디안 백.
`skills/`	가이드에 기술된 워크플로우를 구현하는 18개의 LLM 기반 스킬 (예: 인게스트 → 추출 → 링크 → 린팅).
`commands/`	Claude Code UI 내에서 스킬을 노출하는 72개의 슬래시 명령어 (예: `/ingest`, `/graph-export`).
`agents/`	스케줄 또는 요청 시 실행되는 6개의 서브에이전트 (4개는 읽기 전용). 정기적 유지보수, 건강 점검, 요청 시 쿼리 수행.
`scripts/`	링크 검사, 백 통계, 그래프 내보내기용 의존성 없는 Python 유틸리티.
`plugins/`	Agents Course가 두 명령어로 설치하는 Claude Code 플러그인. 컨텍스트 감시자, 목표 테스트 생성기, 게이트 찾기기, 하네스 감시자, 평가 부트스트랩, 루프 비평가 제공.
`docs/`	65페이지의 "제2 뇌 가이드" (10섹션, 77페이지) 및 7모듈의 Agents Course, 그래프, 하네스, 루프 등에 대한 여러 가이드북 포함.
`resources/`	저자가 추천하는 도구, 논문, 기타 리포지토리의 큐레이션된 목록.

작동 방식 (고수준 흐름)

클립 / 원시 자료 저장 → raw/ 폴더 (기사, PDF, 채팅 로그)
        │
        ▼
   Claude 에이전트가 적절한 스킬 실행
        │   – 개념 추출
        │   – wiki/ 아래에 위키 페이지 생성/업데이트
        │   – 기존 페이지에 링크, 모순 기록
        ▼
   구조화된 위키 (1개 마크다운 페이지당 1개 아이디어, 밀집된 위키 링크)

병렬적으로 프로젝트 계층은 동일한 패턴을 반영하지만, 현재 진행 중인 작업에 특화되어 있으며 각각 고유의 CLAUDE.md 파이프라인(입력 → 처리 → 출력 → 피드백)을 가집니다.

시작하기 (README의 빠른 시작 단계)

리포지토리를 git clone하고 백 템플릿을 ~/brain에 복사.
skills, commands, agents, scripts를 적절한 숨겨진 .claude 폴더에 복사.
오브시디안을 설치하고 복사한 폴더를 백으로 열기.
Claude Code (LLM 런타임)을 설정하고 원격 액세스를 위해 MCP를 선택적으로 활성화.
백 내부에서 claude를 실행하여 에이전트 시작.
내장된 /ingest 명령어(또는 웹 클리퍼)를 사용해 새로운 소스 제공.
제공된 에이전트를 통해 유지보수 스케줄링 (/metrics, /health, /graph-export).

가이드는 각 단계를 상세히 설명하며, 설정, 인게스트, 구조화, 그래프 처리, 에이전트, 검색, 출력, 유지보수, 문제 해결을 위한 별도 페이지를 제공합니다.

누구에게 적합한가

연구자, 엔지니어, 작가, 학생 – 많은 콘텐츠를 소비하고 수동 정리 없이 정리하고 싶은 사람.
솔로 사용자 (이 리포지토리는 명시적으로 팀 위키나 Notion 대체품이 아님).
터미널과 오브시디안에 익숙하고 Claude Code(또는 파일을 읽을 수 있는 어떤 LLM)에 접근 가능한 사람.

라이선스 및 커뮤니티

MIT 라이선스 – 포크, 수정, 상용 사용 자유.
기여 환영. CONTRIBUTING.md는 출처 기반 사실 업데이트와 정당화된 도구 추가를 요청.

TL;DR

second-brain-os는 "LLM 위키" 패턴(Karpathy의 LLM 위키)의 완전 문서화된 오픈소스 구현입니다. 준비된 오브시디안 백, Claude-Code 스킬/명령어 세트, LLM이 당신의 원시 독서 자료를 당신이 소유하는 살아있는 링크 기반 지식 기반으로 자동으로 변환할 수 있도록 하는 단계별 가이드를 제공합니다.

undefined-ui/second-brain-os