knowledge-wiki

Knowledge Wiki

세션 지식을 일반화된 article로 컴파일해서 팀 위키에 쌓는다. Karpathy KB 패턴 — 매번 찾는 게 아니라 위키 자체가 자란다.

한 줄: 세션에서 배운 것만 쌓는다. 있었던 일은 쌓지 않는다.

켜는 법 — 없음. 설치하면 켜집니다

첫 세션이 끝나면 플러그인이 알아서 만듭니다:

~/.wigtn/knowledge-wiki.yml   설정 (자동 생성)
~/.wigtn/wiki/                위키 repo (자동 git init)

그리고 한 번만 안내합니다:

[wigtn] 지식 위키를 켰습니다 → ~/.wigtn/wiki
        세션에서 배운 것이 자동으로 쌓입니다 (로컬 전용, push 없음).

기본값 = 로컬 축적만. remote 가 없으면 push 하지 않습니다. transcript 는 이미 로컬에 있으므로, 로컬 article 은 새로운 노출이 아닙니다. 기계 밖으로 나가는 것만 명시적 설정을 요구합니다.

팀과 공유하려면 — remote 한 줄

wiki:
  remote: [email protected]:myteam/team-wiki.git   # 추가하면 push 시작
  path: ~/Dev/team-wiki                          # 없는 경로면 자동 clone
  subdir: per-user/harry

path 가 없고 remote 가 있으면 자동으로 clone 합니다. 새 팀원은 이 두 줄만 받으면 됩니다. clone 실패 시에는 축적하지 않습니다 (fail-closed).

범위 조정

include:            # 기본값 = 홈 전체 (로컬 전용이라 허용)
  - ~/Dev
exclude:            # 고객사·NDA repo. include 와 repo 마커보다 강하다
  - ~/Dev/client-nda

remote 가 있어도 include 가 홈/루트 전체면 push 는 보류됩니다. 축적과 로컬 커밋은 계속되고, 로그에 사유가 남습니다. include 를 좁히면 그때 push 가 켜집니다. 로컬 축적과 팀 공유는 위험도가 다르고, 그 경계는 권고가 아니라 코드가 집행합니다.

subdir 은 per-user/ 또는 ouroboros/ 아래만 허용됩니다. shared/ 는 사람이 PR 로 승격합니다.

템플릿: scripts/knowledge_wiki/knowledge-wiki.example.yml

repo 마커 (선택) — 예외 처리용

보통은 필요 없다. 아래 세 경우에만 repo 루트에 .wigtn-wiki.yml 을 둔다:

상황	마커 내용
include 밖 repo를 개별 opt-in	enabled: true
이 repo만 다른 위키로	wiki: {path: ..., subdir: ...}
이 repo만 끄기	enabled: false

⚠️ 전역 exclude 와 전역 enabled: false 는 마커보다 강하다. exclude 된 경로, 그리고 전역으로 꺼 둔 상태는 마커가 있어도 거부된다. 마커는 범위 opt-in 이지 kill-switch 해제 가 아니다.

어떻게 동작하나

세션 종료(Stop 훅) 시 4단 게이트를 통과한 것만 커밋·push 된다.

G0 스코프 게이트   include 밖·exclude·자기오염이면 즉시 종료
G1 결정론 차단    원문에 키·자격증명·주민번호 → 1건이라도 hit면 세션 폐기
G2 LLM 컴파일     transcript → 일반화 article (원문 인용 금지)
G3 LLM 감사       별도 호출로 반출 위반 탐지 (통과 판정 권한 없음)
G4 결정론 재검사   article에 전체 패턴 적용 — 이메일·사설 IP·절대경로까지
     ↓
per-user/ 커밋 + push