| type | readme |
|---|
폴더 하나를 에이전트의 장기기억이자 1차 정보원(SoT) 으로 쓰는 워크스페이스 프로토콜.
에이전트와 나눈 대화는 세션이 끝나면 사라지고, 도구마다 기억이 따로 논다. 이 프로토콜은 기억을 도구 안이 아니라 사용자가 가진 폴더에 둔다. 폴더 구조가 곧 분류 체계가 되고, 메모리와 액션 로그가 세션과 PC 와 도구를 넘어 남는다. Claude Cowork, Claude Code, Codex, Cursor, Google Antigravity, Grok Build 가 같은 폴더를 같은 규칙으로 연다.
- 최신 버전: Releases 참고
- 라이센스: PolyForm Noncommercial 1.0.0 또는 PolyForm Internal Use 1.0.0 중 선택. 영리 기업도 사내 업무에는 쓸 수 있고, 고객 납품이나 서비스 제공은 별도 계약이다 (아래 라이센스)
- 회사나 기관에서 도입을 검토한다면: docs/조직-도입-가이드.md
설치는 사람이 파일을 복사하는 일이 아니다. 에이전트에게 설치 패키지를 건네면 에이전트가 설치기를 읽고 폴더를 꾸민다.
-
Releases 에서 가장 최신
context-protocol-<버전>.zip을 내려받는다. 같은 버전에-b2,-b3처럼 빌드 번호가 붙은 파일이 여럿 있으면 번호가 가장 큰 것을 쓴다. -
워크스페이스로 쓸 폴더를 에이전트 도구로 연다.
- Claude Cowork: 프로젝트에 폴더를 연결한다
- Claude Code, Codex, Cursor, Antigravity, Grok Build: 그 폴더에서 에이전트를 실행한다
-
zip 을 대화에 첨부하거나 폴더 안에 넣고 이렇게 말한다.
이 파일을 압축해제해서 설치해줘 -
에이전트가 묻는 질문(백엔드 종류 등)에 답한다. Claude Cowork 처럼 프로젝트 지침을 붙여넣는 층이 있는 도구라면 마지막에 출력되는 블록을 프로젝트 설정 > 지침에 붙여넣는다. 나머지 도구는 붙여넣을 것이 없다.
이미 이 프로토콜을 쓰는 폴더라면 같은 방법으로 새 zip 을 건네면 된다. 에이전트가 기존 설치를 알아보고 덮어쓰지 않고 버전 차이만 적용한다.
도구별 차이, 설치 후 확인 항목, 막혔을 때의 대응은 docs/설치-가이드.md 에 있다.
<워크스페이스>/
CONTEXT.md 규칙 정본이자 세션 진입점. 백엔드 설정이 frontmatter 에 있다
AGENTS.md 포털. Codex, Cursor 등이 스스로 읽고 CONTEXT.md 로 넘어간다
CLAUDE.md 포털. Claude 계열이 스스로 읽고 CONTEXT.md 로 넘어간다
_project.md 이 워크스페이스가 무엇인지 (다른 워크스페이스가 import 할 때 본다)
memory/MEMORY.md 메모리 인덱스. 사용자 정체성, 선호, 피드백, 진행 상태만
action-log/ 날짜별 사건 기록 (YYYY-MM-DD.md)
_context-protocol/ 가이드, 온톨로지 규약, 백엔드와 하네스 프로파일, 도구
이후의 지식은 주제별 폴더로 쌓인다. 폴더 위치가 곧 "이것이 무엇인가" 에 대한 분류다.
에이전트 도구 (하네스)
| 도구 | 상태 |
|---|---|
| Claude Cowork | 지원 |
| Claude Code | 실측 통과 |
| Codex (CLI, ChatGPT Work 모드) | 실측 통과 |
| Cursor | 실측 통과 |
| Google Antigravity | 실측 통과 (agy CLI) |
| Grok Build | 실측 통과 (대화형) |
| 파일 첨부만 하는 대화형 제품 | 열람 모드 전용, 미검증. 기록이 쌓이지 않는다 |
목록에 없는 도구도 폴더에 파일을 쓸 수 있으면 generic 폴백으로 동작한다.
저장 위치 (백엔드)
| 백엔드 | 상태 |
|---|---|
gdrive (구글 드라이브 동기화 폴더) |
실측 검증. 여러 PC 에서 같은 워크스페이스 |
local (일반 로컬 디렉토리) |
지원. PC 한 대 전제 |
git (동기화 폴더 밖의 git clone) |
선택(8.3). pull, 요청 단위 커밋, 수시반영 또는 승인반영(PR). 설치할 때 사용자가 고를 때만 |
onedrive, dropbox |
예약. 프로파일이 없어 폴백 규칙으로 동작 |
주제별 온톨로지 묶음이다. 설치 패키지에 같이 들어 있지만 설치 대상이 아니다. 설치를 마친 뒤 이름을 대며 요청할 때만 적용된다.
personal rag 프리셋으로 세팅해줘
| 프리셋 | 무엇을 위한 것인가 |
|---|---|
personal-rag |
한 사람을 디지털 트윈으로 표현하는 개인 지식그래프 |
team-ops |
한 팀의 운영 지식. 중심 타입은 Decision |
창업 |
예비창업자와 초기창업기업의 사업 자료. 중심 타입은 가설 |
compliance |
법령에서 사내 규정, 통제, 이행 증거까지의 사슬 |
product-ideation |
프로젝트급 개념 하나를 축과 측면으로 분해하는 뼈대 |
프리셋 호출 계약은 presets/preset-library.md.
이 저장소는 프로토콜의 정본만 담는다. 설치 패키지(zip)는 저장소에 넣지 않고 GitHub Release 로만 배포한다.
_context-protocol/
CONTEXT_GUIDE.md 레이어 모델, 하드 룰, 마운트 함정, 조회와 쓰기 프로토콜의 정본
_ontology.md 구조 우선 온톨로지 규약, 쓰기 전 분해
_schema/ concept-scheme (frontmatter 키 규약)
_views/ 인덱스와 무결성 린트 뷰
_concepts.base 개념 노트 베이스 뷰
backends/ 백엔드 능력 계약과 프로파일 (gdrive, local)
harnesses/ 하네스 능력 계약과 프로파일 7종
installers/ CONTEXT_SETUP.md (신규), CONTEXT_MIGRATE.md (기존 버전 올리기)
tools/ hwp2md.py (한글 문서 변환), integrity_lint.py (무결성 린트 실행판)
presets/ 주제별 온톨로지 프리셋 5종
package/README.md zip 루트에 들어가는 README. 압축을 푼 에이전트가 가장 먼저 읽는다
scripts/build.sh 설치 패키지 빌드와 검증
docs/ 설치 가이드, 조직 도입 가이드, 릴리스 절차
tests/ 린트 단위 테스트
LICENSE, LICENSES/ 이용 조건
CHANGELOG.md 버전별 변경
처음 읽는다면 이 순서가 빠르다.
- package/README.md - 설치가 실제로 어떻게 진행되는가
- _context-protocol/CONTEXT_GUIDE.md - 규범 전체
- _context-protocol/_ontology.md - 폴더가 곧 온톨로지라는 방식
- _context-protocol/harnesses/agent-harness.md, _context-protocol/backends/storage-backend.md - 도구와 저장 위치를 흡수하는 방법
설치기 두 개는 가이드와 템플릿 전문을 자기 안에 블록으로 들고 있다. 정본을 고치면 설치기
블록도 같이 고쳐야 하고, scripts/build.sh 가 둘이 어긋나면 빌드를 멈춘다.
scripts/build.sh # dist/context-protocol-<버전>.zip
scripts/build.sh 2 # dist/context-protocol-<버전>-b2.zip버전은 CONTEXT_MIGRATE.md 의 LATEST_VERSION 에서 읽는다. 스탬프 대조, 블록 대조, MANIFEST
생성, 압축 해제 후 diff -r 검증까지 한 번에 한다. 릴리스 절차는 docs/릴리스.md.
설치한 워크스페이스의 구조가 규칙을 지키는지 에이전트 없이 확인한다. 위반이 있으면 종료 코드 1 이라 CI 에 걸 수 있다. 자세한 쓰임은 조직 도입 가이드 5절.
python3 _context-protocol/tools/integrity_lint.py <워크스페이스 루트>Copyright 2026 임한솔. 아래 두 라이센스 중 하나를 골라 쓴다(LICENSE).
비상업 조건이 붙어 있어 OSI 기준의 "오픈소스" 가 아니라 소스 공개(source-available) 다. 요약하면 이렇다. 법적 효력은 원문에만 있다.
| 할 수 있다 | 할 수 없다 (별도 상업 라이센스 필요) |
|---|---|
| 개인 워크스페이스, 연구, 학습, 취미 프로젝트 | 고객사에 설치해 주거나 납품물에 포함하기 |
| 학교, 공공기관, 비영리 단체에서 쓰기 | 호스팅 서비스나 유료 교육, 컨설팅 상품으로 제공하기 |
| 영리 기업의 사내 업무에 쓰기 (사내 SoT, 평가, PoC, 사내 수정) | 이 프로토콜이나 파생물을 판매하기 |
| 비상업 조건으로 수정해 다시 배포하기 | 영리 목적으로 회사 밖에 배포하기 |
다시 배포할 때는 LICENSE 첫 줄의 Required Notice: Copyright 2026 임한솔 (...) 을 그대로 함께
전달한다. 상업 라이센스나 쓰임 판단이 필요하면 이슈 로 문의한다.