Wiki 개선 정리 (2026-10-20) — 수집원 전부 wiki까지, 그리고 세션에 다시 읽히기까지
2026-09-18 글은 “구조가 이렇게 생겼다”였고, 09-21 갱신은 “조회가 record에 밀리던 걸 고쳤다”였다. 이번 글은 그 다음 단계다. 수집은 되는데 wiki에 안 쌓이던 소스들을 전부 wiki까지 보냈고, 쌓인 wiki와 내 메모가 AI 세션에 실제로 읽히게 만들었다. 하루 작업이었고 발견한 결함이 다섯 개였다.
1. 무엇이 문제였나
9월 16일에 “남의 말을 내 정본으로 쓰지 않는다”는 보안 경계를 두 개 넣었다. content 모드 규칙은 지식을 바인딩할 수 없고, Slack 봇 발언은 작성자 권위가 없다는 것. 의도는 맞았는데 결과는 Slack·Gmail·Voice에서 지식이 0건이었다. 수집기 health는 전부 pass라 아무도 눈치 못 챘다. “돌아가는데 쌓이지 않는” 조용한 실패였다.
같은 날 둘째 문제. 10월 7일에 Obsidian vault를 ~/dev-oh/oys-wiki(Sync로 맥북·맥미니 공유)로 바꿨는데, 자동화는 여전히 ~/oyunseong-wiki(Git)를 보고 있었다. 12일 동안 내가 쓴 메모 34건은 Git에 안 올라갔고, 자동 ingest 결과는 내 화면에 안 보였다. 에이전트는 oys-wiki를 “옛 복사본”으로 단정하고 vault를 바꾸라고 했다. 내가 화를 냈다.
셋째. my-wiki(내가 직접 쓰는 메모)는 설계상 “명시 연결한 문서만” AI가 읽는데, 그 연결이 0건이었다. 지도·회의 정리·교육 메모가 세션에 한 번도 들어간 적이 없었다.
2. 무엇을 바꿨나
| 영역 | 전 | 후 |
|---|---|---|
| Slack·Gmail·Voice 지식 | 0건 (경계가 “막기”) | 본문의 고객 용어로 프로젝트를 정하고, 팀 발언은 source_authority: authorized-stakeholder로 표시. 재평가 2,751건 → 발행 77(slack 32·ai 27·voice 13·gmail 5) |
| 제목 | 자동 노트 288건이 영어(FDE culture notes) | 전부 한글 + 핵심 주제. validator가 한글 없는 제목을 거부, prompt·knowns 스킬도 같은 규칙 |
| 폴더 | aidp/ 루트 45건 평면, reference/ | aidp/{fde, sales, ax-cases, operations, product, tech}, personal/{finance, life, work-style, songwol} |
| 사람 vault ↔ Git | 12일 단절 | vault_bridge 10분마다: my-wiki·candidate 양방향, sys-wiki Git→vault |
| my-wiki → AI | 바인딩 0건 | 폴더 규칙으로 179건 자동 바인딩, 새 메모도 10분 뒤 자동 |
| 세션 시작 안내 | 큰 프로젝트에서 3초 guard에 잘려 조용히 빠짐 | Git 조회를 한 프로세스로 묶어 2초대, 항상 출력 |
| 로컬 spool | 49 GB | GCS 확인·미참조 raw 삭제 36.5 GB → 16 GB, 매주 자동 |
3. 지금 흐름 (내가 기억할 것)
flowchart LR R["raw<br/>Slack·Gmail·Notes·AI·Plaud"] -->|6h distill| C["candidate"] C -->|10m verifier| S["sys-wiki<br/>(Git, ~/oyunseong-wiki)"] S -->|10m bridge| V["oys-wiki<br/>(Obsidian Sync)"] V -->|10m bridge| S S -->|route| A["AI 세션<br/>(연결 프로젝트 폴더)"] V -. "my-wiki 바인딩" .-> A A -->|knowns| S
- 내가 할 일은 둘: oys-wiki에 메모 쓰기, 연결 프로젝트 폴더에서 세션 열기. 나머지는 LaunchAgent 25개.
- 세션을 열면 hook이
[wiki 연결] <project> — route --query를 알리고, 첫 작업 전 route가 sys-wiki 정본 최대 4건 + 내 메모를 질의별로 넣는다. - 보류 사유를 읽는 법:
semantic-verification-held(verifier가 “확정된 결정 아님”, 정당),record-kind-not-enabled(status 알림, 의도적 제외),project-ambiguous(고객 둘 언급, 누출 방지). 발행률 17%는 기준을 유지한 결과다.
4. 배운 것
- “되는지”는 health가 아니라 도달로 센다. collector pass → spool → candidate →
auto-ingest-state→git log -- sys-wiki까지 단계별로. 보류 사유가 한 가지로 많이 쌓이면 코드로 결론 내지 말고 후보 1건을 끝까지 재현한다. 09-30과 10-18 두 번project-ambiguous를 “고객 둘 언급”으로 오해했는데 실제는 홈 디렉터리 이름 변경 뒤 symlink 경로 비교 실패였다(718건). - 누가 어느 폴더를 보는지가 “정본”보다 먼저다. 자동화가 보는 폴더와 사람이 보는 폴더가 다르면 둘 다 정상인데 서로 안 보인다.
- 경계는 “막기”보다 “표시하기”. 분류기(모델)는 권위가 아니지만, 프로젝트 결정을 용어 매칭으로 하면 감사 가능하고, 출처 권위를 노트에 적어 두면 사람과 route가 구분한다.
- prompt에 “제목은 한글”을 넣으면 모델이 파일명 slug까지 한글로 낸다. 두 필드의 언어 규칙을 각각 적어야 한다(53건 보류 후 수정).
- hook guard는 fail-open이라 느려지면 안내만 조용히 사라진다. 큰 프로젝트에서
doctor시간을 가끔 재야 한다. - 공개 저장소 impl-note에 고객 repo 이름을 쓰면 history까지 다시 써야 한다. 역할로만 적는다.
5. 아직 안 한 것
my-wiki/personal/notes/·notes/(개인 메모 38건)는 어느 고객 프로젝트에도 바인딩하지 않았다.- 파일명은 영어 slug 유지. wikilink 1,267·registry 경로·topic_key 계약이 slug 기반이라 Obsidian 탐색기에서만 영어가 보인다.
- 출처별 “주간 발행 0건이면 경보”는 아직 health에 없다.
관련
- 정본: raw 수집원별 wiki 적재와 AI 작업 시 wiki 맥락 증강 흐름
- Wiki 현황 정리 (2026-09-18) — 구조와 09-21 갱신
- 내 Wiki — 한 세션에서 CLAUDE.md·hook·skill·wiki가 읽히는 순서
- 토큰 효율 진단 — route가 4건으로 제한하는 이유