Knowledge Ledger (지식 원장)
Updated: 2026-08-22
이 파일은 Atlas 운영 중 생성된 **누적 지식**의 대장이다. 산출물 작성·근거 검증 중 확인한 신규 사실, 불일치, 판정, 운영 교훈을 날짜순으로 누적 기록한다. 세션마다 다시 발견하지 않도록 하는 것이 목적이다.
기록 형식: `[YYYY-MM-DD] [유형] 내용 (근거 경로)`
유형: `fact`(확인된 사실), `mismatch`(불일치), `decision`(운영 판정), `todo`(발견된 후속 과제)
---
2026-08-22
[2026-08-22] [fact] 노드 시스템 확정치: Tier 1 core 29 + Tier 2 working extension 93 = 122. Tier 3 노드 파일 없음. (`07_visualization/node_tier_inventory.csv`)[2026-08-22] [fact] paper cards 290장 = foundational 13 + extreme 59 + sustainable 120 + Lee lab 45 + beam 53. YAML atlas_doc_type 스캔 기준. (`03_papers/`)[2026-08-22] [fact] claim-evidence 행수: foundational 70, extreme 136, sustainable 271, beam 214, Lee lab 134 = 825행 + 책 Ch2/Ch4 매트릭스 30행. (`07_visualization/*claim_evidence_matrix.csv`)[2026-08-22] [fact] 그래프 엣지: edge_list_expanded 529건, full_graph_candidate 568건. 배치별: extreme 119, sustainable 268, beam 123, Lee lab 103. (`07_visualization/`)[2026-08-22] [fact] 원본 PDF 매칭 완료율: extreme 59/59(수치·페이지 검증까지), beam 53/53, sustainable 119/120, Lee lab 45/45(2026-08-22 매칭 실행), foundational 13편 보존. 미수령 배치 없음. sustainable 잔여 1건은 Li 2019 책 자체 항목.[2026-08-22] [decision] by_lee_lab PDF 매칭은 slug.pdf 기준 pdf_filename 매칭으로 수행. SHA-256·크기 기록. beam/sustainable 배치와 동일 절차. (`00_sources/by_lee_lab_publications/metadata/by_lee_lab_publications_source_index.csv`)[2026-08-22] [decision] evidence upgrade Task 1~2는 계획 경로(`evidence_deepening/`)가 아닌 실제 파일(chapter2_key_evidence.md, chapter2_equations_normalized.md, chapter4_key_evidence.md, 매트릭스 30행)로 구현 완료 판정. Task 3(Ch7)·4(Ch8)·5(Ch10)만 미완료. (`09_ai_workflows/evidence_upgrade_task_queue.md`)[2026-08-22] [mismatch] 5개 카드에서 slug 연도 ≠ YAML year: lao-2022→2023(2건), liu-2023→2024, olivier-2017→2020, zheng-2007→2008. 출판연도 vs 온라인 연도 차이로 추정. 문서 서술에는 YAML year 사용 중. needs_check — DOI 확인 시 함께 정리 대상.[2026-08-22] [mismatch] foundational papers index에 "needs DOI check" 5건 존재. (`00_sources/foundational_papers/metadata/foundational_papers_index.md`)[2026-08-22] [fact] Victor Li 책 인용 자산: extracted_text_v2 427p, figure_index 10개 장, page_images 54장(방정식 페이지). (`00_sources/victor_li_book/`)[2026-08-22] [fact] extreme_ductility_timeline.csv는 헤더만 있는 placeholder. 연대기 역할은 `10_knowledge_outputs/chronicles/ecc_research_chronicle.md`가 대신함.[2026-08-22] [decision] 생성 산출물은 `10_knowledge_outputs/`에 저장하며 00~09 근거 레이어와 분리. 모든 산출물은 outputs_index에 등록, 신규 사실은 본 원장에 누적. (`10_knowledge_outputs/README.md`)[2026-08-22] [fact] teaching layer 09개 모듈, 2026-08-22 동기화 검증 PASS. AI workflows 루트 정리 완료(archive_2026-08 이전). (`08_teaching/teaching_layer_update_report_2026-08-22.md`, `09_ai_workflows/README.md`)[2026-08-22] [fact] 01_people 카드 20장 구축 (연대기 계보 기준): founder 2, theory 5, expansion 6, lee_lab 8. 소속 근거는 전부 Atlas 내부 논문 원문 PDF 1페이지 저자-소속 블록. 최신 소속+변천 이력 형식. (`01_people/people_index.md`)[2026-08-22] [fact] 인물 소속 변천 확인: Huy Hoàng Nguyễn Chonnam→Lehigh(2025), Jeong-Il Choi Chonnam→Chonnam+Chung-Ang 병기(2023~), Bang Yeon Lee KAIST(2009)→Chonnam School of Architecture(2013~). 근거: luong-2025·hwang-2025·nguyen-2023-micromechanical·tosunfelekoglu-2013 원문.[2026-08-22] [mismatch] needs_check 6건: Zhong Lin, Shuxin Wang, Cynthia Wu, Tetsushi Kanda, En-Hua Yang, Ravi Ranade, Kequan Yu의 2008년 이후/최신 소속은 내부 논문 근거 없음. 해당 인물 최신 논문 PDF 확보 시 갱신.[2026-08-22] [decision] 인물 소속 채움 원칙: 웹 검색 금지, Atlas 내부 논문 원문 표기가 1차 근거. 동일 인물 다수 논문 시 최신 논문 소속=현재, 이전 소속은 affiliation_history로 보존. (`01_people/_schema.md`)[2026-08-22] [decision] 시스템 구성 요청서(RFP) 작성 및 검증 완료: `atlas_system_specification_rfp.md` (루트). 수용 기준치 §8은 당일 실측 스냅샷과 일치(검증 스크립트 PASS 25/25). 주의: 매트릭스 총계 표기는 6개 파일 합계 855행이며, 확장·랩 5배치만 세면 825행 — 문서별로 어느 정의를 썼는지 확인 필요.[2026-08-22] [fact] Atlas 이식성 점검: 대시보드 html 링크는 전부 상대경로(폴더 이동 무영향). vault 외부 의존은 재구출 스크립트(~/.hermes/scripts/rebuild_dashboard.py)와 rclone 백업(~/.scripts/gdrive_backup.sh) 2건. 절대경로 잔존 md 4파일(동작 무영향). RFP §11에 이관 절차 기록.[2026-08-22] [decision] RFP를 vault 루트(`atlas_system_specification_rfp.md`)로 이동. 다른 AI에 폴더를 넘길 때 최상위에서 바로 보이도록 함. outputs_index 항목에 이동 사실 기록.[2026-08-22] [mismatch] 책 인용 프로토콜 수치 오류 정정: 470페이지→427페이지(v2 마커 실측), 353→420 figure(색인 행 실측). 문서 간 수치 불일치 재발 방지: 인용 전 실측 원칙. (`09_ai_workflows/victor_li_book_citation_protocol.md`)[2026-08-22] [decision] 초보자 매뉴얼 작성: `atlas_manual_beginner.md`+`.html`(루트). Ingest/Query/Lint 3부. Query 검색 순서는 query_templates의 10유형을 축약. Lint는 update workflow Step4 체크리스트를 실행 가능한 파이썬 스니펫으로 변환한 것.[2026-08-22] [fact] 매뉴얼 Lint 스니펫 실행 검증: 카드 290(정확 YAML 패턴), 링크 깨진 참조 0건(핵심 문서 대상, 무시 목록 적용), YAML 불완전 0건(foundational 초기 10장 예외). 전체 md 전수 검사 시 1,619건 나오지만 그것은 (a)카드 내 배치-상대경로 관례 표기 (b)외부 AI placeholder (c)아카이브 과거 리포트라 결함 아님. 매뉴얼 스니펫은 핵심 문서만 검사하도록 설계됨.[2026-08-22] [mismatch] beam 배치 일부 카드가 구식 노드 경로(`03_mechanisms/`, `01_foundations/`) 참조 — 현재 체계에는 없는 경로. needs_check: 발견 시 Tier 재매핑 필요. (`03_papers/ecc_beam_extension/` 다수)[2026-08-22] [todo] 남은 실질 과제: evidence upgrade Task 3~5, foundational DOI 5건 확인, sustainable 잔여 1건(Li 2019 책 자체) alias 처리, people_graph/종합보고서/web 미생성.[2026-08-22] [fact] Redon et al. 2001이 foundational_paper_timeline_seed.csv에 누락되어 있었음을 발견·보완. 1997(Lin & Li)행과 2001(Li; Wang; Wu)행 사이에 삽입, CSV 총 23행. timeline.html 재생성 후 GitHub Pages 반영 확인(live grep PASS). 부수 정비: md_browser.html stale 렌더 링크 29건 교체, 대시보드 전체 깨진 링크 0건. (`07_visualization/foundational_paper_timeline_seed.csv`, `07_visualization/html_dashboard/timeline.html`)[2026-08-22] [fact] Redon 계보 보강으로 인물 카드 4장 신규 작성: carl_redon(2001 Michigan ACE-MRL Res. Fellow, PDF 1쪽 각주1), hideki_hoshiro·tadashi_saito·atsuhisa_ogawa(3인 모두 Kuraray Okayama Plant Industrial Goods Development Dept., 각주4~6). 4장 모두 needs_check. people_index 재집계: 총 카드 24장(founder2/theory9/expansion5/lee_lab8), needs_check 10건. cynthia_wu.md는 기존부터 redon_etal_2001 카드 상호링크 보유. index.md §01 People은 이전 세션의 15장 표기에서 미갱신 상태였어서 24장으로 정정함(mismatch 해소). (`01_people/carl_redon.md` 등 4파일, `01_people/people_index.md`, `index.md`)[2026-08-22] [fact] 미작성 인물 카드 8장 신규 작성으로 people layer 완결(잔여는 시기0 선례뿐): mohamed_maalej(1994 Michigan ACE-MRL Res. Fellow, full_text 각주), jian_zhou(Sinoma Research Institute Beijing, 2012 PDF 각주a), cong_lu(Southeast Univ. Key Lab, 2018 PDF 각주a), abel_shiferaw_alemu(Chosun Architectural Eng., 2023·2025 PDF 각주a 동일 — 변천 없음, 확정), chang_geun_cho(고신대 건축, 2012 각주b 교신저자), jin_kyu_song(전남대 건축, 2012 각주a), keun_hyeok_yang(경기대 건축공학, 2012 각주c), jian_guo_dai(PolyU CEE, 2021~2023 3편 각주a — lao-2023 **교신저자). 동명이인 오판 방지 실측: lv-2025의 'Lanqing Dai'은 Jian-Guo Dai가 아님(Lv·Gan·Wen·L.Dai·Chen·Kan·Zhang 저자라인 확인) — Dai 논문목록에서 제외 처리. people_index 재집계: 총 카드 32장(founder2/theory10/expansion9/lee_lab11), needs_check 15건. index.md §01도 32장으로 갱신. (`01_people/` 신규 8파일, `01_people/people_index.md`, `index.md`)[2026-08-22] [decision] Evidence upgrade Tasks 3~5 완료로 큐 비움. Ch7 내구성(<100um 균열폭 원리, RF회복 임계 아님—내구성은 열화마스터커브, 장기변형률 ~3%), Ch8 지속가능성(교량덱 40%/33% 절감 vs 결론밴드 30~40% vs 포장 15%/72% 수치 혼용 금지, embodied vs life-cycle 구분), Ch10 다기능(4기능 분리, 첨가물 트레이드오프: PCM 강도저하/TiO2 압축강도 저하/CB 연성 저해) 통합본 3편을 `00_sources/victor_li_book/evidence_deepening/`에 작성하고 타깃 노드 18개+flexural_testing에 deepened-evidence 섹션 추가. 수치는 extracted_text에서 직접 추출, 페이지 미확인 항목은 needs page verification 마커 유지. (`09_ai_workflows/evidence_upgrade_task_queue.md`, `00_sources/victor_li_book/evidence_deepening/`)[2026-08-22] [mismatch] 대시보드 Knowledge Outputs·index 페이지의 md 링크 8개가 죽은 링크였음: rebuild_dashboard.py의 md_link() 폴백이 `md_browser.html?file=...`를 반환했는데 md_browser.html에는 ?file= 쿼리 처리 로직이 아예 없어 클릭 시 파일 목록만 열렸다. 렌더본이 없던 대상은 outputs_index, knowledge_ledger, 10 README, 연대기 4파일. 해소: md_link() 폴백을 render_md_now() 즉시 렌더로 교재(rebuild 스크립트 자체 수정), 재생성 후 ?file= 링크 0건, 라이브 4렌더본 HTTP 200 확인. 향후 신규 ko 파일도 자동 렌더됨. (`~/.hermes/scripts/rebuild_dashboard.py` md_link, `07_visualization/html_dashboard/knowledge_outputs.html`, commit f16c7db)[2026-08-22] [fact] beam 배치 근거 기반 생성 산출물 2편 작성·등록: (1) ECC 보강 보 문제점 총괄 리포트, (2) 고연성 ECC 보강 보 휨내력 향상 제한 요인 분석(순수 ECC 내력 증가 8–17% 수렴, zhang-2025 기여율 상한 44%, 대조군 +80~201%). 수치는 소스노트·full_text 원문 실측으로 검증 완료(su-2024 박리 79 kN, chun-2025 ductility −34.6%, shin-2011 +9.5%/+34.4%). outputs_index #8~9 등록. 대시보드 반영은 rebuild 필요 시 별도 실행. (`10_knowledge_outputs/reports/ecc_strengthened_beam_problems.md`, `10_knowledge_outputs/reports/high_ductility_ecc_beam_flexural_capacity_analysis.md`)---
사용 규칙
1. 새 항목은 가장 아래 날짜 섹션에 추가한다. 같은 날짜 섹션이 없으면 새로 만든다.
2. 세션 시작 시 Atlas 관련 작업을 하기 전에 이 원장을 먼저 읽는다. 이미 확인한 사실을 재검증하지 않는다.
3. `needs_check` 항목은 해소되면 체크 표시로 갱신한다 (예: `[x] 해소 2026-08-25`).
4. 근거 경로를 반드시 함께 적는다. 근거 없는 기록은 추가하지 않는다.
[2026-08-26] [fact] Node-policy compliance audit executed: 189 edge rows pointed at non-existent node names (legacy pre-consolidation vocab, e.g. life_cycle_assessment/durability_enhancement); all normalized. Zero broken targets remain.[2026-08-26] [fact] Tier 1 edge backfill 778 rows: card YAML declared Tier 1 nodes that batch edge CSVs lacked (50 papers + 4 edge-less). Cards without Tier 1 edge: 252 -> 0.[2026-08-26] [fact] graph_concept_to_concept_edges.csv contained ~380 paper->node rows; archived to graph_paper_support_edges_archive_2026-08-26.csv. File is now concept-only (122 rows incl. 16 new intra-cluster edges).[2026-08-26] [fact] 42 placeholder "To be expanded" Core ideas replaced with claim-evidence-matrix-grounded text; all node files now carry Linked nodes.[2026-08-26] [decision] Lab-position position cards (5) registered in node_tier_inventory as tier_2_working_extension; total inventory 127 = 29 T1 + 98 T2. PROJECT_NODE_POLICY.md counts and index.md updated to match.[2026-08-26] [decision] Standing rule: ingestion complete only when every Tier 1 node declared in a paper card exists as an edge row, verified in the same pass.[2026-08-26] [todo] Dashboard rebuild + push pending after this audit (derived layers must resync).[2026-08-26] [fact] Dashboard rebuilt twice and pushed; Pages 'built'; live index.html shows Atlas nodes 127. rebuild_dashboard.py metric hardcoded value updated 122->127 (line ~179).[2026-08-26] [fact] Round-2 cleanup: 1 live Core idea restored (cementless_composites — enrichment had landed in its migrated-note copy), 8 migrated blocks marked as consolidated provenance, all 122 node files now carry Key extension/supporting evidence sections (matrix-based 67, edge-based 2, foundational 5, book-pointer 48).[2026-08-26] [decision] Extension-first answering rule adopted (PROJECT_NODE_POLICY.md): topic questions must check the node's mapped paper cards and matrix rows before answering; rule also added to atlas_manual_beginner.md QUERY section.[2026-08-26] [fact] Round-3 dedupe: Key-evidence card lists overlapped Anchor lists in 45 nodes (trimmed), migrated-block paper bullets compressed to counts in 7 files, duplicate Key sections in the 8 migrated files merged to one (200 paper entries remain across all nodes, 0 duplicates).[2026-08-26] [fact] beam 배치 카드 33곳의 구식 노드 경로(03_mechanisms/·01_foundations/, 29카드)를 현행 Tier 1/2 경로로 리맵 완료 — 2026-08-22 mismatch 항목 해소. 전체 감사: 노드 127·카드 290·매트릭스 855(+책 30) 확인, 5개 거버넌스 문서 수치 동기화.[2026-08-26] [fact] 대시보드 graph_network 페이지: concept_graph_expanded.json 36노드에 file 필드 부여(기존 no linked doc 해소) — 라이브 확인 51/51 노드 문서 링크 보유. 매핑: 레거시 id(micromechanics/strain_hardening/LCA 등)는 정규 노드 파일로 연결.[2026-08-26] [fact] 대시보드 rendered_md 부실 파일 문제 해소: 구 fancy 렌더러 산출물(481개)이 오늘 편집 이전 내용을 담은 채 md_link에 의해 우선 서비스됨(crack_width_control 대표 사례 — 5.1KB 구버전 vs 9.0KB 현행). 수정: rebuild_dashboard.py md_link()를 mtime 신선도 인지형으로 패치 + 노드 문서 130개 전부 재렌더 + 부산물 정리. 라이브 확인: Key extension evidence·2026-08-26 마커 게재.[2026-08-26] [fact] 재감사(재실행 요청): 불변식 전수 스캔에서 11노드의 Anchor∩Key 중복(총 46불릿) 발견·제거, 8파일(마이그레이션 블록 보유)의 Key 섹션이 파일 끝(migrated 블록 뒤)에 위치 → 라이브 영역(migrated 앞)으로 재배치, 고아 노드 2개(multiscale·phenomenological constitutive model)에 part_of c2c 엣지 추가(c2c 122→124). 최종 게이트: placeholder 0 · Key 헤딩 1개/파일 · Anchor∩Key 0 · 깨진 카드 참조 0 · 엣지 타깃 0 · 셀프루프 0 · 고아 0 · 카드-엣지 정합 277/277.[2026-08-26] [decision] 오늘의 신규 운영 룰을 거버넌스 문서에 영구 반영: atlas_system_update_workflow(감사 ③④ 확장·검증 체크리스트 2종 추가·운영규칙 5번), new_extension_ingestion_protocol §12, PROJECT_RULES accuracy rules 3행, README node policy 섹션. 이후 세션은 이 문서들만 따라가면 된다.[2026-08-26] [fact] 최고 연성 ECC 리포트 저장(10_knowledge_outputs/reports/highest-ductility-ecc-atlas-survey.md): 1위 ED-AASC 22.34±0.48%(Luong 2023, 크럼블고무 flaw 설계+PE 1.75vol%), 2위 원파트 EPS-EGC 20.90%, 3위 프리쿨링 FA-EGC 18.62%. choi-2019 '13.7%'는 상대 증가율(절대 ~6.12%)로 절대값 표에서 제외 처리. 매트릭스 855행 스캔, 헤드라인 수치 전부 소스노트 문자열 재검증 완료.[2026-08-26] [fact] 리포트 대시보드 게재 완료: outputs_index #10, 총 산출물 카운트 4→5건 갱신, GitHub Pages 라이브 HTTP 200 확인(rendered_md/503b2f8d56...), knowledge_outputs.html 허브 링크 확인.[2026-08-26] [fact] 지속가능 ECC 계보 리포트 저장(sustainable-ecc-lineage-survey.md): sustainable 배치 120편(1996–2026)을 5시기로 구분. 연성 축 마일스톤 2.0%(lee-2012)→4.48%→7.50%(choi-2016 PE 전환)→13.68%(nguyen-2021)→18.62%(nguyen-2023 프리쿨링)→22.34%(luong-2023 ED-AASC)→20.9% 원파트 재현(nguyen-2026). 핵심 수치 5건 소스노트 재검증 PASS. chronicle 시기 4~6 체계와 정합 확인.[2026-08-26] [mismatch→fixed] outputs_index.md 구조 파손 발견·복구: 08-26 신규 행들이 표 밖 파일 끝에 append되어 있었고(append 시 마지막 표 위치 확인 누락이 원인), Updated 날짜도 2026-08-22로 방치. 재작성으로 #10(audit report)·#11·#12(오늘 리포트 2건)를 본표에 편입, 카운트 산식을 유형별 합계로 정확화(12건), '새 행은 표 안에 추가' 규칙 명문화. 향후 등록은 표 마지막 행 다음에 삽입할 것.