| name | knowledge-ops |
| description | 여러 저장 계층(로컬 파일, MCP memory, 벡터 스토어, Git 저장소)에 걸친 지식베이스 관리, 수집, 동기화, 검색 스킬입니다. 지식 시스템 전반에 걸쳐 저장, 정리, 동기화, 중복 제거, 검색이 필요할 때 사용합니다. |
| origin | ECC |
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가 갱신됐다
- 데이터 유형에 맞는 저장 계층을 골랐다
- 관련 크로스 레퍼런스가 추가됐다
