피드로 돌아가기
Dev.toAI/ML
원문 읽기
Markdown 기반 OKF 도입을 통한 Agent Context 지속성 확보
OKF for Claude Code: structured, portable memory your agent (and team) can read
AI 요약
Context
AI 에이전트의 세션 초기화에 따른 프로젝트 컨텍스트 소실 문제 발생. CLAUDE.md의 과도한 토큰 소모와 Auto-memory의 암시적 특성으로 인한 팀 단위 지식 공유 및 버전 관리 한계 직면.
Technical Solution
- YAML frontmatter를 포함한 Markdown 파일 디렉토리 구조의 Open Knowledge Format(OKF) 채택
- '1 Concept = 1 File' 원칙을 통한 지식의 원자화 및 파일 경로 기반의 고유 ID 부여
- Markdown 링크를 활용한 지식 간 Graph 구조 설계로 데이터 간 상호 참조 및 추적성 확보
- Git 기반의 버전 관리 체계에 통합하여 PR을 통한 지식 검토 및 Diff 분석 가능 구조 구현
- Python 기반의 결정론적 검증기(/okf:validate)를 통한 스펙 준수 여부 강제
- HTML 기반의 정적 시각화 도구를 통한 Backend 없는 지식 그래프 렌더링 구현
실천 포인트
1. 프로젝트 내 .okf 디렉토리를 생성하고 지식 단위로 Markdown 파일 분리
2. 모든 파일 상단에 'type' 필드가 포함된 YAML frontmatter 정의
3. 단순 지침은 CLAUDE.md에, 팀 공유 지식은 OKF에 배치하는 계층적 메모리 전략 수립
4. CI 파이프라인에 OKF 검증 스크립트를 추가하여 문서 정합성 자동 검사