My Second Brain

CONVENTIONS — 세컨드브레인 규칙

Properties2
tagsmeta/conventions
aliases규칙, 스키마, conventions

11 min read

CONVENTIONS — 세컨드브레인 단일 진실 소스

이 문서는 vault의 모든 노트가 따라야 하는 규칙이다. organize-inbox 스킬과 Claude Code의 모든 정리·질의 작업은 매번 이 문서를 먼저 읽고 그대로 적용한다. 규칙이 바뀌면 여기만 고친다.

1. 폴더 구조 (PARA)

폴더의미들어가는 것판단 기준
00-Inbox/미분류 원본던져진 이메일·PDF·메모·회의록아직 처리 안 됨. 처리 후 비운다
01-Projects/프로젝트명확한 목표 + 완료/마감 조건이 있는 능동적 작업”끝”이 정의되는가? → Yes
02-Areas/영역지속적으로 관리하는 책임 영역 (마감 없음)건강·재무·팀운영·커리어처럼 계속 유지하는가?
03-Resources/자료관심 주제·참고자료 (행동과 무관)언젠가 쓸모 있는 지식·레퍼런스인가?
04-Archive/보관완료·비활성·대체된 노트더 이상 능동적이지 않은가? 삭제 대신 여기로 이동
04-Archive/_raw/원본 보관처리 완료된 Inbox 원본 파일요약 노트를 만든 뒤 출처 보존용
_meta/메타CONVENTIONS·템플릿·MOCvault 운영 자체에 관한 것

판단 순서: 행동이 필요한가? → Yes면 마감이 있나?(Yes=Project / No=Area). 행동 무관이면 Resource. 끝났으면 Archive.

2. 파일 이름 규칙 (= 슬러그 = URL/그래프 id)

