ktx는 데이터 웨어하우스 컨텍스트를 자동으로 구축·유지하는 자기 개선형(self-improving) 컨텍스트 레이어다. 승인된 메트릭 정의, 조인 가능 컬럼, 비즈니스 지식을 Claude Code·Codex·Cursor·OpenCode 등 AI 에이전트에 주입해 분석 쿼리의 정확도를 높인다.
어떤 문제를 해결하는가
데이터 웨어하우스를 쿼리하는 AI 에이전트는 두 가지 문제에 부딪힌다:
- 테이블·컬럼 구조와 비즈니스 메트릭 정의를 모른다
- 팬-챔 트랩(fan-chasm trap)처럼 도메인 특유의 조인 패턴을 추론하지 못한다
이 두 가지가 잘못되면 조용한 오답이 나온다. ktx는 dbt 시맨틱 레이어, 팀 wiki, Notion 문서를 소화해 에이전트가 올바르게 쿼리하는 데 필요한 컨텍스트를 자동으로 유지한다.
기존 도구와의 비교
| 범용 에이전트 | 시맨틱 레이어 | ktx | |
|---|---|---|---|
| 웨어하우스 컨텍스트 자동 구축 | — | — | ✓ |
| 조인 컬럼 감지 + 팬/챔 트랩 해결 | — | 수동 | ✓ |
| 승인된 재사용 메트릭 정의 | — | ✓ | ✓ |
| wiki·팀 지식 흡수 | — | — | ✓ |
| 모순 감지 | — | — | ✓ |
| CLI + MCP 에이전트 실행 | 부분 | — | ✓ |
| 읽기 전용 설계 | n/a | n/a | ✓ |
설치 및 시작
npm install -g @kaelio/ktx
ktx setup # 프로젝트 초기화, 프로바이더·연결 설정, 컨텍스트 빌드
ktx status # 설정 상태 확인ktx status 출력 예시:
ktx project: /home/user/analytics
Project ready: yes
LLM ready: yes (claude-sonnet-4-6)
Embeddings ready: yes (text-embedding-3-small)
Databases configured: yes (warehouse)
Context sources configured: yes (dbt_main)
ktx context built: yes
Agent integration ready: yes (codex:project)기존 에이전트에서 스킬로 직접 설치:
Run npx skills add Kaelio/ktx --skill ktx and use the ktx skill to install
and configure ktx in this project.주요 기능
| 기능 | 설명 |
|---|---|
| 승인된 메트릭 정의 | 재사용 가능한 메트릭 등록으로 에이전트가 일관된 계산 사용 |
| 조인 컬럼 감지 | 조인 가능 컬럼 자동 감지, 팬·챔 트랩 해결 |
| wiki·팀 지식 흡수 | Notion·Wiki 등 문서에서 비즈니스 맥락 추출 |
| 모순 감지 | 소스 간 상충하는 정의 플래그 |
| CLI + MCP | 에이전트 실행을 위한 CLI와 MCP 서버 제공 |
| 읽기 전용 설계 | 에이전트가 실수로 데이터를 변경하는 것을 방지 |
적용 대상
- 데이터 팀이 AI 코딩 에이전트로 데이터 분석을 자동화하려는 경우
- dbt 기반 시맨틱 레이어를 운영 중이며 에이전트에 정확한 컨텍스트를 제공하고 싶은 경우
- Claude Pro/Max 구독자 또는 자체 LLM API 키 보유자 (ktx 자체는 추가 사용 요금 없음)
관련 문서
- opencode — OpenCode AI 코딩 에이전트
- claude-code — Claude Code 개요
- mcp — Model Context Protocol
참고 자료
- Kaelio/ktx — GitHub 공식 저장소