이 노트에 대하여
검색엔진을 넘어서 외부 AI와 에이전트가 힣의 가든을 어떻게 읽는지까지 고려한 접근성 설계다. llms.txt, JSON-LD, Link header, Content-Signal, 공개 표면, 검토 루프를 통해 디지털 가든과 GitHub를 더 잘 연결하려는 방향을 정리한다. 하네스 2.0이라는 이름으로 바깥과의 접점을 재설계하며, 지금 시점에서는 AEO(Agentic Engine Optimization) 문맥으로 읽는 편이 더 정확하다.
히스토리
- @junghan — 호스팅 디지털가든 도메인 워커 서비스 배포 Cloudflare 이 작업 완료 되었거든 여기 관련노트로 넣어 놨다.
- @mitsein/gpt-6-sol — garden v2026.9.27 출판 후 담당자 보고: 구조 변경보다 export 경계·검증 수치·남은 확인을 기록
- @mitsein/grok-4.6 — autholog 카탈로그 레코드 출하. llms.txt가 tags 와 큰 폴더 HTML을 링크로 열지 않음. /tags/autholog.jsonld ItemList 208. Copilot auto가 홈 URL만 받고 jsonld까지 탐.
- @glg(opus) — JSON-LD 신원층 v4 출하·라이브. Person/ProfilePage @graph, sameAs 5·alternateName GLG/GLGMAN·얼굴 프로필 이미지. Google Rich Results 적격(ProfilePage)·schema.org 오류0경고0, GPT·제미나이 교차검수. 현재시점 헤딩1 추가, 4월 내용은 ARCHIVE로 닫음, 관련노트/메타·description 정리.
- @junghan — hada.io JSON-LD 이슈(개인 사이트 @graph/Person.sameAs/LLM 인용)를 보고 작업 재개. 4월 evidence-graph 숙론을 신원층부터 실체화하기로.
- @pi — 긱뉴스 AEO 문맥으로 재독해. org 시맨틱 검색 대신 notes git log를 기준으로 현재 강화 지점을 반영하고, aeo 태그를 추가했다.
- @bbot — 1단계 llms.txt 배포 완료 + JSON-LD 표준 검증 결과 정리. 분신 제안 팩트체크 완료.
- @junghan — 카파시 문서 힣이 직접 읽고 남긴다. 시맨틱 레이어로 고민한 내용을 유지하면 된다. 카파시는 컨셉 문서이며 이는 각각 개인의 주체적인 방향을 잡아가면 된다는거야.
- @junghan — 고민을 실체화할 시점이다. 주말에 오가며 떠들었는데 하지도 않았다.
- @bbot — 자가 검토 리스트(Mandatory) 헤딩 추가. 히스토리 바로 뒤, 문서 상단 배치. 카파시 llm-wiki 촉발, 엔지니어→PKM 헤게모니 전환 시점 인식, 공진화 원칙 16개 항목.
- @bbot — 히스토리 추가. 힣 하네스 2.0 자가 검토 리스트 작성. 카파시 llm-wiki 촉발, 엔지니어→PKM 헤게모니 전환의 시점 인식. 공진화 원칙 재확인.
- @glg-gpt — 카파시 llm-wiki를 힣 하네스 2.0으로 엮는 헤딩 추가
- @glg(opus) — 카파시 llm-wiki 패턴(gist 442a6bf5)을 엮어 힣 하네스 2.0 아키텍처 종합. 힣봇지피티와 교차 리뷰 기반.
- @junghan — 보고 있다. [career 언어 — 하네스 포지셔닝과 외부 번역]
- @glg-gpt — Raw Gemini 응답 전문 + GPT 통합 보정 추가
- @glg-gpt — 외부 AI 시맨틱 연결 고도화 리뷰 대화(질문 전문 + 검증 표면 중심 보정) 추가
- @junghan — 리뷰
- @glg-gemini — 외부 제미나이 앱의 분석 제안을 바탕으로 구체적인 구현 방안 설계 및 llmlog 작성.
관련메타
- † #검색 #검색엔진 #검색증강생성 #임베딩 — 검색·RAG·임베딩 자석
- † 카파시조어 — 바이브코딩·샤디드싱킹·LLMWiki·소프트웨어3.0 — 카파시 어휘 자석
관련노트
- 호스팅 디지털가든 도메인 워커 서비스 배포 Cloudflare - 이 노트도 추가
- §andenken — 내 PKM-AI 자리로 수렴하는 llm-wiki·OKF·EKG — 같은 수렴을 PKM 쪽에서 다루는 자매 노트
- §andenken — 존재의 뜻새김, 시맨틱 메모리를 넘어서 — andenken의 정체성
- @안드레이카파시 @AndrejKarpathy #바이브코딩 #인공지능 #딥러닝 #에듀테크 — llm-wiki 촉발
- §openglg-config 셀프호스팅 가이드
담당자의 현재 보고 — autholog 카탈로그 레코드
신원층(Person / ProfilePage) 위에 컬렉션 한 장을 올렸다. 이름은 윌리슨 아키텍처가 아니라 카탈로그 레코드 다.
- 라이브 카탈로그: https://notes.junghanacs.com/tags/autholog.jsonld — schema.org
ItemList, 208건, 기존#article참조만. Quartz /Head.tsx는 안 건드림.post-build.shsidecar. - 사슬: https://notes.junghanacs.com/llms.txt Structure가
/tags/(3.7MB) 와/notes//meta//bib/폴더 HTML을 링크로 열지 않는다. 링크는/tags/authologHTML, 그.jsonld,/botlog/,/journal/뿐이다. - GitHub 대문
README.md의 How to read this repo 도 같은 사슬을 가리킨다.AGENTS.md는 작업 계약, README 는 착지. 복제하지 않는다. - 측정: Copilot auto, cwd
/tmp, 홈 URL만. 홈 →llms.txt→autholog.jsonld. 208건과 표본을 JSON-LD에서 읽음./tags/인덱스와 큰 폴더 HTML은 안 가져갔다.
지금 맡은 것
방문 에이전트가 얇은 홈에서 autholog 코어 집합에 닿게 하는 공개면.
맡지 않는 것
Datasette / 쿼리 가능 가든, ItemList SEO, 나머지 ~2,000편 카탈로그, 측정 전 컬렉션 확대, Head.tsx 태그 페이지 JSON-LD 인라인, SKOS, 페이지별 .json.
한 판이 이미 사슬을 탔다. 컬렉션을 더 짓지 않는다.
담당자의 현재 보고 — 가든을 지키는 내보내기 경계
이번 v2026.9.27 에서 가든의 틀을 다시 설계하지 않았다. GLG가 doomemacs-config 쪽에 거듭 요청한 것은 내보내기 개선이 가든을 망가뜨리지 않아야 한다는 것. 원본 Org → Markdown → Quartz라는 기존 경계를 지키면서, 출판물의 NBSP·강조·앵커 변화를 확인한 회차다.
어디가 바뀌었나
- 내보내기 로직과 회귀 테스트는
doomemacs-configv2026.9.27이 소유한다. 소스 NBSP를 정규화하고, 실제 강조 뒤에서만 NBSP를 넣되 코드 블록은 건드리지 않는다. 가든의Head.tsx나 JSON-LD 스키마를 이 문제 때문에 고치지 않았다. - 가든은 그 결과인 전체 재내보내기(
f408cae8d)와 누적된 사이트 변경을v2026.9.27로 묶어 발행했다. 사람의run.sh검수는 GLG가 마쳤고, 이 담당자는 같은 빌드를 다시 실행하지 않았다. 카탈로그 면은 8월의 autholog 하나에서 여섯 레코드(autholog + notes/meta/bib/botlog/journal)로 늘었다.llms.txt가 직접 안내하고scripts/post-build.sh가 생성·독립 검증기를 호출한다. 이는 이번 날 새로 설계한 일이 아니라 지난 릴리즈 이후 쌓인 작업이다. - 릴리즈: https://github.com/junghan0611/garden/releases/tag/v2026.9.27 / 내보내기 로직: https://github.com/junghan0611/doomemacs-config/releases/tag/v2026.9.27. Search Console 사이트맵 재제출 응답은
submitted true, 직후 상태는pending true, 오류·경고 0이었다. 색인 완료를 뜻하지는 않는다.
검증의 경계
내보내기 담당자의 측정(위 doomemacs-config 릴리즈와 이번 핸드오프): 한글–NBSP–한글 2,236→0, 강조 오탐 NBSP 346→1(모호한 원문 +), 코드 블록 안 NBSP 0. 제목 ID가 바뀐 90페이지를 localhost에서 열어 페이지 안 끊어진 #href 는 0건이었다. verify-relref 는 정상 25,137 / MALFORMED 0 / 이전부터 있던 AMBIGUOUS 2. 다른 페이지를 향한 미해결 앵커는 210→212건: 새 9/26 저널 링크 2개가 오래된 날짜 앵커 형식을 쓴다. 이전에 외부에 공유된 옛 앵커 URL의 영향은 측정하지 못했다. 이 수치는 이 담당자가 독립 재측정한 값이 아니다.
다음 확인
배포 뒤 여섯 .jsonld 의 Content-Type과 인아티클 목차의 실제 화면·프리뷰는 가든 NEXT.md 의 확인 자리다. 사이트맵 재제출이나 로컬 run.sh 검수가 그 확인을 대신하지 않는다. 지금의 판단은 새 레이어를 더하는 것이 아니라 정본 Org·내보내기·빌드·공개 페이지 사이의 계약이 계속 맞는지 보는 것이다.
4월의 질문이 첫 실체로 — JSON-LD 신원층을 박다
이 노트는 4월에 뜨겁게 달아올랐다. 외부 AI가 가든을 한두 페이지 슬쩍 보고 “지난달에 하다 만 개인 블로그네”라고 판정하지 못하게, 파사드가 아니라 인간의 발자취 로 읽게 하자는 숙론이었다. evidence graph, 검증 표면, 빌드타임 합성, Schema.org CreateAction, 갈라파고스 탈출 — 힣봇 군단(클로드·지피티·제미나이)이 며칠을 돌며 설계했지만, 코드로 떨어진 건 llms.txt·robots.txt·Link 헤더까지였다. 정작 “사유와 코드를 시간축으로 묶어 기계에 박는” 본체는 가안으로 남았다. (아래 ARCHIVE에 그 4월 숙론 전문이 그대로 닫혀 있다 — 원문은 화석이라 수정하지 않는다.)
두 달 반이 지나 hada.io의 글 하나(개인 사이트 JSON-LD @graph / Person.sameAs / LLM 인용)가 방아쇠가 됐다. 4월의 거대한 evidence graph 전체가 아니라, 거기서 가장 작고 바로 출하 가능한 한 겹 — 신원(identity) 층 을 먼저 떼어내 박았다.
Head.tsx의 JSON-LD를 단일Article노드에서@graph로 리팩터. 안정@id(#person·#website)로 전 페이지가 같은 엔티티를 가리켜, 크롤러·LLM이 노드 속성을 누적 병합한다.- Person —
name,alternateName: [GLG, GLGMAN],knowsAbout14,knowsLanguage [ko,en], 얼굴 프로필 이미지, 그리고 흩어진 신원을 한 노드로 묶는sameAs(GitHub 둘·LinkedIn·Bluesky·Mastodon). 홈은 ProfilePage, 글은 BlogPosting, 전부#person으로 수렴. - 홈 description에 신원 등식을 한 문장으로 박았다: 김정한 = GLG(힣) = GLGMAN(힣맨) = junghanacs 가든의 필자, 그리고 일생의 작업으로서의 Authology(어쏠로지). 동명이인 구분과 “이 글의 작성자가 누구인가”를 기계가 헷갈리지 않게.
왜 신원을 먼저 박았나. 4월이 그린 evidence graph(노트–커밋–이슈–시간축)는 결국 “누가 이 발자취를 남겼나”라는 뿌리 위에 선다. 신원층은 나머지가 매달릴 가장 작은 토대이자, LLM이 인용할 때 보는 첫 신호(sameAs=·=Person)다. 토대부터 박고, 그 위에 발자취를 쌓는 순서다.
4월의 규율도 지켰다. 표준 schema.org만 — 분신이 만든 temporalStatus 같은 조어는 크롤러가 noise로 버리니 일절 안 썼다(4월 “냉혹한 파서로 돌아가라”는 힣의 경고 그대로). 원문 시간축 보존 — org 원문은 화석으로 두고 신원층은 빌드타임에만 합성. 그리고 자화자찬 금지 — 힣봇끼리의 “훌륭합니다”가 아니라, validator.schema.org 오류 0·경고 0 과 Google Rich Results Test의 ProfilePage 적격(crawl·index 허용) 으로 외부 기계가 검증했다. 2026-06-23, v4 머지 → Netlify 배포 → 라이브 확인까지 닫았다.
지금 어디인가. 신원층은 출하·검증 완료, 그러나 “적격”은 “지식그래프 반영”이 아니다 — 구글 인덱싱과 KG 반영은 수일~수주가 걸린다. 그 전엔 제미나이로 retrieval 테스트해도 옛 정보가 나온다. 그리고 4월이 꿈꾼 진짜 발자취 는 아직 앞에 있다: #+reference: 인용키를 frontmatter refs[] → schema.org citation 으로 내보내 bib 679 노트가 “어떤 원전을 직접 다뤘는가”를 드러내는 학술 발자취(org export 측 작업), 그다음 커밋 계보. 4월엔 가안이던 evidence graph가, 이제 검증된 신원 토대 위에서 실제로 쌓을 수 있는 것 이 됐다. 한 걸음을 박았고, 길은 이어진다.
Comments