From 35593e2f7a581e14fa9a6ad672463a977ebe1252 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B9=80=EA=B2=BD=EC=A2=85?= Date: Fri, 17 Apr 2026 11:11:12 +0900 Subject: [PATCH] modify template --- .gemini/commands/wiki/connect.toml | 2 +- .gemini/settings.json | 4 ++-- .../references/source-type-playbooks.md | 8 +++---- CLAUDE.md | 7 ------ GEMINI.md | 15 ++++++------ Karpathy llm wiki 핵심규칙 10가지.md | 22 ++++++++--------- README.md | 24 ++++++++++++++++++- output/CLAUDE.md | 6 ----- raw/CLAUDE.md | 6 ----- raw/GEMINI.md | 7 +++--- raw/articles/description.md | 3 +++ raw/books/description.md | 3 +++ raw/ideas/description.md | 3 +++ raw/papers/description.md | 3 +++ raw/templates/webclipper_research.json | 8 +++---- raw/templates/컴파일_프롬프트.md | 14 +++++------ raw/videos/description.md | 3 +++ raw/work/description.md | 3 +++ wiki/CLAUDE.md | 6 ----- wiki/log.md | 1 + 사용법.md | 1 + 21 files changed, 84 insertions(+), 65 deletions(-) delete mode 100644 CLAUDE.md delete mode 100644 output/CLAUDE.md delete mode 100644 raw/CLAUDE.md create mode 100644 raw/articles/description.md create mode 100644 raw/books/description.md create mode 100644 raw/ideas/description.md create mode 100644 raw/papers/description.md create mode 100644 raw/videos/description.md create mode 100644 raw/work/description.md delete mode 100644 wiki/CLAUDE.md diff --git a/.gemini/commands/wiki/connect.toml b/.gemini/commands/wiki/connect.toml index f561206..9dba9c8 100644 --- a/.gemini/commands/wiki/connect.toml +++ b/.gemini/commands/wiki/connect.toml @@ -7,7 +7,7 @@ prompt = """ 작업 방식: 1. `wiki/index.md`에서 관련 개념 후보를 찾는다. -2. 관련 `wiki/` 페이지를 읽어 공통점, 긴장점, 빈틈을 정리한다. +2. 관련 `wiki/` 페이지를 읽어 공통점, 차이점, 누락, 보완 관계를 정리한다. 3. 사실로 확인된 내용, 관계 구조, 통합 해석을 분리해서 쓴다. 4. 가능하면 서로 다른 두 개 이상의 소스 축을 연결한다. 5. 결과가 재사용 가능하면 새로운 `wiki/` 연결·융합 페이지가 필요한지도 판단한다. diff --git a/.gemini/settings.json b/.gemini/settings.json index 7c67f86..23c3490 100644 --- a/.gemini/settings.json +++ b/.gemini/settings.json @@ -12,7 +12,7 @@ { "name": "protect-raw-sources", "type": "command", - "command": "node \"$GEMINI_PROJECT_DIR/.gemini/hooks/protect-raw-sources.cjs\"", + "command": "node .gemini/hooks/protect-raw-sources.cjs", "timeout": 5000, "description": "Prevent the agent from mutating raw/ sources." } @@ -26,7 +26,7 @@ { "name": "wiki-write-reminder", "type": "command", - "command": "node \"$GEMINI_PROJECT_DIR/.gemini/hooks/wiki-write-reminder.cjs\"", + "command": "node .gemini/hooks/wiki-write-reminder.cjs", "timeout": 5000, "description": "Remind the agent to keep wiki/index.md and wiki/log.md in sync." } diff --git a/.gemini/skills/llm-wiki-operator/references/source-type-playbooks.md b/.gemini/skills/llm-wiki-operator/references/source-type-playbooks.md index bf4e6b4..e8cf774 100644 --- a/.gemini/skills/llm-wiki-operator/references/source-type-playbooks.md +++ b/.gemini/skills/llm-wiki-operator/references/source-type-playbooks.md @@ -12,14 +12,14 @@ - 영상의 핵심 주장 또는 방법론은 무엇인가 - 타임스탬프별 핵심 포인트가 있는가 -- 내 관심사와 연결되는 지점은 무엇인가 +- 내 정리 기준과 연결되는 지점은 무엇인가 - 실천 가능한 인사이트는 무엇인가 ## Podcast - 게스트/호스트의 핵심 관점은 무엇인가 - 기억할 만한 발언이나 직접 인용은 무엇인가 -- 내 관심사와의 연결점은 무엇인가 +- 내 정리 기준과의 연결점은 무엇인가 ## Book — 1패스 @@ -36,12 +36,12 @@ - 문서 구조화, 개념 연계, 자료 융합, AI 활용과 어떤 연결이 있는가 - 기존 wiki 페이지와 어떤 개념 링크를 만들 수 있는가 -## Research +## Research / Paper - 연구 질문과 방법론은 무엇인가 - 핵심 발견과 데이터는 무엇인가 - 한계점은 무엇인가 -- 내 관심사와 연결되는 활용 가능성은 무엇인가 +- 내 프로젝트의 개념, 방법론, 모델, 검증, 구현과 연결되는 활용 가능성은 무엇인가 ## Batch Compile diff --git a/CLAUDE.md b/CLAUDE.md deleted file mode 100644 index b9208df..0000000 --- a/CLAUDE.md +++ /dev/null @@ -1,7 +0,0 @@ -# Legacy Notice - -이 프로젝트의 기본 컨텍스트 파일은 이제 `CLAUDE.md`가 아니라 `GEMINI.md`다. - -- Gemini CLI는 루트와 하위 폴더의 `GEMINI.md`를 읽는다. -- 자동화는 `.gemini/commands/`, `.gemini/skills/`, `.gemini/agents/`, `.gemini/settings.json`을 사용한다. -- 최신 작업 기준은 [GEMINI.md](./GEMINI.md)를 참조한다. diff --git a/GEMINI.md b/GEMINI.md index cb99910..0ec3ff1 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -1,16 +1,16 @@ -# GEMINI.md — 찬물샤워의 옵시디언 볼트 +# GEMINI.md — 나의 옵시디언 볼트 ## 나는 누구인가 -- **이름:** 찬물샤워 -- **하는 일:** CAD/건축/인프라 BIM 소프트웨어 개발자 (Data Structure + OOP 기반) +- **하는 일:** 구조해석을 위한 유한요소법 기반 솔버 개발자 - **핵심 가치:** 문서를 체계적으로 정리하고, 지식 간 관계를 연계·융합하여 재사용 가능한 구조를 만든다 ## 나의 역할들 -### BIM 소프트웨어 개발자 -- CAD 및 건축·인프라 BIM 소프트웨어 개발 -- Data Structure 설계, OOP 기반 기능 구현 +### 구조해석 인하우스 솔버 개발자 +- 구조해석 유한요소 솔버 개발 +- 구조해석에 필요한 Utility 개발 +- 구조해석 지식들을 정식화 및 문서화 - 개발 과정에서 발생하는 암묵지를 옵시디언에 축적 ### 지식 구조화 실천가 @@ -44,9 +44,10 @@ LLMWiki/ ├── raw/ ← 불변 원본 (절대 수정 금지) │ ├── articles/ ← 웹 아티클, 블로그 │ ├── books/ ← 책 발췌, 독서 노트 +│ ├── papers/ ← 논문, 연구자료, 기술 리포트 │ ├── videos/ ← 영상 대본, 트랜스크립트 │ ├── ideas/ ← 순간 아이디어, 메모 -│ └── work/ ← BIM 개발 업무 기록, 암묵지 +│ └── work/ ← 업무 기록, 암묵지 ├── wiki/ ← AI가 컴파일하는 위키 │ ├── index.md ← 마스터 목록 (질의 시 최우선 참조) │ └── log.md ← 모든 변경 기록 diff --git a/Karpathy llm wiki 핵심규칙 10가지.md b/Karpathy llm wiki 핵심규칙 10가지.md index f955264..2733ca1 100644 --- a/Karpathy llm wiki 핵심규칙 10가지.md +++ b/Karpathy llm wiki 핵심규칙 10가지.md @@ -1,12 +1,12 @@ -Karpathy LLM Wiki 핵심 규칙 10가지 +# Karpathy LLM Wiki 핵심 규칙 10가지 -1. **raw/는 절대 수정 금지** (불변 원본) -2. wiki 페이지 생성/삭제 시 **index.md 필수 업데이트** -3. 모든 오퍼레이션마다 **log.md에 기록** -4. 내부 참조는 **wikilink** 형식 -5. 모든 wiki 페이지에 **YAML frontmatter** -6. 모순 발견 시 **양쪽 소스 모두 인용** -7. 소스 요약은 사실만, 해석은 개념 페이지에서 -8. 질의 시 **index.md 먼저**, raw/는 마지막 수단 -9. **새 페이지보다 기존 페이지 업데이트 우선** -10. index 항목은 한 줄, 120자 이내 \ No newline at end of file +1. **`raw/`는 절대 수정 금지** — 불변 원본으로 보존한다. +2. wiki 페이지를 생성하거나 삭제하면 **`wiki/index.md`를 반드시 업데이트**한다. +3. 모든 위키 오퍼레이션은 **`wiki/log.md`에 기록**한다. +4. 내부 참조는 **`[[wikilink]]` 형식**을 사용한다. +5. 모든 wiki 페이지에는 **YAML frontmatter**를 둔다. +6. 모순을 발견하면 **양쪽 소스를 모두 인용**한다. +7. 소스 요약은 사실만 적고, 해석은 개념 페이지에서 한다. +8. 질의 시 **`wiki/index.md`를 먼저 보고**, `raw/`는 마지막 수단으로 본다. +9. 새 페이지를 만들기보다 **기존 페이지 업데이트를 우선**한다. +10. `wiki/index.md` 항목은 한 줄, 120자 이내로 유지한다. diff --git a/README.md b/README.md index 39b12a6..c534fb9 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,24 @@ -# LLMWiki-Template +# LLMWiki Template +Gemini CLI와 Obsidian을 함께 사용하기 위한 개인 LLM Wiki 템플릿이다. + +## 목적 + +- `raw/`에 원본 문서를 보존한다. +- `wiki/`에 핵심 개념, 소스 요약, 문서 간 관계를 구조화한다. +- `output/`에 위키 지식을 조합한 결과물을 만든다. +- Gemini CLI의 `GEMINI.md`, commands, skills, agents, hooks로 반복 작업과 규칙을 자동화한다. + +## 기본 흐름 + +```text +raw/ 원본 수집 → wiki/ 구조화·연계·융합 → output/ 결과물 작성 +``` + +## 시작 파일 + +- 루트 컨텍스트: `GEMINI.md` +- 사용법: `사용법.md` +- 개인 맥락: `나의 핵심 맥락.md` +- 위키 인덱스: `wiki/index.md` +- 변경 로그: `wiki/log.md` diff --git a/output/CLAUDE.md b/output/CLAUDE.md deleted file mode 100644 index 20303bb..0000000 --- a/output/CLAUDE.md +++ /dev/null @@ -1,6 +0,0 @@ -# Legacy Notice - -`output/`의 기본 컨텍스트 파일은 이제 `output/GEMINI.md`다. - -- Gemini CLI는 `output/GEMINI.md`를 사용한다. -- 결과물은 `wiki/` 기반으로 작성한다는 규칙도 동일하다. diff --git a/raw/CLAUDE.md b/raw/CLAUDE.md deleted file mode 100644 index 0f130f1..0000000 --- a/raw/CLAUDE.md +++ /dev/null @@ -1,6 +0,0 @@ -# Legacy Notice - -`raw/`의 기본 컨텍스트 파일은 이제 `raw/GEMINI.md`다. - -- Gemini CLI는 `raw/GEMINI.md`를 사용한다. -- `raw/`는 계속 읽기 전용이며, 변경 금지 규칙도 동일하다. diff --git a/raw/GEMINI.md b/raw/GEMINI.md index 608de35..40decc5 100644 --- a/raw/GEMINI.md +++ b/raw/GEMINI.md @@ -11,13 +11,14 @@ | 폴더 | 용도 | |---|---| | `articles/` | 웹 아티클, 블로그 | -| `books/` | 책 발췌, 독서 노트 원본 | +| `books/` | 도서 발췌, 독서 노트 원본 | +| `papers/` | 논문, 연구자료, 기술 리포트 | | `videos/` | 영상 대본, 트랜스크립트 | | `ideas/` | 순간 아이디어, 메모 | -| `work/` | BIM 개발 관련 업무 기록, 암묵지 | +| `work/` | 업무 기록, 암묵지 | ## Gemini CLI 작업 원칙 - `raw/`를 참조할 때도 먼저 `wiki/index.md`와 관련 `wiki/` 페이지를 확인한다. - `raw/` 내용을 인용할 때는 실제 원본 파일 경로를 `sources`나 본문에 남긴다. -- 대용량 책은 **1패스(목차) → 2패스(챕터별)** 순서로 처리한다. +- 대용량 도서·논문 묶음은 **1패스(목차/구조) → 2패스(문서별 컴파일)** 순서로 처리한다. diff --git a/raw/articles/description.md b/raw/articles/description.md new file mode 100644 index 0000000..c14448f --- /dev/null +++ b/raw/articles/description.md @@ -0,0 +1,3 @@ +# raw/articles + +웹 아티클과 블로그 원본을 보관한다. 수집 후에는 수정하지 않고, 요약과 해석은 `wiki/`에서 수행한다. diff --git a/raw/books/description.md b/raw/books/description.md new file mode 100644 index 0000000..700a0c9 --- /dev/null +++ b/raw/books/description.md @@ -0,0 +1,3 @@ +# raw/books + +도서 발췌, 독서 노트, 책 챕터 원본을 보관한다. 책 단위 자료는 가능하면 폴더로 묶는다. diff --git a/raw/ideas/description.md b/raw/ideas/description.md new file mode 100644 index 0000000..9b2324c --- /dev/null +++ b/raw/ideas/description.md @@ -0,0 +1,3 @@ +# raw/ideas + +순간 아이디어와 메모 원본을 보관한다. 정리·통합은 `wiki/`에서 수행한다. diff --git a/raw/papers/description.md b/raw/papers/description.md new file mode 100644 index 0000000..005fcf9 --- /dev/null +++ b/raw/papers/description.md @@ -0,0 +1,3 @@ +# raw/papers + +논문, 연구자료, 기술 리포트 원본을 보관한다. DOI, 저널, 연도 등 출처 메타데이터를 유지한다. diff --git a/raw/templates/webclipper_research.json b/raw/templates/webclipper_research.json index bf09286..f1af899 100644 --- a/raw/templates/webclipper_research.json +++ b/raw/templates/webclipper_research.json @@ -1,10 +1,10 @@ { "schemaVersion": "0.1.0", - "name": "🔬 Research (LLM Wiki)", + "name": "🔬 Research / Paper (LLM Wiki)", "behavior": "create", "noteNameFormat": "{{date}}_{{title}}", - "path": "raw/articles", - "noteContentFormat": "---\ntype: research\ntitle: \"{{title}}\"\nurl: \"{{url}}\"\nauthor: \"{{author}}\"\njournal: \"\"\ndoi: \"\"\nyear: \"{{published}}\"\nclipped: {{date}}\ntags:\n - raw\n - research\ndescription: \"{{description}}\"\nwiki_status: not-compiled\n---\n\n## 연구 질문\n\n\n## 핵심 발견\n\n\n## 나의 관점\n\n\n## 하이라이트\n{{highlights}}\n\n## 본문\n{{content}}", + "path": "raw/papers", + "noteContentFormat": "---\ntype: research\ntitle: \"{{title}}\"\nurl: \"{{url}}\"\nauthor: \"{{author}}\"\njournal: \"\"\ndoi: \"\"\nyear: \"{{published}}\"\nclipped: {{date}}\ntags:\n - raw\n - paper\n - research\ndescription: \"{{description}}\"\nwiki_status: not-compiled\n---\n\n## 연구 질문\n\n\n## 핵심 발견\n\n\n## 정리 기준\n\n\n## 하이라이트\n{{highlights}}\n\n## 본문\n{{content}}", "properties": [ { "name": "type", "value": "research", "type": "text" }, { "name": "title", "value": "{{title}}", "type": "text" }, @@ -14,7 +14,7 @@ { "name": "doi", "value": "", "type": "text" }, { "name": "year", "value": "{{published}}", "type": "text" }, { "name": "clipped", "value": "{{date}}", "type": "date" }, - { "name": "tags", "value": "raw,research", "type": "multitext" }, + { "name": "tags", "value": "raw,paper,research", "type": "multitext" }, { "name": "description", "value": "{{description}}", "type": "text" }, { "name": "wiki_status", "value": "not-compiled", "type": "text" } ] diff --git a/raw/templates/컴파일_프롬프트.md b/raw/templates/컴파일_프롬프트.md index 1f0002b..44ae185 100644 --- a/raw/templates/컴파일_프롬프트.md +++ b/raw/templates/컴파일_프롬프트.md @@ -7,12 +7,12 @@ raw/에 수집한 파일을 wiki/로 컴파일할 때 사용하는 프롬프트 ## 📄 Article ``` -raw/articles/[파일명].md 읽고 wiki에 컴파일해줘. +raw/papers/[파일명].md 읽고 wiki에 컴파일해줘. 추출할 것: - 핵심 주장 1~3개 - 인상적인 문장 (원문 인용) -- 내 관심사(문서 구조화, 개념 연계, 자료 융합, AI 활용)와의 연결점 +- 정리 기준(문서 구조화, 개념 연계, 자료 융합, AI 활용)과의 연결점 wiki 페이지 생성 후 index.md 등록, log.md 기록. ``` @@ -27,7 +27,7 @@ raw/videos/[파일명].md 읽고 wiki에 컴파일해줘. 추출할 것: - 영상의 핵심 주장 또는 방법론 - 타임스탬프별 핵심 포인트 (있으면) -- 내 관심사와의 연결점 +- 내 정리 기준과의 연결점 - 실천 가능한 인사이트 wiki 페이지 생성 후 index.md 등록, log.md 기록. @@ -43,7 +43,7 @@ raw/videos/[파일명].md 읽고 wiki에 컴파일해줘. 추출할 것: - 게스트/호스트의 핵심 관점 - 기억할 만한 발언 (원문 인용) -- 내 관심사와의 연결점 +- 내 정리 기준과의 연결점 wiki 페이지 생성 후 index.md 등록, log.md 기록. ``` @@ -62,7 +62,7 @@ wiki에 [책이름]_목차.md를 만들어줘. - 저자, 출판연도, 핵심 thesis - 전체 구조표 (파일 → 챕터 제목 매핑) - 파트별 한 줄 요약 -- 2패스 추천 챕터 순서 (내 관심사 기준) +- 2패스 추천 챕터 순서 (정리·활용 기준) index.md 등록, log.md 기록. ``` @@ -75,7 +75,7 @@ raw/books/[책이름]/[챕터파일].md 읽고 wiki에 컴파일해줘. 추출할 것: - 챕터 핵심 주장 - 핵심 개념 정의 (인용 포함) -- 내 관심사(문서 구조화, 개념 연계, 자료 융합, AI 활용)와의 연결점 +- 정리 기준(문서 구조화, 개념 연계, 자료 융합, AI 활용)과의 연결점 - 기존 wiki 페이지와 연결 가능한 개념 기존 wiki 페이지 있으면 업데이트, 없으면 새 페이지 생성. @@ -93,7 +93,7 @@ raw/articles/[파일명].md 읽고 wiki에 컴파일해줘. - 연구 질문과 방법론 - 핵심 발견 및 데이터 - 한계점 -- 내 관심사와의 연결점 및 활용 가능성 +- 내 정리 기준과의 연결점 및 활용 가능성 wiki 페이지 생성 후 index.md 등록, log.md 기록. ``` diff --git a/raw/videos/description.md b/raw/videos/description.md new file mode 100644 index 0000000..64a5ad5 --- /dev/null +++ b/raw/videos/description.md @@ -0,0 +1,3 @@ +# raw/videos + +영상 대본, 트랜스크립트, 강의·발표 노트를 보관한다. 타임스탬프가 있으면 원본에 유지한다. diff --git a/raw/work/description.md b/raw/work/description.md new file mode 100644 index 0000000..f34e0dd --- /dev/null +++ b/raw/work/description.md @@ -0,0 +1,3 @@ +# raw/work + +업무 기록, 구현 메모, 암묵지 원본을 보관한다. 프로젝트명과 날짜를 파일명 또는 frontmatter에 남긴다. diff --git a/wiki/CLAUDE.md b/wiki/CLAUDE.md deleted file mode 100644 index 56fae08..0000000 --- a/wiki/CLAUDE.md +++ /dev/null @@ -1,6 +0,0 @@ -# Legacy Notice - -`wiki/`의 기본 컨텍스트 파일은 이제 `wiki/GEMINI.md`다. - -- Gemini CLI는 `wiki/GEMINI.md`를 사용한다. -- 위키 운영 규칙과 frontmatter 규칙도 그 파일을 기준으로 본다. diff --git a/wiki/log.md b/wiki/log.md index 2d0d175..ae0c53b 100644 --- a/wiki/log.md +++ b/wiki/log.md @@ -12,3 +12,4 @@ updated: 2026-04-17 - 2026-04-16: `수정` — Gemini CLI 호환 구조로 운영 컨텍스트 이관 (`GEMINI.md` 계층 추가) - 2026-04-16: `수정` — `.gemini/commands`, `.gemini/skills`, `.gemini/agents`, `.gemini/hooks`, `.gemini/settings.json` 추가 - 2026-04-17: `수정` — 볼트 운영 철학을 문서 구조화·연계·융합 중심으로 정리 +- 2026-04-17: `수정` — 전체 문서 정합성 검토 후 FEM/수치해석 솔버 맥락, `raw/papers/`, Gemini 전용 구조로 정리 diff --git a/사용법.md b/사용법.md index 14a0f07..b5e3f70 100644 --- a/사용법.md +++ b/사용법.md @@ -19,6 +19,7 @@ raw/의 적절한 하위 폴더에 원본을 넣는다. | 웹 아티클, 블로그 | `raw/articles/` | | 도서 | `raw/books/` | | 논문 | `raw/papers/` | +| 영상 대본, 트랜스크립트 | `raw/videos/` | | 순간 떠오른 아이디어 | `raw/ideas/` | | 업무 기록, 암묵지 | `raw/work/` |