Memory & Knowledge Pipeline | Keystone Portfolio

원칙

모든 세션을 문서로 저장하지 않습니다. 대화와 시도 맥락은 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는 판단을 담당하고, 공개 사이트는 설명을 담당합니다. 이 분리 덕분에 내부 운영 속도와 공개 포트폴리오 품질을 동시에 유지할 수 있습니다.