| name | genos-knowledge-capture |
| description | Use when GenOS 작업에서 얻은 재사용 가능한 지식(플랫폼 패턴·함정·고객사 결정)을 개인 Obsidian vault(Projects/GenonAI)에 기록할 가치가 생겼거나, GenOS 작업 맥락에서 사용자가 "지식 캡처", "vault에 정리/기록", "MOC", "읽는 순서", "field note", "/genos-knowledge-capture"를 요청할 때 사용. Do NOT use for: GenOS와 무관한 노트, 웹 리서치 기반 일반 개념 노트, 단순 진행상황·세션 상태. |
GenOS Knowledge Capture
GenOS 현장 작업(FDE)에서 한 번 배운 걸 다음 세션·다음 고객사에서 다시 파헤치지 않도록 만드는 개인 스킬이다. AI의 세션 기억은 끊기지만, vault에 원자적 노트로 남기고 MOC(허브)와 카테고리별 읽는 순서에서 엮어두면 새 세션이 필요한 노트를 발견하고, 처음 읽을 순서까지 빠르게 잡는다.
이 스킬은 사용자 개인 자산(~/.claude/skills/)이다. 회사 레포의 .claude/skills/genos-*(genos-session-close 등)는 회사 공유 자산이라 절대 건드리지 않는다. 세션 상태는 회사 HANDOFF가, 재사용 지식은 이 스킬이 담당한다 — 둘은 분리된 관심사다.
노트 본문 형식(frontmatter 규약, 8섹션 spine, Mermaid·문체 규칙)은 references/note-format.md에 있다. 워크플로우 4단계에서 그 파일을 읽고 따른다.
핵심 원칙 (왜 이렇게 하나)
① 온보딩 가속의 실체는 MOC + 읽는 순서다. "그래프뷰가 예쁜 것"이 아니라 작은 진입점(MOC)을 먼저 읽고, 거기서 오늘 필요한 노트를 발견한 뒤, 카테고리별 읽는 순서로 무엇부터 볼지 정하는 것이다. AI는 Obsidian 그래프를 순회하지 못한다. 그래서 이 스킬은 늘 세 가지를 함께 한다: 원자적 노트 작성 + MOC에 링크 추가 + [[GenOS 카테고리별 읽는 순서]] 반영 검토. MOC에 안 걸린 노트는 발견되지 않고, 읽는 순서에 안 걸린 노트는 처음 보는 사람이 언제 읽어야 할지 모른다.
② 재사용 가능한 일반화만 담는다. 토큰 절감은 "재탐색(re-grep·재독)을 대체할 때 + 선택적으로 1~2개만 읽을 때"만 생긴다. 그러니 노트엔 패턴·함정·결정만 담고, "오늘 무슨 파일 고쳤는지" 같은 휘발성 상태는 vault에 넣지 않는다(노이즈만 쌓인다).
③ 1차 독자는 "이 기술을 처음 보는 사람"이다. 노트는 입사 직후의 동료나 다음 세션의 AI가 이 문서 한 장만으로 개념을 잡고 GenOS에서의 위치를 이해할 수 있는 자기완결 field note다. 먼저 사람이 읽는 흐름으로 열고, 판단·분기·함정은 bullet·표·Mermaid로 스캔 가능하게 만든다. 형식 상세는 references/note-format.md.
3계층 — 무엇을 캡처하고 무엇을 버리나
캡처 후보가 생기면 먼저 어느 계층인지 판별한다. 계층을 섞지 않는 것이 vault가 비대해져도 길을 잃지 않는 유일한 규칙이다.
