agentleFS
cookyman74cookyman74/llmwiki-harness/CLAUDE.md

llmwiki-harness

CLAUDE.md34 starsChanged 3 months agoMITView on GitHub

This is an Obsidian vault ("llmwiki") — a Korean-language knowledge wiki about LLMs / AI. It is a markdown knowledge base, not a code project. There is no build, test, or lint step. 이 볼트는 LLM이 유지보수하는 *영속 위키*다. RAG처럼 질문마다 지식을 재발견하지 않고, 소스를 인제스트할 때 한 번 컴파일해 계속 최신화한다. v2는 인간 기억 구조를 본떠 *정보에 등급·시간·신뢰도*를 부여한다(v1의 평평·무등급·정적 한계 개선). 승격 규칙(정본 요약 — 절차는 wiki-consolidate 스킬): L1→L2 세션 종료 시(3–5줄 압축) · L2→L3 lint 시 같은…

The file

Files
CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with content in this repository.

This is an Obsidian vault ("llmwiki") — a Korean-language knowledge wiki about LLMs / AI. It is a markdown knowledge base, not a code project. There is no build, test, or lint step.

목적 (사용자 프로필)

개인 프로필(역할·스택·관심 분야)은 CLAUDE.local.md에 둔다(gitignore — 공유 안 됨). Claude가 세션마다 자동 로딩해 설명 깊이·톤을 맞춘다. 스켈레톤을 처음 받았다면 CLAUDE.local.md를 만들어 자기 프로필을 적으세요.

아키텍처 (LLM Wiki v2 — 통합 계층 기억)

