OpenCrab 온톨로지팩으로 Claude Code 결과물 높이는 법

AI에게 긴 프롬프트를 한 번 건네는 대신, 검증 가능한 지식팩을 먼저 깔면 결과물이 달라질까. OpenCrab을 써본 이들은 로고 작업에서도 품질이 높아졌다고 말한다. 이 글은 그 경험을 재현 가능한 파이프라인으로 바꾸고 어디까지 확인됐는지 묻는다.

OpenCrab은 프롬프트 묶음이 아니라 근거가 연결된 지식팩을 만든다

OpenCrab 공개 저장소는 제품을 두 부분으로 나눈다. LocalCrab은 로컬에서 자료를 수집하고 온톨로지팩을 만든다. opencrab.sh는 완성된 팩을 설치·조회·유통하는 호스팅 영역이다.

팩의 핵심은 문서를 많이 넣는 데 있지 않다. 원문과 파싱 결과에 안정적인 ID, 출처, 시각, 해시를 붙인다. 추출한 개념과 관계는 각각의 근거로 다시 추적할 수 있어야 한다.

Microsoft Research가 공개한 GraphRAG도 비슷한 문제에서 출발했다. 일반 벡터 RAG는 가까운 문단을 찾지만 자료 전체의 관계를 묻는 질문에는 약하다. GraphRAG는 개체와 관계를 그래프로 만들고 연결된 군집을 요약해 전역 질문을 처리한다. OpenCrab은 여기에 재사용 가능한 배포 단위를 더한다. 질문은 "모델이 무엇을 아는가"에서 "어떤 근거 구조를 모델에 공급했는가"로 옮겨간다.

크롤링은 검색창 대신 mission.json에서 시작한다

CrabHarness는 수집 전에 `mission.json`을 작성하도록 설계됐다. 대상 사이트나 저장소, 허용 범위, 깊이, 최대 분량, 속도 제한을 먼저 고정한다. 필요한 증거와 통과 기준도 같은 파일에 넣는다.

공개 예제는 `crabharness plan missions/examples/github-trending-harvest.json`으로 실행 계획을 확인한다. `crabharness delegate ...`는 Codex 작업자에게 전달할 명령을 보여준다. 실제 수집은 `crabharness run ...`으로 시작한다.

실행 폴더에는 동결된 미션, Codex 위임 정보, 로그, 수집 번들, 검증 리포트가 남는다. 통과하면 OpenCrab용 노드·엣지 promotion package도 생성된다. 실패한 URL과 파서 오류까지 증거로 보존하는 구조다.

여기에는 주의할 제한도 있다.

현재 공개 코드의 의미 점수는 키워드 휴리스틱이며 LLM 평가 연동은 예정 상태다. "검증됨"이라는 표시는 사람이 기대하는 의미 품질과 같지 않다.

팩의 품질은 관계를 원문까지 되짚을 수 있느냐로 갈린다

LocalCrab의 공장 흐름은 수집, 파싱, 증거 인덱싱, 그래프 추출, 정규화로 이어진다. 이후 Neo4j에서 참조 무결성을 확인하고 그래프를 다시 내보낸다. 마지막 산출물은 OpenCrab Pack v1 ZIP이다.

ZIP에는 `manifest.json`, `graph/nodes.jsonl`, `graph/edges.jsonl`이 들어간다. `evidence/index.jsonl`과 `quality/report.json`도 필수다. 재현용 Cypher와 예시 질문, 커뮤니티 요약도 포함한다.

공식 규격은 근거 없는 노드나 엣지를 승격하지 못하게 한다. 문서에 이유·개정·적용 제외 정보가 있으면 관계에도 보존해야 한다. 단순한 문서 요약보다 준비가 오래 걸리는 이유다. 써본 사람들 사이에서는 관계형 질문이 선명해졌다는 평가가 있다. 반면 개체 중복, 별칭 통합, 스키마 변경이 가장 큰 유지비라는 반응도 반복된다. 자료가 작고 단순하면 일반 RAG보다 무거울 수 있다.

Codex는 수집하고 Claude Code는 MCP로 팩을 꺼내 쓴다

방에서 공유된 역할 분담은 공개 구조와 맞는다. CrabHarness는 Codex 작업자에게 크롤링을 위임한다. Claude Code는 LocalCrab을 MCP 서버로 등록해 완성된 지식을 조회한다.

설치는 저장소에서 `pip install -e ".[dev]"`로 진행한다. `opencrab serve`를 실행한 뒤 `opencrab status`와 `opencrab manifest`로 상태를 확인한다. `opencrab query "질문"`은 로컬 조회 경로를 시험한다.

Claude Code 연결 명령은 `claude mcp add opencrab -- opencrab serve`다. MCP는 모델과 외부 데이터·도구를 잇는 공개 프로토콜이다. 같은 팩을 여러 작업에서 다시 쓰는 접점이 된다.

1인 사업자라면 제품, 고객, 경쟁사 자료를 미션별로 분리할 수 있다. 소규모 팀은 `manifest.json`의 버전과 출처 범위를 함께 검토할 수 있다.

프롬프트를 복사하는 대신 지식 변경 이력을 관리하는 방식이다.

SVG는 팩을 곧장 그리지 않고 명세와 컴파일을 거친다

OpenCrab 자체는 로고 생성기가 아니다. 온톨로지팩과 여러 스킬을 조합해 SVG까지 만들었다는 경험도 방에서 나왔다. 다만 사용한 로고 스킬과 품질 비교 자료는 공개 정보로 확인되지 않았다.

로고 산출물의 근거를 끝까지 추적할 수 있게 만드는 별도 파이프라인을 붙였다는 설명도 있었다.

산출물은 SVG와 QA 리포트다. `validate` 명령으로 XML, ID, 출처 연결을 다시 검사한다.

브라우저에서 넓은 화면과 좁은 화면을 모두 렌더링해야 작업이 끝난다. 글자 충돌, 잘림, 대비, 확대 가독성도 직접 본다. 로고 사례의 핵심은 모델 조합보다 조사 근거가 명세와 검수까지 끊기지 않는 제작선에 있다.