coleam00/second-brain-starter

자신만의 AI 세컨드 브레인(second brain)을 구축하기 위한 개인 맞춤형 제품 요구 사항 문서(PRD)를 생성하는 Claude Code용 스킬입니다. 세컨드 브레인이란 사용자의 컨텍스트를 이해하고, 세션 간에 기억을 유지하며, 지속적으로 정보를 제공하는 능동적이고 지속적인 AI 어시스턴트를 의미합니다.

개요 시청하기: How I Built My AI Second Brain with Claude Code (YouTube)

사용자는 자신의 도구, 워크플로(workflow), 선호도를 설명하는 간단한 요구 사항 템플릿을 작성합니다. 그러면 Claude Code가 메모리(memory), 통합(integrations), 스킬(skills), 능동적 하트비트(proactive heartbeat), 채팅 인터페이스(chat interface), 보안 강화(security hardening)를 포함하여 사용자의 설정에 맞춘 단계별 구축 계획을 생성합니다.

생성된 PRD는 다음과 같은 기능을 갖춘 세컨드 브레인을 구축하기 위한 단계별 청사진을 사용자(또는 코딩 에이전트)에게 제공합니다:

기억(Remembers): 결정 사항, 선호도, 컨텍스트를 모두 마크다운(markdown) 파일에 저장하여 세션 간에 유지합니다.
연결(Connects): Gmail, Slack, Calendar, Asana, Linear, GitHub 등 사용자의 플랫폼과 연결합니다.
능동적 모니터링(Proactively monitors): 30분마다 이메일, 캘린더, 작업을 능동적으로 모니터링합니다.
채팅(Chats): Slack(또는 Discord, 또는 기타 메시징 플랫폼)을 통해 사용자와 채팅합니다.
검색(Searches): 하이브리드 키워드(keyword) + 시맨틱 검색(semantic search)을 통해 수개월 분량의 메모리를 검색합니다.
초안 작성(Drafts): 과거 메시지에 대한 RAG(Retrieval-Augmented Generation)를 사용하여 사용자의 말투로 답장 초안을 작성합니다.
습관 추적(Tracks habits): '아주 작은 습관의 힘(Atomic Habits)'에서 영감을 받은 일일 알림(nudges)으로 습관을 추적합니다.

.claude/skills/create-second-brain-prd/ 디렉토리를 프로젝트로 복사하세요:

# 이 저장소를 클론(Clone)합니다
git clone https://github.com/coleam00/second-brain-starter.git
# 스킬을 프로젝트로 복사합니다
...

또는 이 저장소의 .claude/ 폴더를 기존 프로젝트로 바로 복사해도 됩니다.

템플릿을 워크스페이스로 복사하고 내용을 작성하세요:

cp .claude/skills/create-second-brain-prd/my-second-brain-requirements.md \
./my-second-brain-requirements.md

템플릿은 8개의 섹션으로 구성되어 있습니다:

About You (당신에 대하여)

• 이름, 역할, 시간대(timezone)

Your Platforms (사용 플랫폼)

• 사용하는 도구들 (Gmail, Slack, Linear 등)

Top Tasks (주요 작업)

• AI가 선제적으로 처리하기를 원하는 3~5가지 사항

Proactivity Level (선제성 수준)

• 관찰자 (Observer), 조언자 (Advisor), 비서 (Assistant), 또는 파트너 (Partner)

Security Boundaries (보안 경계)

• 에이전트가 허가 없이 절대 수행해서는 안 되는 작업

Memory Categories (기억 카테고리)

• 당신에게 중요한 지식의 유형

Infrastructure (인프라)

• 운영체제 (OS), 로컬 (local) 대 가상 사설 서버 (VPS) 배포 여부

Integration Priority (통합 우선순위)

• 가장 먼저 구축할 3가지 통합 항목

완성된 예시는 skill 디렉토리에 있는 example-my-second-brain-requirements.md를 참조하세요.

프로젝트에서 Claude Code를 열고 다음을 실행하세요:

/create-second-brain-prd ./my-second-brain-requirements.md

Claude는 다음을 수행합니다:

• 당신의 요구사항(requirements)을 읽습니다.
• 아키텍처 참조 블루프린트 (architecture reference blueprint)를 로드합니다.
• 웹 검색을 통해 당신의 스택에 있는 모든 도구와 API를 조사합니다.
• .agent/plans/second-brain-prd.md에 개인화된 9단계 PRD (제품 요구사항 문서)를 생성합니다.

PRD의 각 단계를 따르세요. 각 단계에는 다음 내용이 포함됩니다:

• 무엇을 왜 구축해야 하는가
• 생성할 주요 파일 (경로 포함)
• 이전 단계에 대한 의존성 (Dependencies)
• 복잡도 추정치 (Complexity estimate)
• 당신의 답변을 바탕으로 한 개인화 노트

권장되는 구축 순서:

단계 (Phase)	내용 (What)	복잡도 (Complexity)
1	메모리 레이어 (Memory Layer) (SOUL.md, USER.md, MEMORY.md, 일일 로그)	낮음 (Low)
...

세컨드 브레인 (second brain)은 Claude Code와 Claude Agent SDK를 기반으로 구축됩니다. 거대한 프레임워크는 사용하지 않습니다. 오직 마크다운 (markdown) 파일, 파이썬 (Python) 스크립트, 그리고 옵시디언 (Obsidian) 보관함 (vault)만 사용합니다.

메모리 레이어 (Memory Layer) (모든 것의 중심)
SOUL.md - 에이전트의 성격, 가치관, 경계
USER.md - 당신의 프로필, 계정, 선호도
...

요구사항 템플릿에서의 선택이 전체 시스템을 형성합니다:

수준 (Level)	기능 (What It Does)
관찰자 (Observer)	알림만 제공합니다. 절대 행동을 취하지 않습니다.
조언자 (Advisor)	당신의 검토를 위해 이메일/메시지 초안을 작성합니다. 제안과 함께 습관을 추적합니다.
비서 (Assistant)	파일을 자동 정리하고 결정을 자동 기록합니다. 외부 작업이 필요할 때 요청합니다.
파트너 (Partner)	저위험 메시지를 보내고 일상적인 작업을 완료합니다. 되돌릴 수 없는 작업에 대해서만 요청합니다.

전체 워크숍 (Full workshop): 모든 모듈을 다루는 4시간 실습 워크숍에 참여하려면 Dynamous 커뮤니티에 가입하세요.
Claude Agent SDK: 문서 (Documentation)
Obsidian: obsidian.md