파일명이 곧 웹 URL과 **그래프 노드 id(슬러그)**가 된다. 비ASCII(한글·×·—·· 등)가 들어가면 퍼센트 인코딩되어 우측 로컬 그래프가 깨진다(이웃 노드 미표시 + %EA%B2… 인코딩 라벨). URL도 지저분해진다. 그래서 파일명은 영어 ASCII만 쓴다.

  • 파일명 = 영어 소문자 kebab-case 슬러그 (a-z 0-9 -만). 예: home-server-setup.md, q3-marketing-campaign-retro.md.
  • 이벤트성(회의·이메일·일지)은 날짜 접두사 유지: YYYY-MM-DD-topic-slug.md (예: 2026-06-02-project-kickoff.md).
  • 사람 노트도 로마자 슬러그: 김민준 → kim-minjun.md.
  • 제목(title)·본문·태그 값은 한국어 그대로 둔다(§3·§7). 파일명만 영어다. (그래프 노드 라벨은 title을 따르므로 한국어로 보인다.)
  • 공백·비ASCII·특수문자(/ : * ? " < > |) 금지. 단어 구분은 하이픈(-).
  • 한국어 명칭으로 검색·링크가 필요하면 그 명칭을 aliases에 넣는다(선택).

3. 프론트매터 스키마 (모든 노트 공통)

---
title: 표시 제목 (한국어 OK)
type: meeting | email | summary | reference | person | project | area | resource | moc | daily
para: inbox | project | area | resource | archive
status: active | done | archived
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags: [topic/...]        # 계층형 태그 권장: work/marketing, study/ml
aliases: []              # 검색/링크용 별칭
source: "[[원본 캡처 노트]]"   # 출처 (선택)
---

규칙

  • 프론트매터 키 이름과 enum 값은 영어로 고정 (툴 호환·AI 일관성). 본문·title·tags 값은 한국어 OK.
  • type과 para는 위 enum에서만 선택.
  • created는 처음 만든 날, updated는 마지막 수정일. 수정 시 updated 갱신.
  • status: active(진행/유효) → done(완료) → archived(보관됨, Archive 폴더로 이동 시).

type 값 의미

type용도
meeting회의록
email이메일 정리
summaryPDF/문서/기사 요약
reference개념·사실·참고 지식
person사람 (연락처·맥락·이력)
project프로젝트 허브 노트
area영역 허브 노트
resource자료 허브/모음
mocMap of Content (인덱스 노트)
daily일지

4. 타입드 링크 = 그래프의 “동사” (본문 내 인라인 필드)

네이티브 Obsidian 그래프는 엣지에 라벨을 못 단다. 그래서 관계의 의미를 인라인 Dataview 필드로 저장한다.
형식: 필드명:: [[대상 노트]] (한 줄에 하나, 본문 상단 ”## 관계” 섹션에 모음).

필드의미 (동사)예시
up::~의 하위다 / 상위 노트up:: [[마케팅 영역]]
down::~를 포함한다 / 하위 노트down:: [[6월 캠페인]]
part_of::~에 속한다part_of:: [[세컨드브레인 구축]]
about::~에 관한 것이다 (사람·주제)about:: [[김민준]]
relates_to::~와 관련 있다 (일반)relates_to:: [[ML 스터디]]
references::~를 근거/출처로 한다references:: [[2026 시장보고서]]
supersedes::~를 대체한다 (옛 노트 → Archive)supersedes:: [[v1 기획안]]
  • 링크 대상은 영어 슬러그다(§2). 본문에 한국어로 보이게 하려면 [[english-slug|한국어 표시]] 형태로 쓴다(표시 생략 시 슬러그가 그대로 노출됨). 예: [[home-server-setup|홈서버 구축]].
  • 일반 본문 언급에는 평범한 위키링크를 자유롭게 쓴다. 의미가 중요한 관계만 타입드 링크로 명시.
  • up::/down::은 Breadcrumbs 플러그인이, 전체 타입드 엣지는 Juggl이 라벨 그래프로 시각화한다(선택).
  • supersedes::가 생기면 대상(옛) 노트를 04-Archive/로 이동하고 status: archived로 바꾼다.

5. 링크와 발견성 (MOC)

  • 모든 노트는 최소 1개 이상의 링크로 연결되어야 한다 (고아 노트 금지).
  • 새 노트는 관련 MOC(_meta/maps/)에 등록하거나, 상위 프로젝트/영역 노트에 down::으로 연결한다.
  • MOC = 특정 주제로 들어가는 “관문” 노트. index.md(Home)가 최상위 MOC.

5-1. 정방향(나가는) 링크 강제 — 백링크만으로 연결 금지 ⚠️

백링크(A→B면 B에서 A가 역으로 보임)는 그래프/플러그인에서만 보이고, 노트 본문을 읽을 땐 안 보인다. 사람이 노트를 따라 읽으며 탐색할 수 있어야 하므로, 연결은 양방향으로 본문에 명시한다.

  • 상위(Area/Project/MOC/hub) 노트는 연결된 하위·연관 노트로 나가는 링크를 본문에 반드시 가진다. “그 노트가 우리 Area를 링크하니 백링크로 찾으면 된다”는 금지. 새 Project/Resource를 만들어 상위 노트를 링크했다면, 같은 작업에서 상위 노트에도 그쪽으로 나가는 링크를 추가한다.
  • 나가는 링크를 넣는 위치(택1 이상): ## 관계의 down::/relates_to::, 본문의 ## 관련 추진 프로젝트·## 관련 자료·## 하위/연관 작업 섹션, 또는 최소한 ## 로그에 히스토리 한 줄(예: - 2026-06-22: [[새-노트]] 추가 — 한 줄 요약).
  • 즉 노트 본문만 읽고도 연결된 프로젝트·자료로 타고 들어갈 수 있어야 한다. 설명이든 히스토리든 어딘가 본문에 경로가 남아야 한다.

6. 삭제 정책 (중요)

  • 실제 파일 삭제(rm) 금지. 모든 “삭제”는 04-Archive/로 이동 + status: archived.
  • 중복/대체된 노트도 병합 후 옛 노트를 Archive로 이동(supersedes:: 기록).
  • 처리 완료된 Inbox 원본은 04-Archive/_raw/로 이동(출처 보존).

7. 언어

  • 노트 본문·제목·태그 값·MOC: 한국어.
  • 프론트매터 키, enum 값, 타입드 링크 필드명: 영어.

8. 이미지·첨부 (Quartz에서 안 깨지게 — 필수)

Quartz ignorePatterns에 **/_raw/** 가 있어 04-Archive/_raw/는 웹 배포에서 제외된다. 따라서 _raw의 이미지를 임베드하면 사이트에서 깨진다.

  • 표시(임베드)할 이미지·첨부는 반드시 content/assets/에 둔다. (Quartz가 배포하는 폴더) 절대 _raw/를 임베드하지 않는다.
  • 임베드 형식: ![[고유파일명.png]] — 파일명은 vault 전체에서 고유해야 한다(image.png 같은 일반명 금지, 의미있는 이름 + 필요시 접두사). ASCII·하이픈 권장.
  • 인박스 처리 시: 원본 파일은 _raw/로 보존하되, 노트에서 보여줄 figure는 content/assets/로 복사/이동해서 임베드한다.
  • 외부(피그마 등) 캡처를 노트에 넣을 때도 동일 — content/assets/에 저장 후 ![[...]].
  • 새 이미지를 넣은 뒤에는 임베드가 가리키는 파일이 assets/(또는 다른 비-ignore 경로)에 실제로 존재하는지 확인한다.
  • Quartz 비배포(ignore) 경로: private/, 04-Archive/_raw/, **/templates/**, .obsidian. 배포 경로: 노트 폴더 전부 + _meta/maps(MOC) + assets/.

그래프 뷰