# CLAUDE.md

이 저장소는 사용자의 **Logseq 루트 그래프**다. 학습 노트(전공공부·코딩·영어)를 정리하며, logseq-anki-sync 플러그인으로 Anki와 연동되어 있다.

## 작업 흐름 (중요)

1. 사용자가 먼저 학습한다 (PDF 등 원자료 기준).
2. Claude가 내용을 정리해 페이지에 작성한다.
3. 사용자가 그 정리를 바탕으로 직접 다듬고 **Anki 카드는 사용자가 직접 만든다**.

→ 따라서 Claude는 **카드 문법(`#card`, `{{cloze ...}}`, `{{c1 ...}}`, `extra::`, `#+BEGIN_EXTRA`)을 새로 추가하지 않는다.** 일반 정리 텍스트만 작성한다. 기존에 있는 카드 문법과 `id::` 속성은 절대 수정·삭제·복제하지 않는다.

## 디렉토리 구조

- `pages/` — 모든 노트. Logseq 특성상 하위 폴더 없이 평면 구조.
- `journals/` — 저널 (현재 비어 있음).
- `assets/` — 이미지·PDF. 페이지에서 `../assets/파일명` 상대경로로 참조.
- `logseq/` — Logseq 설정 (`config.edn`, `custom.css`, `bak/`). **건드리지 않는다.**
- `pages/hls__*.md` — PDF 하이라이트용 자동 생성 페이지. **직접 수정하지 않는다.**

## 페이지 계층 (허브 구조)

```
📋 Index Page
├── 🔤 영어공부 → 영어기초강의(성정혜), 토익 오답노트류, 토익팁, 부록
├── 👩🏻‍💻코딩 지식_팁 정리 → 알고리즘, 자료구조, 언어별 팁(Python, Java 등)
└── 📚전공공부 → 스트랭 선형대수학 6판 → 1장 백터와 행렬, 2장 선형방정식 풀기
```

- 허브 페이지는 `- [[하위 페이지]]` 링크 목록만 담는다.
- 새 과목/단원 페이지를 만들면 상위 허브 페이지에 링크를 추가한다.

## Logseq 문법 규칙

- 모든 내용은 불릿(`- `)으로 시작하는 outline 구조. 들여쓰기는 **탭** 사용.
- 페이지 속성은 파일 최상단에 `key:: value` (예: `deck:: Logseq/전공공부/선형대수학`). 기존 `deck::` 속성은 유지한다.
- 페이지 링크 `[[페이지명]]`, 이미지/PDF 임베드 `![이름](../assets/파일명)`.
- 수식은 LaTeX: 인라인 `$...$`, 블록 `$$...$$`.
- 언어는 한국어. 수학·전문 용어는 필요시 영어 병기.

## 정리 스타일 (기존 노트 기준)

`다익스트라 알고리즘` 페이지가 대표 예시. 개념 단위 페이지는 다음 형식을 따른다:

```
- ## 1. 개념 (Concept)
- ## 2. 동작 원리 / 주요 내용
- ## 3. 예제 / 코드
- ## 4. 부가 사항 (시간복잡도 등)
```

- 굵은 글씨(`**...**`)로 핵심 용어 강조.
- 코드는 언어 표기한 코드블록으로.

## 현재 진행: 선형대수학 (스트랭 6판)

- `1장 백터와 행렬.md`, `2장 선형방정식 풀기.md`에 OCR PDF가 링크되어 있다 (`assets/1장_벡터와_행렬OCR_*.pdf`, `assets/2장_선형방정식_풀기OCR_*.pdf`).
- 단원 정리는 해당 단원 페이지의 PDF 링크 **아래에** 불릿으로 작성한다.
- 각 단원 페이지 최상단 `deck:: Logseq/전공공부/선형대수학`을 유지한다.
- 참고: 페이지 파일명 "백터"는 "벡터"의 오타지만 **기존 파일명·링크는 바꾸지 않는다** (링크 깨짐 방지). 본문 새 작성 시에는 "벡터"로 쓴다.

## 금지 사항

- 기존 페이지 파일명 변경 금지 (Logseq 링크가 깨진다).
- `id::` UUID 수정·복제 금지 (Anki 동기화가 깨진다).
- `logseq/` 설정, `hls__*` 페이지, `assets/` 기존 파일 수정·삭제 금지.
- Anki 카드 문법 추가 금지 (사용자가 직접 만든다).

## Git

- 사용자는 `logseq YYYYMMDD` 형식으로 스냅샷 커밋을 해왔다.
- 작업 후 워킹 트리를 깨끗하게 유지한다. 커밋은 사용자가 요청할 때만.
- `.DS_Store`, `._*`(macOS AppleDouble 파일 전체), `bak/`은 gitignore 처리되어 있다. 이 외장 SSD에서는 macOS가 `._*` 파일을 수시로 생성하므로, git 변동사항에 `._`로 시작하는 파일이 보이면 추적 대상에서 빠졌는지 확인한다 (`git rm --cached`).