이 볼트는 LLM이 유지보수하는 영속 위키다. RAG처럼 질문마다 지식을 재발견하지 않고, 소스를 인제스트할 때 한 번 컴파일해 계속 최신화한다. v2는 인간 기억 구조를 본떠 정보에 등급·시간·신뢰도를 부여한다(v1의 평평·무등급·정적 한계 개선).

  • raw/ — 큐레이션한 원본 소스. 본문 immutable — 내용은 절대 수정 금지. 단 ingest 상태 frontmatter 스탬프는 예외(맨 위 메타 블록만 추가/갱신, 본문 무변경 — Obsidian에서 완료 표시가 보이게). 이미지 raw/assets/. 진실의 원천.
  • wiki/ — 4계층 통합 파이프라인 (정보가 아래→위로 승격하며 정제됨):
    • L1-working/ — 작업기억. 현재 세션 관찰·스크래치. 세션 종료 시 압축 후 비움.
    • L2-episodic/ — 일화기억. session-YYYY-MM-DD.md(압축 세션), source-*.md(소스 증거). "언제 무엇이 관찰됐나."
    • L3-semantic/ — 의미기억. fact-*.md·entity-*.md·concept-*.md. 신뢰도 점수 부여. 증류된 지식.
    • L4-procedural/ — 절차기억. procedure-*.md(steps 구조). 반복 관찰된 방법.
    • moc/ — 네비게이션 지도. 계층을 가로질러 L3/L4를 큐레이션. 현관 [[home-moc]].
  • 스키마 = 이 CLAUDE.md — 정본. index.md(전수 카탈로그, 자동) + log.md(시간순 append-only, ## [YYYY-MM-DD] <op> | <제목>).

승격 규칙(정본 요약 — 절차는 wiki-consolidate 스킬): L1→L2 세션 종료 시(3–5줄 압축) · L2→L3 lint 시 같은 주장 3회+ 등장(모순 있으면 보류) · L3→L4 lint 시 같은 절차 2회+ 관찰.

규약

  • 언어: 본문 한국어, 파일명 영문 kebab-case ([[wikilinks]] 깔끔하게). 기술 약어(RLHF/RAG) 인라인 OK.
  • 연결: [[wikilinks]] 양방향. 없는 페이지 링크는 스텁으로 남김. 모든 L3/L4 페이지는 ≥1 MoC 도달 가능(고아 방지).
  • Frontmatter (계층/기능별 필드):
    ---
    type: working | episodic | session | source | fact | entity | concept | procedure | moc | index | log | query
    title: <한국어 제목>
    aliases: []
    tags: []
    created: YYYY-MM-DD
    updated: YYYY-MM-DD
    # --- L3/L4 (신뢰도·망각) ---
    confidence: 0.0~1.0        # confidence.py로 계산 (소스 수·유형)
    sources: [소스 슬러그…]     # 근거 소스 (개수가 신뢰도 결정). 슬러그 = L2 파일명에서 `source-` 뗀 것 (예: source-codex-ci.md → codex-ci). 접두 없이 통일.
    last_confirmed: YYYY-MM-DD  # 재확인마다 갱신 → 망각 리셋
    decay_class: architecture | procedure | concept | entity | episodic | transient
    status: active | stale      # 대체된 정보는 삭제 말고 stale
    superseded_by: [[새-페이지]] # 대체됨 (옛 페이지에)
    supersedes: [[옛-페이지]]    # 대체함 (새 페이지에)
    ---

신뢰도 (confidence)

소스 1개 0.6 / 2개 0.85 / 3개+ 0.95. 공식문서·코드 +0.1, slack·회의록 구두정보 −0.1. 계산은 결정적 — .claude/skills/wiki-consolidate/scripts/confidence.py. 답변·페이지에 신뢰도 병기.

덮어쓰기 (supersession)

새 정보가 옛 정보와 다르면 삭제하지 말고 명시 대체: 옛 페이지 status: stale + superseded_by, 새 페이지 supersedes, 서로 링크, 타임스탬프. 이력 보존.

망각 (forgetting)

Ebbinghaus: 보존율 R=exp(−Δt/S), decay_class가 S 결정(아키텍처 천천히·transient 빠르게). 재확인 시 last_confirmed=오늘 → 리셋. lint가 decay.py로 faded(R<0.3) 페이지를 아카이브 후보로 표시 — 자동 삭제 금지.

편집 규칙

  • raw 본문 immutable은 ingest_status: done인 파일에만 적용. done인 소스는 위키 사실의 근거이므로 본문 수정 금지(스탬프만 예외). done이 아닌 raw 파일(미스탬프·pending·stale·BAD)은 자유롭게 수정 가능 — 아직 인제스트 근거로 쓰이지 않은 초안이므로 정리·재작성·삭제 모두 허용. 특히 raw/working/은 작업용 초안 영역.
  • 재인제스트는 언제든 요청 가능. done인 소스라도 사용자가 재인제스트를 요청하면 수행한다 — 신규 페이지 생성 대신 기존 wiki_source 페이지를 갱신하고 ingested 날짜만 갱신. done 파일 본문이 바뀌어야 하는 상황이면 먼저 사용자 승인을 받고, 수정 후 ingest_status: stale로 낮춰 재인제스트 대상으로 표시한다.
  • 인제스트 완료 시 raw 파일 맨 위에 상태 스탬프 frontmatter만 추가/갱신(본문 무변경):
    ---
    ingested: YYYY-MM-DD
    wiki_source: [[source-슬러그]]   # 생성된 L2 증거 페이지
    ingest_status: done
    ---
    미인제스트 raw 조회: python3 .claude/skills/wiki-lint/scripts/ingest-status.py.
  • 충돌 사실은 삭제 말고 병기(> [!warning] 상충) — 대체는 supersession으로.
  • 파일 이동·이름변경은 승인 후에만 (wikilink 깨짐).
  • 편집 시 기존 frontmatter 보존, updated: 갱신. 사실 재확인이면 last_confirmed도 갱신(망각 리셋).
  • 엔티티 관계는 ## 관계 섹션에 구조화: - caused :: [[b]] (sources: 3, confidence: 0.9) (uses·depends_on·contradicts·caused·fixed·supersedes).

하네스: LLM 위키 운영

목표: 볼트를 LLM 위키로 운영 — 소스 인제스트·질의·린트·MoC 유지를 전문가에게 위임.

트리거: 위키 작업(인제스트·파일링·질의·비교·점검·린트·통합/승격·MoC 정리·세션 종료 압축, 및 "다시/재실행/업데이트/보완/이전 결과 기반") 요청 시 wiki-ops 스킬을 사용하라. 단순 질문은 직접 응답 가능.

세션 종료 시: L1-working이 비어있지 않으면 wiki-consolidate로 L1→L2 압축을 제안한다. 마지막 lint로부터 3일+ 지났으면 lint를 권한다(Stop 훅이 알림).

동기 규칙(MCP 서버): 리트리벌 규칙(랭킹·스코프·팩 형식)을 바꾸면 Python 정본(.claude/skills/wiki-lint/scripts/)·TS 포팅(tools/llmwiki-mcp/src/)·픽스처 골든셋 3점을 한 PR 에서 함께 고친다. 패리티 CI(tests/parity.py)가 어긋나면 실패한다.

변경 이력: CHANGELOG.md — 하네스(구조·규칙·스킬·도구)를 바꾸면 그 파일 맨 아래에 행을 추가한다(| 날짜 | 변경 내용 | 대상 | 사유 |). CLAUDE.md 에는 현재 규칙만 두고 경위는 쌓지 않는다.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.