agentleFS
cookyman74cookyman74/llmwiki-harness/.claude/skills/wiki-consolidate/SKILL.md

wiki-consolidate

Skill34 starsChanged 3 months agoMITView on GitHub

Runs the 4-tier memory consolidation pipeline of the LLM wiki — compress L1-working into L2-episodic at session end, promote recurring claims L2→L3-semantic, extract repeated procedures L3→L4-procedural, and recompute confidence. Use for "세션 종료/마무리", "L1 압축", "통합/consolidate", "승격", "기억 정리", and during lint passes.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. wareagledusty/wiki-federation-starter-kit★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository8 other files it gives its agents.

The file

Files
SKILL.md

wiki-consolidate

인간 기억을 본뜬 4계층 통합 파이프라인. 정보는 아래층(휘발·구체)에서 위층(영속·추상)으로 승격하며 정제된다. 무엇이든 영원히 동등하지 않다 — 반복 확인된 것만 위로 올라간다.

L1-working  →  L2-episodic  →  L3-semantic  →  L4-procedural
(세션 스크래치)  (세션·소스 증거)   (사실·엔티티·개념)   (절차 steps)

L1 → L2 (세션 종료 시)

목적: 작업기억을 비우되 잃지 않는다.

  1. wiki/L1-working/의 모든 관찰을 읽는다.
  2. 3–5줄로 압축 — 이번 세션에서 무엇을 관찰/결정했나.
  3. wiki/L2-episodic/session-YYYY-MM-DD.md로 저장 (type: session). 압축 안에 핵심 주장은 - claim:: <내용> 인라인 필드로 표기(→ L2→L3 클러스터링 대상).
  4. wiki/L1-working/를 비운다(.gitkeep만 남김).
  5. log.md에 ## [오늘] consolidate | L1→L2 session append.

L2 → L3 (lint 시)

목적: 반복 관찰된 일화를 지속 지식으로 승격.

  1. python3 .claude/skills/wiki-consolidate/scripts/list-claims.py . — L2 전체의 claim:: 라인 수집.
  2. 의미가 같은 주장을 클러스터링(스크립트는 라인만 모음, 동치 판단은 LLM). 같은 주장이 3회 이상 서로 다른 세션/소스에서 등장하면 승격 후보.
  3. 모순 증거가 있으면 승격 보류 — 대신 lint 리포트에 상충으로 보고.
  4. 승격: wiki/L3-semantic/fact-<주제>.md 생성/갱신. frontmatter에 sources: [...], confidence:(→ confidence.py 계산), last_confirmed: 오늘, decay_class:. 근거 세션/소스와 양방향 링크. 알맞은 MoC 편입.
  5. log append.

L3 → L4 (lint 시)

목적: 반복되는 방법을 절차로 추출.

  1. L3에서 같은 절차가 2회 이상 관찰되면 후보.
  2. wiki/L4-procedural/procedure-<주제>.md로 steps 구조화:
    ## 단계
    1. <행동>
    2. <행동>
    type: procedure, decay_class: procedure(느린 망각), last_confirmed: 오늘.
  3. 원천 L3 페이지와 링크. MoC 편입. log append.

배치 병합 (lazy 인제스트 후속 — v2.1)

경량 인제스트는 기존 개념을 안 건드리고 L2에 claim::만 남긴다. lint에서 그 지연분을 일괄 처리한다(고추론 = opus):

  1. python3 .claude/skills/wiki-consolidate/scripts/list-claims.py .로 L2 전체 claim 수집 + python3 .claude/skills/wiki-ingest/scripts/concept-index.py .로 기존 L3 카탈로그.
  2. claim ↔ 기존 L3 매칭. 같은 개념을 말하는 claim이 있으면 해당 L3 페이지에 사실 통합 + sources:에 그 소스 추가.
  3. 신뢰도 재계산(아래) + last_confirmed 갱신.
  4. 관계 ## 관계 구조화(인제스트에서 지연된 것) — 개념 간 uses/depends_on/caused/fixed 등 추가.
  5. 중복 초안 정리 — 같은 개념의 신규 초안이 둘 이상이면 병합(supersession 규칙).
  • 왜 배치인가: 병합은 여러 소스가 쌓인 뒤 한 번에 보는 게 효율적이다(소스마다 O(n) 전수 스캔 회피). 한 lint에서 이슈 다수를 묶어 처리해 오케스트레이터 왕복도 줄인다.

신뢰도 재계산

승격·재확인 시 python3 .claude/skills/wiki-consolidate/scripts/confidence.py --kinds <official,normal,verbal,…> (또는 --count N --official/--verbal)로 점수를 구해 frontmatter confidence:에 기록. 규칙: 1소스 0.6·2소스 0.85·3+ 0.95, 공식/코드 +0.1, 구두 −0.1.

왜 계층인가

v1은 모든 정보가 평평하고 동등했다 — 일시적 버그 메모와 핵심 아키텍처 결정이 같은 무게. 계층은 반복·시간·신뢰도로 정보를 차등한다. 자주 확인되는 것은 위로 올라가 오래 살고(L4 절차), 한 번 스친 것은 아래에서 망각된다(L1/transient). 사람 기억이 그렇게 작동한다.

자동 적용 금지

승격·stale 마킹·아카이브는 제안 먼저. L1→L2 압축은 세션 종료 루틴이라 사용자 확인 후 실행(자율 모드면 생략). 승격은 lint 리포트에 후보로 올리고 승인받아 반영.

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.