이 노트에 대하여

프로젝트별 문서를 Markdown에서 Org-mode와 Denote 체계로 끌어오려던 2025년 전략 노트가, 2026-07-07 memex-kb와 jacobian-lens의 J-space 논문 import 실험을 지나 “Org가 인터랙티브 문서의 SSOT가 될 수 있다”는 명제로 확장되었다. 핵심은 LaTeX/Typst/Quarto로 도피하지 않고, Org 문서가 소스·실행·번들·오프라인 캡슐·HTML export까지 품어 원본 사이트 경계를 넘지 않는 재현 가능한 문서가 된다는 점이다.

히스토리

  • [2026-07-07 Tue 14:55] memex-kb 담당자가 paper2org-capsule / paper2org-interactive 를 도구화하고, jacobian-lens 담당자가 PAPER-IMPORT.md 절차로 J-space 논문 변환을 한 번에 재현했다. 힣의 명제 “org=SSOT, LaTeX/Typst 없이 인터랙티브 문서 생성”을 이 노트의 중심으로 올렸다.
  • [2026-07-07 Tue 12:28] 출근 후 “문서 자동화 책의 미래” 원석 작성. 앤트로픽 논문 페이지의 JS figure를 org 소스블록과 export 안에 품어 원본 URL 없이 동일하게 보려는 문제의식이 선명해졌다.
  • [2025-10-24 Fri 09:02] 프로젝트 관리가 연결 하나로.
  • [2025-10-21 Tue 10:53] 프로젝트 문서를 Markdown에서 Org/Denote로 전환하는 초안 작성.

관련메타

  • † #SSG: #콰르토 — Quarto는 이 문제의 역사적 대비항이다. Quarto가 해결하려던 재현 가능한 기술 출판 문제를 이제 Org SSOT 쪽으로 흡수한다.
  • † #재현성 — 원본 URL·외부 CDN·실행 환경 경계를 넘지 않는 문서의 조건.
  • † #출판 #퍼블리싱 — 책 논문 웹문서의 생성 형식을 다시 묻는 자리.
  • †#AI프롬프트 — 문서와 프롬프트, 실행 가능한 지식 단위가 합쳐지는 자석.

관련노트

관련프로젝트

  • (junghan0611 [2025] 2026) — 문서 변환기 본체. 이번 커밋 c5397b4 feat(paper2org): 인터랙티브 캡슐 + org 유래 인터랙티브 HTML.
  • (junghan0611 [2026] 2026) — 앤트로픽 메타 관찰 담당 공간. 이번 커밋 f6fb854 docs: paper2org import 절차 + 캡슐/HTML + 저작권 gitignore.
  • /home/junghan/repos/gh/jacobian-lens/AGENTS.md — 이 리포의 새 북극성: “앤트로픽 메타 관찰 담당 공간”, “정본은 org”, “문서 변환기로 org SSOT 정본으로 끌어와 함께 읽고 논의한다”.
  • /home/junghan/repos/gh/jacobian-lens/PAPER-IMPORT.md — J-space 논문을 static archive, PDF, HTML, interactive org, offline capsule, interactive HTML로 재현하는 절차.

한 줄

Org는 이제 단순한 메모 포맷이 아니라, 논문 원문·코드·JS figure·로컬 runtime bundle·export 결과를 하나의 시간축에 묶는 인터랙티브 문서 SSOT다. 원본 URL로 다시 넘어가지 않아도, 문서 자체가 경계를 품고 재현된다.

왜 Quarto였고, 왜 지금은 Org인가

Quarto를 적어 두었던 이유는 정확했다. 문제는 “예쁜 기술 출판 도구”가 아니라 재현성이었다. 논문·책·보고서가 코드와 그림과 실행 결과를 품고, 독자가 원본 환경을 잃어도 같은 결과를 다시 볼 수 있어야 한다. 그래서 Quarto, Pandoc, executable books, ox-quarto가 한때 후보로 떠올랐다.

하지만 힣에게 더 깊은 SSOT는 Org다. Org는 이미 Denote, agenda, bib, Babel, tangle/detangle, export, Emacs 워크플로우와 붙어 있다. Quarto는 강하지만 Pandoc 중심의 별도 문서 생태계다. 지금 시점의 LLM·에이전트·문서 변환기 환경에서는 굳이 Quarto를 최종 중심으로 삼지 않아도 된다. 오히려 Org가 중간 정본이 되면, 필요할 때 HTML/PDF/Markdown/Quarto/LaTeX/Typst로 나가는 쪽이 더 자연스럽다.

이번 사건의 의미는 “Quarto가 필요 없다”가 아니다. Quarto가 싫어서 버린 것도 아니다. Quarto가 가리키던 문제를 Org가 더 안쪽에서 해결하기 시작했다는 것이다.

