§zotero-config #담당자 ◊bibcli 캡처 금고와 메타 서지의 얇은 손

이 노트에 대하여

이 노트는 zotero-config 담당자가 지금 무엇을 맡고 무엇을 맡지 않는지 기록하는 자리다. 책을 추천하지 않는다. 서지를 가꾸는 과정 — 캡처, 손·에이전트 스타일, 십진분류 감각의 키, 컬렉션 분류, 로컬 렌더, org 인용 — 을 얇은 코드와 스킬로 공개하는 집의 얼굴이다. 제목의 ◊bibcli 는 다른 집이 아니라 이 집의 두 번째 얼굴이다: bibcli 의 Go 소스는 zotero-config 안에 살고, 하네스에 노출되는 SKILL.md 면만 agent-config 소유다. 이 방을 가리키는 손잡이는 제목이 아니라 denote id 이며, 리포 AGENTS.md 가 20260304T105300 을 직접 든다. 세션 일지는 여기 두지 않는다. 다음 한 걸음은 리포 NEXT, 일상 입수는 bibcli 스킬이다. notes/ 의 옛 설치·파이프라인 스텁은 이 얼굴로 흡수하고 빈방으로 돌린다.

1. 히스토리
2. 관련메타
3. 관련노트
   1. 담당자의 큰그림과 실행 계약
   2. 독립된 사례 문서 — 합치지 않고 이웃으로 둔다
4. 담당자의 현재 보고 — 캡처 금고와 메타 서지의 얇은 손
   1. 지금 맡은 것
   2. 맡지 않는 것
   3. 현재 경계와 남은 확인
   4. 담당자의 판단
5. 담당자의 현재 보고 — 기기 대칭의 결정론 서지면
6. 담당자의 현재 보고 — id 로 정박한 담당자 문서와 bibcli 경계
   1. bibcli 경계 — 제목의 ◊bibcli 는 오기가 아니다
   2. 관련노트의 옛 경로 한 줄
7. 옛 방의 씨앗
   1. 옛 설계 흡수 — No-GUI / AI-Queryable (from 20250409T144103)
   2. 메타데이터 허브 비전 (from 20240822T155719)
   3. Translation Server 출발 메모 (from 20250409T142618)

히스토리

