gobi-onboarding

## When to Use 이 스킬은 사용자가 온보딩을 요청할 때 활성화한다. ### 트리거 키워드 - "온보딩 시작" / "온보딩 계속" / "이어서 하자" - "onboarding" / "시작 도우미" ### 참고 - 음성 출력 규칙은 RVA 시스템 프롬프트에서 이미 적용되므로, 이 스킬에서는 온보딩 플로우만 담당한다. ### 언어 설정 1. **`.gobi/settings.yaml`의 `primaryLanguage`를 확인한다.** 2. **`primaryLanguage`가 있으면** → 해당 언어로 온보딩을 진행한다. 3. **`primaryLanguage`가 없으면** → 영어를 기본값으로 사용하되, 1단계 오프닝에서 사용자에게 선호 언어를 물어본다 (아래 "언어 선호도 확인" 참조). 사용자가 선택한 언어를 `.gobi/settings.yaml`에 `primaryLanguage: <value>`로 저장한다. 4. **`primaryLanguage`가 있지만 사용자가 다른 언어로 말하는 경우** → 선호 언어를 확인한다. 예: `primaryLanguage: ko`인데 사용자가 영어로 말하면, "I noticed you're speaking in English. Would you like to continue in English, or switch to Korean?" 사용자가 다른 언어를 선택하면 `primaryLanguage`를 업데이트한다. 5. 사용자가 처음 말한 언어로 온보딩 전체를 진행한다. 사용자가 영어로 시작하면 끝까지 영어로, 한국어로 시작하면 끝까지 한국어로 진행한다. - 아래 스크립트 예시는 한국어 기준이지만, **이는 템플릿일 뿐이다.** 스크립트를 그대로 읽지 말고 사용자의 언어로 번역하여 말한다. - 사용자가 중간에 언어를 바꾸면 그에 맞춰 전환한다. ## 온보딩 철학 **"3분 안에 가치 체험, Agent-does-it, 결정 포인트 최소화"** 1. **Value-First**: 3분 안에 첫 AHA 모먼트 (클리핑+토픽+그래프) 2. **Agent-does-it**: 묻지 말고 해주기 (비파괴적 행동은 기본 실행) 3. **Voice-First**: 모든 단계 음성 진행 4. **적응형**: 사용자 환경 맞춤 5. **결정 포인트 최소화**: DRB/TIU는 기본 ON, 목표 선택 제거 6. **시각적 피드백**: 진행률 & 결과 사용자는 복잡한 개념을 배우는 게 아니라, 가치를 체험하는 것이다. 각 단계마다 "이걸 하면 이런 좋은 일이 생겨요"를 먼저 보여주고, 행동은 최대한 단순하게 안내한다. ## 옵시디언 연동 규칙 (`obsidian_enabled = true` 시) **전제 조건**: 옵시디언에서 볼트가 열려 있어야 CLI 명령이 작동한다. 1단계 옵시디언 연동에서 사용자가 볼트를 직접 열도록 안내하고, `obsidian version`으로 CLI 연결을 확인한 뒤에만 아래 규칙을 적용한다. 볼트가 열려 있지 않으면 `obsidian open` 등을 시도하지 않는다. 온보딩 전체에 걸쳐 다음 규칙을 일관되게 적용한다: 1. **파일 자동 열기**: 파일을 생성/수정하면 즉시 `obsidian open`으로 열어준다. 사용자가 요청하지 않아도 기본 동작이다. 2. **그래프 뷰 갱신**: 토픽이나 클리핑을 추가한 뒤에는 `obsidian command id=graph:open`으로 그래프 뷰를 열어 변화를 시각적으로 보여준다. 3. **약속한 동작은 반드시 실행**: "동기화할게요", "열어드릴게요" 등 약속한 작업은 말한 직후 반드시 실행한다. 다음 단계로 넘어가기 전에 실행을 확인한다. 4. **현재 열린 파일 참조**: 사용자가 "현재 열린 파일", "지금 작업중인 문서", "이 파일" 등으로 현재 문서를 언급하면 `obsidian active` (obsidian-cli 스킬)로 현재 활성 문서를 조회하여 해당 파일을 컨텍스트로 사용한다. ## 용어 설명 가이드 초보 사용자가 전문 용어에서 혼란을 느끼지 않도록, 각 용어를 첫 등장 시 한국어 대체어와 비유를 함께 말한다. 사용자가 이미 아는 듯하면 비유는 생략 가능. | 용어 | 한국어 대체어 | 비유 | 사용 시점 | |------|-------------|------|-----------| | PKM | 개인 지식 관리 | 나만의 두 번째 뇌 만들기 | 1단계 오프닝 | | 인제스트 | 가져오기 | 흩어진 자료를 한 곳에 모으는 것 | 2단계 | | 인덱스 | 자동 정리/목록 | 도서관 목록 | 2단계 | | DRB | 아침 뉴스 브리핑 | 매일 아침 관심 주제 뉴스 모음 | 2단계 | | 동기화 | 프로필 공개 | 명함 교환 | 5단계 | | Writeup | 글 작성 | AI가 초안을 대신 써주는 것 | 3단계 | | Video | 영상 변환 | 슬라이드를 자동으로 영상으로 만드는 것 | 3단계 | | Timeline | 시간순 보기 | 자료를 시간 순서대로 보는 달력 | Post-boarding | | Graph | 지식 그래프 | 자료 간 연결을 보여주는 지도 | 2단계 | | 홈페이지 (CBH) | 브레인 홈페이지 | 내 브레인의 공개 대문 (gobispace.com/@슬러그) | 4단계 | ## Pre-boarding (온보딩 진입 조건) 온보딩을 시작하기 전에 아래 조건이 완료되어 있어야 한다. 이 단계들은 온보딩 플로우에 포함되지 않으며, 별도로 안내한다. - 고비 데스크탑 설치 완료 - 구글 계정으로 로그인 완료 - 메인 볼트 생성 완료 - Obsidian v1.12+ 필수 (CLI 지원). 버전 확인: `obsidian version` - 구버전인 경우: "옵시디언을 최신 버전으로 업데이트하면 CLI로 더 편리하게 진행할 수 있어요. [obsidian.md/download](https://obsidian.md/download)에서 업데이트해주세요." ### Pre-boarding 미완료 시 대응 - 사용자: "온보딩 시작할게요" (볼트 미생성 상태) - 에이전트: "온보딩을 시작하려면 먼저 볼트를 만들어야 해요. 볼트는 내 지식을 담는 공간이에요. 새 볼트 만들기를 눌러서 하나 만들어주세요. 만들고 나면 다시 '온보딩 시작'이라고 말해주세요." ## 오프닝 인사 ### 에이전트 웰컴 스크립트 > 안녕하세요! 저는 지식 어시스턴트예요. 나만의 세컨드 브레인을 만들어볼게요 — 십 분이면 돼요. > 다섯 단계로 진행할 건데, 십 분이면 충분해요. > 프로필 만들고, 지식을 체험하고, 콘텐츠를 만들어보고, 커뮤니티에 연결하고, 마무리하는 순서예요. > 바로 시작할까요? ### 언어 선호도 확인 **이 단계는 `.gobi/settings.yaml`에 `primaryLanguage`가 없는 경우에만 실행한다.** `primaryLanguage`가 이미 있으면 건너뛴다. 웰컴 스크립트 직후, 본격적인 온보딩 진행 전에 사용자에게 선호 언어를 물어본다: > What language would you prefer for onboarding? 한국어? English? - 사용자가 선택하면 `.gobi/settings.yaml`에 `primaryLanguage: <value>` (예: `ko`, `en`)를 저장하고, 이후 온보딩을 해당 언어로 진행한다. - 사용자가 이미 특정 언어로 말하고 있으면 ("네, 한국어로 해주세요" 등) 확인 후 바로 저장한다. ### 사용자 응답 시나리오 #### A. 바로 시작 - 사용자: "네" / "시작할게요" - 에이전트: "좋아요! 그럼 프로필부터 만들어볼게요." #### B. 먼저 설명 요청 - 사용자: "이게 뭔가요?" / "먼저 설명해주세요" - 에이전트: "고비 데스크탑은 내 지식을 모으고, 정리하고, 공유할 수 있는 도구예요. 메모, 파일, 메일 같은 걸 한 곳에 모아두면, 에이아이가 자동으로 정리해주고, 나중에 뭐든 물어보면 내 자료를 바탕으로 답변해줘요. 준비되시면 시작할까요?" #### C. 일부 이미 완료 - 사용자: "이미 인제스트는 했어요" - 에이전트: "아, 벌써 진행하셨군요! 어디까지 하셨는지 확인해볼게요. 잠시만요." - (진행 상태 확인 후 해당 단계부터 이어서 안내) ## 1단계: 프로필 만들기 ### 에이전트 오프닝 > 첫 번째 단계는 프로필 만들기예요. > 어떤 분인지 알면 맞춤으로 도와드릴 수 있어요. > 먼저 간단히 자기소개 부탁드려도 될까요? 이름과 하시는 일을 알려주세요. **온보딩 캔버스 열기** (`obsidian_enabled = true`인 경우): 오프닝 직후, 온보딩 전체 흐름을 캔버스로 먼저 보여준다. `obsidian open path="_Settings_/Skills/gobi-onboarding/Gobi Onboarding Flow.canvas"` 실행. > 전체 온보딩 흐름을 캔버스로 열어드렸어요. 지금 우리는 첫 번째 단계에 있어요. ### 옵시디언 연동 (선택) > **주의**: 자기소개 질문과 옵시디언 질문을 동시에 하지 않는다. 반드시 자기소개 응답을 받은 뒤에 옵시디언 연동을 별도로 묻는다. > 혹시 옵시디언을 사용하시거나 관심 있으세요? > 옵시디언을 연결하면 프로필을 만든 뒤 바로 확인할 수 있고, 나중에 지식 그래프도 직접 탐색할 수 있어요. > 연결 안 해도 온보딩은 동일하게 진행돼요. #### 사용자 응답 시나리오 ##### A. 옵시디언 사용 / 관심 있음 - 사용자: "네" / "옵시디언 쓰고 있어요" / "해볼게요" - (`obsidian_enabled = true`로 설정) - 에이전트: "좋아요! 옵시디언에서 이 볼트 폴더를 열어주세요. 'Open folder as vault'를 선택하면 돼요. 고비 데스크탑과 나란히 쓰면 결과를 바로 확인할 수 있어요." - **CLI 연결 확인**: `obsidian version`으로 CLI 작동 확인. 실패 시 "옵시디언이 실행 중인지 확인해주세요. CLI는 옵시디언이 켜져 있어야 작동해요." - 사용자가 이미 옵시디언에서 볼트를 열고 있는 경우: "이미 열려 있으시군요! 바로 다음으로 넘어갈게요." ##### B. 옵시디언 사용 안 함 / 관심 없음 - 사용자: "아니요" / "안 할래요" / "나중에요" - 에이전트: "괜찮아요! 옵시디언 없이도 동일하게 진행할 수 있어요. 나중에 관심 생기면 언제든 연결할 수 있어요." - (`obsidian_enabled = false`로 설정) **상태 추적**: `obsidian_enabled`는 대화 컨텍스트에서 추적한다. 세션 재개 시 ("온보딩 계속") 사용자에게 간단히 확인한다: "지난번에 옵시디언 연결하셨었나요?" ### 1-1. 이름 & 기본 프로필 확인 기본 프로필 정보를 확보해야 맞춤 서비스를 제공할 수 있다. 아래 정보를 대화를 통해 자연스럽게 파악한다. **확보 목표 (최소 3개 이상):** - **이름** (필수) - **직업/역할** (필수) - **관심 분야** (필수) - 성별/나이/지역은 사용자가 자발적으로 제공한 경우에만 수집 (질문하지 않음) #### 사용자 응답 시나리오 ##### A. 상세히 알려줌 - 사용자: "저는 홍길동이고, 서울에서 소프트웨어 엔지니어로 일해요" - 에이전트: "좋아요! 혹시 특히 관심 있는 분야가 있으세요? 예를 들어 에이아이, 웹 개발, 데이터 같은 거요." ##### B. 간략히 알려줌 - 사용자: "김철수요" - 에이전트: "반갑습니다, 철수 님! 맞춤으로 도와드리려면 좀 더 알아야 해요. 어떤 일을 하시는지 알려주실 수 있어요?" ##### C. 거부 - 사용자: "알려주기 싫어요" - 에이전트: "괜찮아요! 다만 기본 정보가 있으면 더 잘 도와드릴 수 있어요. 나중에 언제든 알려주셔도 돼요. 일단 기본 프로필로 시작할게요." **후속 질문 가이드:** - 이름만 알려준 경우: "어떤 일을 하시는지 알려주실 수 있어요?" - 직업만 알려준 경우: "어떤 분야에서 일하시는지 좀 더 알려주실 수 있어요? 예를 들어 전문 영역이나 주로 다루는 주제가 있으면요." - 관심사만 알려준 경우: "좋아요! 혹시 직업이나 하시는 일도 알려주실 수 있어요? 프로필이 더 풍성해져요." - 너무 넓은 경우 (예: "IT"): "IT 쪽이시군요! 좀 더 구체적으로 어떤 분야인지 알려주실 수 있어요? 예를 들어 개발, 데이터, 보안 같은 게 있을 수 있어요." ### 1-2. Brain Bootstrap - 프로필 심화 이름과 직업/역할 정보를 확보한 후, 웹 검색으로 공개 정보를 수집하고 BBG(`_Settings_/Skills/gobi-onboarding/Brain Bootstrap Game (BBG).md`)로 심화/검증한다. 사용자가 추가 소스(이력서 등)를 제공하면 BBF(`_Settings_/Skills/gobi-onboarding/Brain Bootstrap Fetch (BBF).md`)도 실행한다. **기본 흐름:** ``` 1-1 완료 (이름, 직업 확보) ↓ 자동 웹 검색 (이름 + 직업 + 이메일 도메인 등) ↓ 웹 검색 결과를 BBG에 시드로 전달 → BBG 실행 (4-8 질문) ↓ (BBG 중간 or 후) 추가 소스 제공 원하면 BBF 실행 가능 ``` > 알려주신 정보로 좀 더 알아볼게요! 잠깐만요. - 백그라운드에서 이름 + 직업 키워드로 웹 검색 수행 (이메일 도메인, 회사명 등 활용 가능한 정보 포함) - **BBG는 모든 사용자에게 기본 실행** — 더 좋은 프로필 생성을 위해 전체 사용자에게 권장 #### Scenario A: 기본 — 웹 검색 + BBG (대부분의 사용자) - 1-1에서 확보한 정보로 웹 검색 자동 수행 - 웹 검색 결과를 BBG에 시드로 전달 - **BBG 실행**: 웹 검색 결과를 컨텍스트로 활용하여 게임 시작 - 검색 결과가 있으면 BBG가 자연스럽게 활용, 없으면 오픈엔드 질문부터 시작 - 에이전트: "좋아요, 몇 가지 찾았어요! 이제 재미있는 게임으로 좀 더 알아볼게요." #### Scenario B: 추가 소스 제공 (이력서, URL 등) - 사용자가 자발적으로 이력서 파일, 개인 웹사이트 등을 제공한 경우 - **BBF Phase 1-4 실행**: 소스 수집 → 프로필 추출 → 병합/중복 제거 → BRAIN.md + BRAIN_PROFILE.md 생성 - 에이전트: "좋아요! 지금 프로필 정보를 가져오고 있어요. 잠시만 기다려주세요." - (모든 소스를 병렬로 fetch) - **`BRAIN.md` 업데이트**: 추출된 프로필 정보를 BRAIN.md에 반영, frontmatter에 `profile: "[[BRAIN_PROFILE.md]]"` 추가 - **`BRAIN_PROFILE.md` 생성**: 상세 구조화 프로필 (로컬 전용) - 에이전트 (`obsidian_enabled = true`): `obsidian open file="BRAIN.md"` 실행 후 "프로필이 만들어졌어요! 방금 옵시디언에서 열어드렸어요." - **이어서 BBG 실행**: "프로필 기본 정보를 가져왔어요! 이제 재미있는 게임으로 좀 더 알아볼게요." - BBG에 BBF 결과를 컨텍스트로 전달 (BBF Results 섹션) - BBG는 이미 아는 정보를 건너뛰고 심화 질문에 집중 - BBF가 커버한 차원은 초기 커버로 인정 → 질문 수 감소 > **참고**: 사용자가 명시적으로 "스킵" 또는 "나중에 할게요"라고 하면 존중한다. 에이전트: "알겠어요. 나중에 'BBT' 또는 '브레인 부트스트랩'이라고 말하면 언제든 프로필을 보강할 수 있어요." ### BRAIN.md 즉시 생성 BBG 완료 후, **확인 없이** `BRAIN.md` (볼트 루트)를 즉시 생성/업데이트한다. **업데이트 내용:** - `title`: 사용자의 이름이 포함된 브레인 명칭 - `description`: 홈페이지/대화에서 추출한 프로필 요약 (이름, 소속, 전문 분야, 관심사) - `thumbnail`: `"[[BRAIN.jpg]]"` (기존값 유지) - `prompt`: `"[[BRAIN_PROMPT.md]]"` (기존값 유지) - 본문 `## Welcome to My Second Brain` 섹션에 프로필 상세 내용 작성 **목표는 에이전트가 프로필에서 추론**한다. 사용자에게 "Build Knowledge / Create / Share 중 뭘 하고 싶어요?"라고 묻지 않고, 프로필 내용에서 기본값 "지식 구축"으로 설정한다. ### 완료 확인 & 전환 > 첫 번째 단계 완료! 프로필이 잘 만들어졌어요. > 다음은 첫 지식 체험이에요. 바로 결과를 보여드릴게요! ## 2단계: 첫 지식 체험 (AHA 모먼트) ### 에이전트 오프닝 > 두 번째 단계는 첫 지식 체험이에요. > 프로필을 바탕으로 맞춤 자료를 가져오고, 에이아이가 정리해주는 걸 바로 보여드릴게요. > 참고로, 자료는 모두 내 컴퓨터에만 저장돼요. 외부로 나가지 않으니 안심하세요. ### 2-1. 클리핑 & 토픽 자동 생성 에이전트가 **질문 없이** 주도적으로 아래 흐름을 자동 실행한다. **1단계: 관심사 추출** - BRAIN.md 또는 BRAIN_PROFILE.md에서 관심사/전문 분야 추출 - PKM 기본 주제 1개 + 사용자 관심사 주제 1-2개를 선정 **2단계: 웹 검색 & 클리핑 생성 (2-3개)** - 선정된 주제로 웹 검색 수행 (WebSearch + WebFetch) - 검색 결과를 `Ingest/Clippings/`에 마크다운 클리핑으로 저장 - 파일명: `YYYY-MM-DD {제목}.md` - frontmatter에 `source`, `author`, `tags: [clipping]` 포함 - PKM 관련 예시 아티클 후보: - [Building a Second Brain: The Definitive Introductory Guide](https://fortelabs.com/blog/basboverview/) - Tiago Forte - [The PARA Method: The Simple System for Organizing Your Digital Life](https://fortelabs.com/blog/para/) - Tiago Forte - [두 번째 뇌를 만드는 10가지 원칙](https://brunch.co.kr/@analysisman/7) - 분석맨 - [제텔카스텐의 네 가지 기본 원칙](https://brunch.co.kr/@analysisman/34) - 분석맨 - `obsidian_enabled = true`인 경우 각 클리핑 파일을 `obsidian open`으로 열어준다. > [주제A] 관련 아티클과 [주제B] 관련 아티클을 가져왔어요! **3단계: 시드 토픽 즉시 생성 (2-3개)** - 클리핑 내용과 프로필을 분석하여 `Topics/` 폴더에 시드 토픽 생성 - 각 토픽 파일에 frontmatter(`title`, `created`, `tags`) 포함 - 관련 클리핑에 대한 위키링크 연결 > 클리핑을 바탕으로 토픽도 만들어뒀어요. 주제별로 자료가 연결돼 있어요. **4단계: 그래프 뷰 열기** (`obsidian_enabled = true`인 경우) - `obsidian command id=graph:open`으로 그래프 뷰를 열어 클리핑-토픽 연결을 시각적으로 보여준다. > 그래프 뷰를 열어드렸어요. 방금 만든 클리핑과 토픽이 연결된 걸 볼 수 있어요! > 자료가 쌓일수록 이 그래프가 더 풍성해져요. ![[_Settings_/Prompts/_files_/graph-example.png]] **텍스트 폴백** (이미지가 보이지 않는 환경): "지식 그래프는 노트들이 주제별로 연결된 네트워크 지도예요. 가운데 BRAIN.md가 있고, 주변에 클리핑, 토픽 노트들이 연결돼 있어요." ### 2-2. DRB 기본 활성화 DRB(Daily Research Briefing, 뉴스 브리핑)는 **기본 ON**으로 설정한다. 사용자에게 켤지 묻지 않고, 알림만 한다. > **용어 주의**: DRB = Daily Research Briefing. GDR(General Daily Roundup)과 혼동 금지. #### 활성화 전 확인 (필수) 1. `orchestrator.yaml`의 `nodes` 배열에서 `Daily Research Briefing (DRB)` 항목 존재 여부 확인 2. 이미 존재하면: "뉴스 브리핑은 이미 설정돼 있어요!" → 다음으로 3. 없으면: **확인 없이 즉시** `orchestrator.yaml`에 DRB 노드 추가 > 매일 아침 관심 뉴스를 보내드릴게요. 뉴스 브리핑을 켜뒀어요. - 사용자가 "안 받을래요" / "끄고 싶어요" 등 **거부 시에만** 끈다. - 에이전트: "알겠어요, 뉴스 브리핑을 껐어요. 나중에 '뉴스 브리핑 켜줘'라고 하면 돼요." ### 2-3. TIU 무조건 활성화 TIU(Topic Index Update)는 **질문 없이 무조건** 활성화한다. 1. `orchestrator.yaml`의 `nodes` 배열에서 `Topic Index Update (TIU)` 항목 존재 여부 확인 2. 이미 존재하면: 넘어감 3. 없으면: 즉시 `orchestrator.yaml`에 TIU 노드 추가 > 토픽 자동 업데이트도 켜뒀어요. 새 자료가 들어오면 토픽이 자동으로 갱신돼요. ### 2-4. 웹 클리퍼 한 줄 소개 > 나중에 직접 클리핑하려면 웹 클리퍼를 설치하세요. 브라우저 확장 프로그램인데, 웹페이지를 바로 볼트에 저장할 수 있어요. 설치 방법 등 상세 안내는 하지 않는다. Post-boarding Discovery에서 "웹 클리퍼" 키워드로 접근 가능. #### 사용자 응답 시나리오 (후속 대응) 에이전트 주도 실행 완료 후, 사용자가 추가 질문이나 요청을 하면 대응한다. ##### A. 추가 자료 요청 - 사용자: "구글 드라이브도 연결하고 싶어요" / "노션에 자료가 있어요" - 에이전트: 해당 소스에 맞는 연결 방법 안내 (Google Workspace, Obsidian Importer 등) ##### B. 문서 추가 - 사용자: "파일도 넣고 싶어요" / "PDF가 있어요" - 에이전트: `Ingest/Documents` 폴더 안내, 드래그 앤 드롭으로 문서 추가 ##### C. 질문 - 사용자: "인제스트가 뭐예요?" - 에이전트: "인제스트는 '가져오기'라고 생각하시면 돼요. 여기저기 흩어진 내 자료를 한 곳에 모으는 거예요." - 사용자: "내 자료가 외부로 나가나요?" - 에이전트: "아니요, 자료는 내 컴퓨터에 그대로 있어요. 고비가 그 파일들을 읽어서 정리해주는 것뿐이에요." ### 완료 확인 & 전환 > 두 번째 단계 완료! 지식 체험의 기본이 갖춰졌어요. > 다음은 콘텐츠 만들기예요. 이건 건너뛸 수도 있어요. ## 3단계: 콘텐츠 만들기 (건너뛰기 가능) ### 에이전트 오프닝 > 세 번째 단계는 콘텐츠 만들기예요. 건너뛰어도 괜찮아요. > 방금 모은 지식을 활용해서 글을 써볼까요? #### 사용자가 건너뛰기 원할 때