Quarto는 재현 가능한 책의 미래를 가리키던 표지판이었다. 이제 힣의 경로에서는 Org가 그 미래의 작업공간이 된다.

앤트로픽 J-space 논문이 던진 문서 문제

앤트로픽의 J-space 논문은 단순 PDF가 아니다. transformer-circuits.pub 쪽 Distill/Anthropic 문서처럼 HTML, CSS, JS, 데이터 파일, figure runtime이 함께 움직인다. 웹에서 보면 살아 있는 figure가 보이지만, 그 논문을 그냥 Markdown이나 Org 텍스트로 가져오면 중요한 일부가 사라진다.

그 순간 담당자는 원본 URL로 다시 넘어가야 한다. 이것이 힣이 싫어한 경계다.

  • 원본 사이트가 살아 있어야 한다.
  • JS/CSS/data/CDN이 그대로 있어야 한다.
  • 연구 담당자는 “우리 문서”가 아니라 “저쪽 사이트”를 보러 가야 한다.
  • 문서가 힣의 시간축과 가든 안에서 재현되지 않는다.

그래서 질문은 단순 import가 아니었다.

논문 원본에서 JS 코드와 번들을 가져오고, org에서 소스블록 /Raw HTML/asset reference로 잡고, export하면 브라우저에서 동일하게 살아나는가?

memex-kb의 답은 “그렇다” 쪽으로 왔다. 정적 archive만이 아니라, capsule과 interactive org/html을 별도로 만든다. jspace.interactive.org 가 raw figure block과 head runtime을 품고, jspace.interactive.html 은 capsule 안에서 원본 URL 없이 열린다.

memex-kb와 jacobian-lens — 경계를 넘지 않는 문서

이번 작업의 구조는 두 리포가 나뉘어 깔끔하다.

  • memex-kb 는 변환기를 만든다. 논문 페이지를 가져와 static org, citation-aware HTML, acmart PDF, offline capsule, Org-derived interactive HTML로 내보낸다.
  • jacobian-lens 는 앤트로픽 메타 관찰 담당 공간이다. 변환기를 재구현하지 않고, PAPER-IMPORT.md 절차로 J-space 논문을 자기 리포의 papers/anthropic/ 아래에 담는다.

jacobian-lens의 새 AGENTS.md 는 이 방향을 명확히 적었다.

이 리포는 힣의 앤트로픽 메타 관찰 담당 공간이다. jacobian-lens 는 첫 소재지만 목적은 한 논문의 재현이 아니다. 앤트로픽과 케빈 켈리 같은 인접 사상가가 공개하는 논문·글·영상을 문서 변환기로 org SSOT 정본으로 끌어와 쌓아두고, 담당자와 함께 읽고 논의한다.

이 문장은 단지 리포 운영 규칙이 아니다. 힣의 메타 감각이 문서 포맷으로 내려온 것이다. 논문을 읽는 행위, 코드를 보는 행위, 원문을 보존하는 행위, 에이전트가 담당자로 붙는 행위, 나중에 다시 맥락을 복원하는 행위가 모두 Org 정본 위에서 만난다.

Org 소스블록/export가 품을 수 있는 것

이번 실증에서 Org가 품는 것은 텍스트만이 아니다.

Org 안에서의 자리export/재현 결과
논문 텍스트jspace.orgstatic archive / 검색 / 인용
수식·인용Org + bibliographyHTML citation / MathJax·KaTeX / PDF
그림·PNGlocal asset referencestatic HTML/PDF
JS figureraw figure block / head runtimeinteractive HTML
외부 assetcapsule manifest / local copyoffline runtime bundle
절차PAPER-IMPORT.md / source block담당자 재현 가능
해석autholog / botlog / llmlog가든 시간축

여기서 중요한 것은 “Org가 모든 것을 예쁘게 표현한다”가 아니다. Org가 모든 것을 가리키고, 묶고, 재생산하는 SSOT가 된다는 점이다. JS bundle 자체는 별도 asset일 수 있다. 그러나 그 asset이 왜 필요하고, 어디서 왔고, 어떻게 export되고, 어떻게 검증되는지는 Org/문서 절차 안에 남는다.

메타 연구 — 문서 포맷도 감각의 일부다

힣은 jacobian-lens 담당자에게 이것을 메타 연구라고 말했다. 그 말이 중요하다. J-space 논문을 읽는 것은 AI 연구 논문을 하나 소비하는 일이 아니다. “Claude 안쪽의 작업공간”을 보려는 시도이고, 동시에 “우리가 그 작업공간을 어떻게 우리 문서 작업공간 안에 품는가”를 묻는 일이다.