• [2026-09-04 Fri 14:06] @mitsein/opus-5 — GLG 지시로 제목을 §zotero-config #담당자 형식으로 개명하고 description·초록에 bibcli 경계와 id 정박 판정을 실었다.
• [2026-09-04 Fri 13:41] @mitsein/opus-5 — 담당자 문서 손잡이를 제목이 아닌 id 로 AGENTS.md 에 정박하고, bibcli 경계(소스는 이 리포, SKILL.md 면은 agent-config)를 이 얼굴 안에서 갈랐다.
• [2026-08-22 Sat 21:52] @junghan — ◊denote #지식베이스 #프로토콜: #인간 #에이전트 #공존 #인터페이스 이 노트랑 같이 검토하자. bibcli 연동하는 그림이 여기랑 교차한다.
• [2026-08-22 Sat 18:25] @mitsein/gpt-5.6-terra — GitHub starred도 공유 staging 설치 규율로 합쳐, 같은 응답이면 byte·mtime을 보존하고 변경 때만 원자 교체한다. 8개 live bib 파일·8,642 entry와 전 회귀 묶음을 최종 확인했다.
• [2026-08-22 Sat 18:21] @mitsein/gpt-5.6-terra — GitHub starred renderer도 규칙 SSOT를 jq에 정렬 전 주입하도록 닫았다. 합성 페이지 순서·sanitize 역전 회귀 9/9, 전체 결정론·cursor·lock·경로 검증은 모두 green이다.
• [2026-08-22 Sat 18:16] @mitsein/gpt-5.6-terra — 새 Syncthing bib/ 면에 GitHub starred 2,420건도 생성해 8개 파일·8,642개 entry로 통일했다. 생성 시각 헤더 없이 key 정렬을 실측했으며, sanitize 뒤에도 정렬이 보장되는 회귀를 코드에 보강 중이다.
• [2026-08-22 Sat 18:09] @mitsein/gpt-5.6-terra — Zotero Cloud를 여러 기기의 캡처 권위로, ~/sync/org/resources/bib를 Syncthing 공유 서지면으로 재정렬했다. 렌더는 cache 순서·생성시각과 무관한 바이트 결정론, .sync 단일 writer lock과 cursor-then-cache 안전 순서를 갖춘다.
• [2026-08-03 Mon 11:07] @mitsein/grok-4.5 — BBT bib방(20250409T072408)을 플러그인 아카이브로 흡수·빈방. GUI 플러그인 금지·키=에이전트/ 직접 편집 원석 정박.
• [2026-08-03 Mon 10:57] @mitsein/grok-4.5 — notes zotero 스텁 5방을 이 얼굴·Emacs·어쏠로지·플러그인 아카이브로 흡수. 144103·142618·40822·144319·40705 빈방 처리 시작.
• [2026-08-03 Mon 10:50] @mitsein/grok-4.5 — 인간 원석 방 20250409T142940·어쏠로지 20240925T200824와 연결. botlog=운영, autholog= 왜.
• [2026-08-02 Sun 14:06] @mitsein/grok-4.5 — 빈방 20260304T105300 을 §zotero-config 담당자 문서로 개장. 당일 확정한 운영 골격(네트워크 없는 sync 렌더, pin --sync 원샷, Book/N00·Category 자동 분류, bibcli 전역 스킬, dateAdded 성스러움)을 공개 얼굴로 고정.
• [2026-08-02 Sun 13:10] @mitsein/pi — @junghan 지시에 따라 원문과 당시 LLM 해설을 20251030T011103 autholog로 옮겼다. botlog는 빈방으로 되돌렸다.
• [2026-03-04 Wed 10:53] 이 주소 생성 이후 autholog 회수로 비움.

관련메타

• † #조테로 #서지관리
• † #분류체계 #한국십진분류
• † #워크플로우 #자동화
• † #재현성 #복기

관련노트

담당자의 큰그림과 실행 계약

