knowledge-ops

Knowledge Operations

여러 저장소를 가로질러 지식을 수집, 정리, 동기화, 검색하는 다층 지식 시스템을 관리합니다.

실시간 워크스페이스 모델을 우선합니다.

• 코드 작업은 실제 클론 저장소에 둡니다
• 활성 실행 컨텍스트는 GitHub, Linear, 저장소 로컬 working-context 파일에 둡니다
• 넓은 인간 친화 메모는 비저장소 context/archive 폴더에 둘 수 있습니다
• 기기 간 지속 메모리는 shadow repo가 아니라 knowledge base에 둡니다

활성화 시점

• 사용자가 지식베이스에 정보를 저장하고 싶을 때
• 문서, 대화, 데이터를 구조화된 저장소로 수집할 때
• 로컬 파일, MCP memory, Supabase, Git 저장소 간 지식을 동기화할 때
• 기존 지식을 중복 제거하거나 정리할 때
• 사용자가 "save this to KB", "sync knowledge", "what do I know about X", "ingest this"라고 할 때

지식 아키텍처

Layer 1: Active execution truth

• GitHub issues, PRs, discussions, release notes, Linear issues/projects/docs
• 현재 작업의 운영 상태를 담습니다
• 활성 엔지니어링 계획, 로드맵, 롤아웃, 릴리스에 영향을 주면 여기에 먼저 둡니다

Layer 2: Claude Code Memory

• 경로: ~/.claude/projects/*/memory/
• frontmatter 포함 Markdown
• 사용자 선호, 피드백, 프로젝트 컨텍스트, 참조 정보
• 세션 시작 시 자동 로드

Layer 3: MCP Memory Server

• create_entities, create_relations, add_observations, search_nodes
• 세션 간 지속되는 구조화 지식 그래프

Layer 4: Knowledge base repo / durable document store

• 장기 노트, 세션 export, 종합 리서치, 운영자 메모, 장문 문서
• 저장소 소유 코드가 아닌 기기 간 지속 컨텍스트의 기본 저장소

Layer 5: External Data Store

• Supabase, PostgreSQL 등
• 구조화 데이터, 대용량 문서, 전체 텍스트 검색

Layer 6: Local context/archive folder

• 인간 친화 노트, 보관된 계획, 로컬 미디어 정리, 임시 비코드 문서
• 정보 저장용이지만 shadow code workspace로 쓰지 않습니다

수집 워크플로

1. 분류

어떤 유형의 지식인지 먼저 분류합니다.

• Business decision -> memory file + MCP memory
• Active roadmap / release / implementation state -> GitHub + Linear first
• Personal preference -> memory file
• Reference info -> memory file + MCP memory
• Large document -> external data store + memory summary
• Conversation/session -> knowledge base repo + short summary in memory

2. 중복 제거

• 기존 memory file 검색
• MCP memory 검색
• GitHub 또는 Linear에 이미 있는지 확인
• 중복 생성 대신 기존 항목을 갱신합니다

3. 저장

• 빠른 접근용 Claude Code memory는 항상 갱신
• semantic search와 relation mapping을 위해 MCP memory 사용
• live project truth가 바뀌면 GitHub / Linear를 먼저 갱신
• 장기 장문 추가는 knowledge base repo에 커밋

4. 인덱싱

관련 인덱스나 summary 파일을 갱신합니다.

Sync 작업

Conversation Sync

• Claude session, Codex session, 기타 agent session을 knowledge base로 동기화
• 세션 인덱스를 만들고 커밋/푸시

Workspace State Sync

• 중요한 workspace 설정과 스크립트를 knowledge base로 미러링
• 민감 설정은 redaction 후 커밋
• knowledge base나 archive를 live code workspace로 취급하지 않음

GitHub / Linear Sync

• 활성 실행에 영향이 있으면 관련 GitHub issue, PR, discussion, release notes, roadmap thread를 갱신
• durable planning context가 필요하면 Linear에 지원 문서를 붙임

Cross-Source Knowledge Sync

• Claude/ChatGPT/Grok export
• browser bookmarks
• GitHub activity events
• 상태 요약 작성 후 커밋/푸시

Memory 패턴

# Short-term
TodoWrite 사용

# Medium-term
~/.claude/projects/*/memory/

# Long-term
GitHub / Linear / KB

# Semantic layer
MCP knowledge graph

모범 사례

• memory file은 간결하게 유지합니다
• 모든 지식 파일에 frontmatter를 사용합니다
• 저장 전 검색하고 중복을 제거합니다
• 사실 집합마다 canonical home 하나를 둡니다
• Git 추적 파일에 커밋 전 민감 정보는 redaction합니다
• knowledge file 이름은 lowercase-kebab-case를 사용합니다
• topic/category 태그를 붙입니다

품질 게이트

• 중복 항목이 생성되지 않았다
• Git 추적 파일에서 민감 정보가 제거됐다
• 인덱스와 summary가 갱신됐다
• 데이터 유형에 맞는 저장 계층을 골랐다
• 관련 크로스 레퍼런스가 추가됐다