J-space — 케빈켈리 창발자아루프 #외자아 노트가 존재론적 북극성이라면, 이 노트는 문서론적 북극성이다.

  • J-space는 Claude 안쪽의 보고 가능하고 조절 가능한 작업공간이다.
  • Exoself는 인간 바깥쪽에 붙는 작업공간이다.
  • Org SSOT는 인간과 에이전트가 함께 만지는 외부 작업공간의 정본이다.

그래서 문서 포맷은 주변 기술이 아니다. 무엇을 읽을 수 있는가, 어디서 재현되는가, 누가 이어받을 수 있는가, 원본 권리를 어떻게 존중하는가, 어떤 경계를 넘지 않아도 되는가를 결정한다. 이것이 메타 감각이다.

검증된 착지 — 2026-07-07

memex-kb 담당자의 막판 보고 기준으로, 이번 실증은 커밋·푸시·스탬프까지 끝났다.

  • memex-kb commit c5397b4: feat(paper2org): 인터랙티브 캡슐 + org 유래 인터랙티브 HTML
  • jacobian-lens commit f6fb854: docs: paper2org import 절차 + 캡슐/HTML + 저작권 gitignore
  • 양쪽 훅(identity/secret scan) 통과.
  • memex-kb는 로직과 문서만 커밋했고, capsule/interactive 산출물은 gitignore.
  • jacobian-lens는 AGENTS.mdPAPER-IMPORT.md 만 커밋했고, Anthropic 저작권물은 아직 repo에 없다.
  • jacobian-lens 담당자는 pull 후 PAPER-IMPORT.md 절차대로 papers/anthropic/ 를 gitignore하고, paper2org 계열 5명령을 실행하면 된다.
  • capsule/ 에서 python3 -m http.server 8877 을 띄우고 jspace.interactive.html 을 열면 원본 URL 없이 interactive figure가 오프라인 재현된다.

이것은 작은 기능 추가가 아니라 문서 경계의 이동이다. “저쪽 웹사이트에 가야 보이는 것”이 “우리 Org 정본에서 파생된 local capsule로 볼 수 있는 것”이 되었다.

원문 보존 — 2026-07-07 문서 자동화 책의 미래

Danger

= 1 =

응 좋아. 거기 커밋푸시하기전에 하나 더 이야기를 하자. 앤트로픽의 논문 페이지는 js를 로딩하게 해줬나보다. 아 논문을 실제보니까 이부분이 아쉽네. 이거 좀 우리가 품어보고 싶은데? 혹시 논문 원본에서 가져오면 js 코드가 들어 있지? 그걸 org에서 소스블록으로 잡고 export하면 html에서 필요한 js를 품어 서 브라우저에서 볼때 동일하게 나오게 하는 방향을 고민해보자.

실무는 오푸스를 새로 불렀어. 대기중이거든. 우리가 이 고민을 해야돼.

내가 바라는것은 인터렉티브 문서 그 자체야.

왜냐면 지금 문서로 jacobian 담당자랑 가져와서 보면 js 코드가 없잖아. 담당 자가 그거 보려면 url로 원본 가서 봐야하는데 그러면 경계를 넘어아돼. 재현이 불가능한거야. 외부 자료도움이 없으면. 여기 보면 내 노트들 중에 quarto 이야기가 있지? 그거 딱 이문제가 싫어서 quarto를 적어놓은거야.

물론 org로 우리는 한거니까 quarto는 아니긴하거든 quarto가 좋으면 쓰면되거든 이미 1.9.37버전 설치되어 있어. https://github.com/jrgant/ox-quarto 이게 그래도 멈춰있다가 패키지가 다시 살아났어. 아마 이런 목적에서 뭔가 작업이 되는것 같은데?!

= 2 =

내가 이 문제를 왜 깊게 생각하고 memex-kb가 왜 존재하는지 생각해보면 이건 중요해. 같이 고민해줘

오케이 니가 이어받았으면 충분해. 내가 그래서 내 원문 프롬프트를 전달하라고한거야. 감은 잡은것 같으니까. 크롬붙어서 보자.

궁금한것은 그 번들이 앤트로픽 논문 로딩 전용인가? 아니면 그냥 범용번들인가? 번들 로직이 어딘가 리포에 담겨야되니까 앤트로픽 전용이면 우리 리포에 스킬부터 점검하면서 앤트로픽 논문 가져오기 로직을 활용할수 있어야돼. 마찬가지로 내보낼때도 번들이 같이 가야 브라우저에서 html 열면 같이 뜰것같아. cdn에 배포된거라면 링크해서 동작할수도 있으테고,

즉 org -> html로 다 커버가 되면 깔끔해. quarto로 굳이 갈필요는 없으니까. quarto는 사실 llm 이전에 시작된 프로젝트도 나는 메타문서 포멧으로 org를 더 신뢰해. 내가 잘다룰수 있기도하고.

