WIKIDOCS ANALYSIS BOARD

위키독스 분석 보드 — 2026-06-04

아침에 흩어져 오던 책별 분석 알림을 하나로 묶었습니다. 적용할 것과 개선할 것만 먼저 확인합니다.

2분석 책
5바로 적용
9개선 적용
2보류/스킵

수집 상태

batch 4.6시간 전 정상

C++ 이야기(A Story of C++)

book_id 2380 · 챕터 149

C++를 단순 문법이 아니라 개발 환경, 컴파일, 코딩 스타일, 용어 체계, 메모리 모델, 수치 정밀도까지 포함한 운영 책임의 언어로 설명하는 입문·참조형 책이다.

adopt 후보 3개, improve 5개, skip 0개 — 핵심 가치는 C++ 문법 자체가 아니라 형님 시스템의 약점인 정량 평가, 실행 모드, 용어 표준화, 원본-배포본 개념 구분을 더 정밀하게 만드는 데 있다.

ADOPT 3IMPROVE 5SKIP 0
  1. IMPROVE 책의 자유와 책임 원칙
    HARNESS_DOMAIN_REGISTRY.md 또는 Pre-Write Protocol 안내에 '금지보다 운영 책임 기준으로 예외를 판단한다'는 짧은 원칙과 예외 기록 기준을 추가한다.
  2. ADOPT Debug/Release 컴파일 옵션과 빌드 모드 명시
    agents/run_all_selftests.py 또는 harness_integration.run_as_automation 사용 지침에 debug/dry-run/production 실행 모드와 경고·실패 기록 기준을 추가한다.
  3. IMPROVE Makefile 기반 다중 디렉토리 빌드와 버전 파일
    agent-runtime-source에 새 Makefile을 만들기보다 기존 배포/검증 스크립트에 Hermes/Codex/Claude 배포본 버전 또는 해시 확인 단계를 추가한다.
  4. IMPROVE 코딩 스타일과 명명 규칙
    HARNESS_DOMAIN_REGISTRY.md 또는 RTK.md에 Python agents/SKILL/hook 이름 규칙을 짧은 표로 추가한다. 헝가리안 표기법은 채택하지 않는다.
  5. ADOPT 용어 대역표
    옵시디언 키워드 사전에 C++/프로그래밍 대역표 후보를 추가할 때 원어, 한국어 표기, 원어 유지 여부를 별도 필드로 기록하도록 obsidian_keywords 처리 규칙을 보강한다.

IT 기술 노트

book_id 2184 · 챕터 158

이 책은 컴퓨터 구조·운영체제의 기본 개념을 CPU-메모리-디스크-캐시-가상메모리 흐름으로 설명하는 입문형 CS 기술 노트다.

adopt 후보 2개, improve 4개, skip 2개 — 핵심 가치는 CS 지식 자체가 아니라 캐시·지역성·페이지 폴트·스케줄링 개념을 형님 자동화의 정량 평가와 동시성 관리 언어로 바꾸는 데 있다.

ADOPT 2IMPROVE 4SKIP 2
  1. IMPROVE 캐시 hit/miss와 hit ratio를 자동화 품질 지표로 쓰는 패턴
    agent-runtime-source/templates/agents/pipeline_observer.py에 stage별 hit/miss/success/fail 카운터와 일간 hit_ratio 요약 필드를 추가하고, system-operations SKILL의 헬스체크 출력에 자동화별 성공률을 붙인다.
  2. ADOPT 시간적·공간적 지역성 기반 지식 검색 우선순위
    obsidian_keywords 자동 발동 모듈에 recent_terms와 adjacent_links 점수를 추가하고, wikidocs SKILL 또는 옵시디언 키워드 파이프라인에 temporal_score + backlink_neighbor_score 기준을 기록한다.
  3. IMPROVE Write-through와 Write-back을 메모리·옵시디언 저장 정책으로 구분
    channel-bridge-memory SKILL에 write-through 대상(운영 규칙·실패 원인·반복 pitfall)과 write-back 대상(일회성 대화·임시 URL·긴 로그)을 명시하고, HANDOFF.md monthly_summary 압축 규칙과 연결한다.
  4. IMPROVE 페이지 폴트 관점의 정보 누락 탐지
    harness_integration.run_as_automation 또는 pipeline_observer.py에 context_miss 이벤트 타입을 추가하고, agent_registry/HARNESS_DOMAIN_REGISTRY 조회 실패 시 context_fault로 기록하게 한다.
  5. IMPROVE 프로세스·스레드·컨텍스트 스위칭 기반 동시 작업 충돌 설명
    pre_write_harness_check.py와 PostToolUse obsidian_keywords hook 주변에 파일락 또는 작업 큐 정책을 추가하고, pipeline_observer.py에 concurrent_run_id와 lock_wait_ms를 기록한다.