Memory & Knowledge Pipeline

한눈에 보기

Memory & Knowledge Pipeline은 모든 대화를 저장하는 시스템이 아닙니다. 자동 회상, 선별 캡처, 정본 문서, 공개 정제를 분리해 내부 운영 속도와 공개 문서 품질을 동시에 유지하는 구조입니다.

• 핵심 질문: 어떤 정보는 자동 기억에 맡기고, 어떤 판단은 정본 문서로 승격해야 하는가?
• 읽는 대상: Memory Bank, PKB, 공개 문서의 역할 차이를 이해하려는 사람
• 연결 문서: Self-Improving Knowledge Loop, Retrospective Loop, Public / Private Boundary

이 문서에서 확인할 것

• 자동 회상과 선별 지식의 차이
• PKB가 raw transcript 저장소가 아닌 이유
• 내부 지식을 공개 문서로 바꿀 때 제거해야 하는 정보

원칙

모든 세션을 문서로 저장하지 않습니다. 대화와 시도 맥락은 Memory Bank가 자동으로 기억하고, 사람이 다시 믿고 따라야 할 결론만 PKB와 프로젝트 문서로 승격합니다.

4단계 구조

단계	담당	저장 대상	기본 행동
자동 회상	Memory Bank	conversation archive, facts, search index	검색과 재사용에 맡김
선별 캡처	/pkb-capture, PKB	결정 요약, 실패 원인, 운영 노하우	사람이 읽을 수 있게 정리
정본 문서	project docs, ai-rules	현재 따라야 하는 절차와 규칙	변경과 함께 갱신
공개 정제	keystone-portfolio, ai-rules-public	공개 가능한 원칙, 사례, 구조	민감정보 제거 후 게시

데이터 흐름

flowchart TD
  A["Conversation and tool use"]
  B["Memory Bank<br/>automatic recall and facts"]
  C["/pkb-capture<br/>curated notes"]
  D["Project docs / ai-rules<br/>canonical procedures"]
  E["keystone-portfolio<br/>public explanation"]
  F["ai-rules-public<br/>distributable public package"]

  A --> B
  B --> C
  C --> D
  D --> E
  D --> F

PKB의 역할

PKB는 raw transcript 저장소가 아닙니다. 다음처럼 반복 가치가 있는 내용을 승인 후보로 다룹니다.

• 아키텍처 의사결정과 근거
• 장애 원인과 재발 방지책
• 여러 프로젝트에서 재사용할 운영 절차
• 에이전트 규칙으로 승격할 후보
• 공개 사례로 정리할 수 있는 추상화된 패턴

Raw 로그 예외

원본 세션 로그는 기본 저장 대상이 아닙니다. 감사, 재현, 품질 분석처럼 원본 증거가 필요한 경우에만 명시적으로 보존합니다. 이 경우에도 공개 사이트에는 원본을 올리지 않고, 필요한 결론만 정제합니다.

공개 변환 기준

공개 문서로 옮기기 전에 아래 항목을 제거합니다.

• 로컬 경로와 개인 머신 정보
• 토큰, 계정, webhook, 외부 통합 세부값
• 회사/고객명과 내부 프로젝트명
• raw transcript와 터미널 원문
• 보안 우회 절차와 내부 스케줄러 상세

결과

Memory Bank는 기억을 담당하고, PKB는 판단을 담당하고, 공개 사이트는 설명을 담당합니다. 이 분리 덕분에 내부 운영 속도와 공개 포트폴리오 품질을 동시에 유지할 수 있습니다.