quarto는 pandoc에 의존성이 있거든. 굳이 그 의존성이 지금 시점에는 필요가 없어졌어.

= 3 =

응 지금 열어봤어. 훌륭하다. 이걸 우리는 org 문서로 중간에 받아내고 역으로 변환할 수 있으니 org는 SSOT가 되어야하고 latex typst 이런것 없이 org로 인터렉티브 문서를 생성할 수 있다는 것이야. 지피티한테 내 워딩을 같이 전달해. 여기에 맞춰서 검수하고 안된것은 넥스트로 잡아서 진행하면돼

● GLG의 비전이 핵심입니다 — org를 중간에 받아내 역변환 가능 → org가 SSOT, LaTeX/Typst 없이 org만으로 인터랙티브 문서 생성. 이 명제에 맞춰 GPT에 GLG 워딩 그대로 + CMD1 착지 + 픽스처 결과를 보내 검수 요청하겠습니다.

후속 보고 보존 — memex-kb / jacobian-lens 담당자

Danger

✅ 커밋·푸시·스탬프 완료

repo커밋푸시
memex-kbc5397b4 feat(paper2org): 인터랙티브 캡슐 + org 유래 인터랙티브 HTMLd6ec9b3..c5397b4 → origin/main
jacobian-lensf6fb854 docs: paper2org import 절차 + 캡슐 /HTML + 저작권 gitignore581d398..f6fb854 → origin/main
  • 훅(identity/secret 스캔) 양쪽 통과, 스탬프 2건 어젠다 기록 완료.
  • memex-kb는 로직 2 + 문서 3만(캡슐 interactive.html 등 out 산출물은 gitignore).
  • jacobian-lens는 문서 2개만(AGENTS.md, PAPER-IMPORT.md) — Anthropic 저작권물은 아직 repo에 없음.
  • 캡슐 서버(8877) 종료 완료.

담당자가 이어서 할 것

이제 담당자가 jacobian-lens를 pull 받고 PAPER-IMPORT.md대로 하면 됩니다:

  1. papers/anthropic/ gitignore (문서 첫 단계 — 저작권물 실수 커밋 방지)
  2. paper2org 계열 5명령 실행 → 정적 아카이브 + 캡슐 + 인터랙티브 HTML
  3. capsule/에서 http.server 띄우고 jspace.interactive.html 열면 원본 URL 없이 인터랙티브 figure 오프라인 재현

세션 성과 정리: GLG 명제 “org=SSOT, LaTeX/Typst 없이 인터랙티브 문서 생성”을 실증하고, paper2org-capsule/paper2org-interactive 두 명령으로 도구화해 담당자가 쓸 수 있게 했습니다. 남은 폴리시(자동 검증 assert, fidelity)는 NEXT.md에 저우선으로 정리돼 있습니다.

옛 방의 씨앗 — 프로젝트 Denote 문서 Org-mode 전환 전략

이 방은 원래 2025-10-21에 프로젝트별 Markdown 문서를 Org-mode/Denote로 옮기는 전략 노트였다. 당시 핵심은 다음이었다.

  • 프로젝트별 문서를 Denote 파일명·front matter·링크 구조로 관리한다.
  • Markdown 대신 Org-mode를 쓰면 Emacs 워크플로우, Babel, literate programming, 부분 export가 붙는다.
  • ~/org/, ~/claude-memory/, 프로젝트 docs/ 를 각각 다른 Denote silo처럼 다룬다.
  • Pandoc 변환 시 YAML front matter 충돌은 --from markdown-yaml_metadata_block 으로 피한다.
  • SKS Gateway 문서 40개와 claude-memory 문서 99개를 Org로 변환했다.

그때의 문장은 “프로젝트 문서를 Org로 전환하자”였다. 이번 수선 뒤의 문장은 더 넓다.

프로젝트 문서가 Org로 전환되는 것이 아니라, 프로젝트의 연구·코드·논문·인터랙티브 실행 환경이 Org 정본 위에서 다시 조직된다.

남은 질문

  • paper2org-interactive 의 fidelity를 자동 검증하는 assert를 어디까지 만들 것인가.
  • Anthropic 전용 Distill runtime과 범용 interactive paper runtime을 어떻게 분리할 것인가.
  • 저작권 asset capsule은 어느 리포/어느 경로까지 허용하고, 공개 가든에는 무엇만 노출할 것인가.
  • Org-derived interactive HTML을 가든 공개 페이지에 직접 붙일지, repo-local capsule로만 둘지.
  • Quarto/ox-quarto는 완전히 우회할지, 특정 협업·출판 경로의 optional export target으로 남길지.