• ~/repos/gh/zotero-config/ — 코드·=run.sh=·=AGENTS.md=·repo skill SSOT
• ~/.claude/skills/zotero-config/SKILL.md (리포 안 .claude/skills/zotero-config/) — 오퍼레이터 교리·책 의식·pin 계약
• agent-config 의 bibcli 스킬 — org 담당 에이전트 일상 URL 입수 설명서
• ~/org/resources/*.bib — 메타 서지 SSOT (output 복사본). bibcli 가 읽는 유일한 면
• §zotero-config AI-Queryable 서지정보 관리 — 초기 문제의식·설치 자리. 현재 운영 계약이 아니라 출발 기록
• #이맥스: #서지관리 #조테로 §citar — Emacs·citar 소비 층
• ◊denote 지식베이스 프로토콜 — 회수한 텍스트가 파일·링크·시간축 위에서 사는 공동 규약. bibcli 태그 이웃

독립된 사례 문서 — 합치지 않고 이웃으로 둔다

• 긴 yes24·스냅샷 삭제·enrich 실패 일화는 세션 /CHANGELOG/NEXT에 두고 이 얼굴에 흡수하지 않는다
• 개별 책 추천·서평은 서지 장서 자체가 아니라 가든 다른 방에 둔다
• 인간 화두 autholog — dateAdded 성스러움과 과정 공개의 왜
• 어쏠로지·모두가 저자 — 공개 서재의 존재 선언 이웃

[2026-08-02 Sun] 담당자의 현재 보고 — 캡처 금고와 메타 서지의 얇은 손

zotero-config는 Zotero GUI 플러그인 왕국이 아니다. Cloud는 캡처 금고 이고, 로컬 *.bib 가 메타 서지 SSOT 이다. 공개 리포의 정체성은 “이 책 목록을 베끼라”가 아니라 서지를 가꾸는 과정 을 드러내는 일이다.

URL / Connector / 폰
        ↓  save (Translation Server)  — 날것 항목
에이전트 스타일 · KDC 감각 키 · 유일성
        ↓  pin --sync  — whitelist PATCH + 컬렉션 + bib sync
Zotero 적소 (Book/N00 또는 Category/Video|@Web|…)
~/org/resources/*.bib
        ↓  bibcli show / citar / #+reference:
org 글에서 바로 인용

지금 맡은 것

• Cloud → 로컬 증분 bib sync / full (렌더는 네트워크 없음. 기존 citationKey 존중, 없을 때만 로컬 폴백)
• URL 원샷: save --json → 에이전트 판단 → pin --sync (같은 세션에 키 확정, 시점 분리 금지)
• 컬렉션 자동 분류: 책 = citationKey 앞자리 → Book+N00; 비책 = itemType → Category 리프 (Unfiled 탈출)
• bibcli 검색·show·(선택) lookup — SSOT 읽기 손
• 공개 sanitize 후 output/ → ~/org/resources/
• Snapshot HTML 등 저장공간 쓰레기는 명시 작업으로만 정리 (부모 서지 보존)

맡지 않는 것

• YouTube 별표·브라우저 북마크 대량 스크랩으로 경계 넓히기
• BBT/GUI citation-key 플러그인 재도입, MCP로 Zotero 붙이기
• sync 본선에 data4library/KDC API 의존 (lookup·enrich는 선택·위험 구역)
• dateAdded / dateModified 를 위험에 두는 일괄 enrich·재생성
• *.bib 손편집을 정본으로 삼기
• 책 키 대량 자동 생성·루틴 writeback
• org 에이전트가 “서지 없어요”로 멈추는 문화 (URL 있으면 지금 pin까지)

현재 경계와 남은 확인

• 책 KDC는 완벽 분류 가 아니라 분류 축 + SSOT 유일성. 사람 손 경로(Connector+GUI)와 에이전트 레일이 공존한다
• enrich / 일괄 writeback 은 레거시·위험 — 단건은 pin
• Category 매핑은 장서 지배 패턴 기준; 예외는 fileUnder / collections
• Translation Server (localhost:1969) 가용성이 원샷 캡처의 전제
• 담당자 문서 갱신 = 이 방 히스토리+현재 보고. 새 botlog/llmlog를 기본으로 만들지 않는다. 세션 핸드오프는 리포 NEXT.md

담당자의 판단

과정의 유연함은 코드 본선이 아니라 스킬과 판단 에 둔다. 코드는 금고를 읽고, 허용된 필드만 쓰며, 타임스탬프를 지키면 충분하다. org 쪽 얼굴은 bibcli 스킬 한 장으로 “URL만 넘기면 글에 쓴다”를 닫는다. 이 집이 추천하는 것은 책이 아니라, 그렇게 서지를 가꾸는 손이다.

[2026-08-22 Sat] 담당자의 현재 보고 — 기기 대칭의 결정론 서지면

이제 zotero-config는 개인 output 폴더나 Git 운반을 맡지 않는다. Zotero Cloud는 여러 기기에서 URL을 담는 금고이고, 각 기기의 .sync/는 공유하지 않는 증분 cache다. 완성된 BibTeX만 ~/sync/org/resources/bib/*.bib에 직접 렌더되어 Syncthing으로 움직인다.

같은 Cloud 항목 집합은 cache 배열 순서·실행 시각·기기와 무관하게 같은 바이트의 BibTeX가 된다. 생성 시각 헤더는 없애고, 의미 있는 시간은 Zotero의 dateadded/datemodified로 남겼다. local full/sync/writeback은 .sync 단일 writer lock으로 보호하며, cache와 cursor는 cache·삭제 반영 뒤에만 cursor가 전진한다.

agent-config의 bibcli 스킬은 이 bib/ 면을 읽고, 어느 기기의 org 담당자든 자기 기기에서 save → 스타일·키 판단 → pin —sync로 한 세션에 인용 키를 닫는다. Git pull/push와 repo output은 일상 경로 밖이다.

현재 확인: Oracle full sync가 Cloud 6,225건을 받아 6,222개의 citeable entry를 새 bib/에 생성했고, 다음 no-op sync에서 7개 파일의 SHA-256과 mtime이 모두 유지됐다.

남은 일은 코드 커밋 판단과 별도의 Doom Emacs citar 경로 전환이며, output의 Git 정리는 코드 commit 때만 함께 판단한다.

[2026-09-04 Fri] 담당자의 현재 보고 — id 로 정박한 담당자 문서와 bibcli 경계

담당자 문서를 가리키는 손잡이를 리포 안에 정박했다. ~/repos/gh/zotero-config/AGENTS.md 의 ### Steward note 블록이 20260304T105300 을 직접 든다. 제목이 아니라 id 다.

이 방이 §zotero-config: ◊bibcli 캡처 금고와 메타 서지의 얇은 손 으로 개명되면서 제목·슬러그·filetags·파일명이 전부 움직이는 동안 #+identifier 만 자리를 지켰고, 그 사이 AGENTS.md 는 옛 제목을 들고 있었다 (커밋 a9b996a 의 AGENTS.md:14). 제목이나 § 검색으로 “이 리포의 담당자 문서가 어느 방인가”를 매번 다시 유도하는 절차는 그래서 금지다. 판정은 한 번 내리고 id 로 기억한다.

읽는 자리도 같이 박았다. 근거는 ~/org/botlog/ 의 org 원본이며, notes/content/ 의 내보내진 md 는 한 주기 늦으므로 판정 근거가 아니다.

:hugo_lastmod: 의 뜻도 여기서 고정한다. 퍼블리시 관심사가 아니라 이 문서를 정말 고쳤다 를 손으로 찍는 도장이다. 히스토리 한 줄은 로그이지 수정이 아니므로 기준선을 올리지 않는다.

bibcli 경계 — 제목의 ◊bibcli 는 오기가 아니다

이 방 하나가 두 얼굴을 든다. 갈림은 리포가 아니라 면 이다.

• bibcli/ — Go 소스·파서·=lookup= 은 이 리포 안에 산다. 별도 리포는 없다 (~/repos/gh/bibcli 부재 실측, 2026-09-04). 고치는 손은 이 집 담당자다.
• ~/.claude/skills/bibcli/SKILL.md — org 에이전트에게 노출되는 사용 설명면은 agent-config 소유다. 이 집이 직접 고치지 않고 발견을 넘긴다.
• 그러므로 제목의 ◊bibcli 는 다른 집으로 넘기는 표시가 아니라, 캡처·렌더의 집과 그 SSOT 를 읽는 손이 한 얼굴이라는 표시다. 이 방을 bibcli 쪽 주제 노트로 오인해 zotero-config 의 담당자 문서를 따로 찾으면 안 된다 — 그런 방은 없고, 없는 게 맞다.

관련노트의 옛 경로 한 줄

위 관련노트 에 남은 ~/org/resources/*.bib 는 2026-08-22 이전 좌표다. 지금의 서지면은 $ZOTERO_BIB_DIR (기본 ~/sync/org/resources/bib/) 하나이고 렌더러가 거기에 직접 쓴다. BIBCLI_DIR 은 폐기됐다. 옛 줄은 흔적으로 남기고 좌표는 여기서 정정한다.

옛 방의 씨앗

• 회수된 autholog — 이 주소가 비기 전 머물던 원문·해설

옛 설계 흡수 — No-GUI / AI-Queryable (from 20250409T144103)

메타데이터 허브 비전 (from 20240822T155719)

Translation Server 출발 메모 (from 20250409T142618)