용어 사전
용어 사전
AI4PKM 문서에서 사용되는 핵심 용어 정의.
핵심 컴포넌트
Orchestrator
이벤트를 감지하고 Agent를 실행하는 핵심 시스템. 파일 감시, 스케줄 실행, Task 관리를 담당.
→ 상세: (0) Orchestrator 개요
(CLI) Agent
프롬프트를 실행하는 주체. Trigger(실행 조건), Executor(실행 엔진), Prompt(작업 지침)로 정의됨.
- type: agent
name: Enrich Ingested Content
prompt: EIC # 무엇을 할지
executor: claude_code # 어떻게 실행할지
input_path: Ingest/Clippings # 언제 실행할지 (Trigger)
Task
Agent가 작업을 수행할 때 생성되는 결과 기록 문서 (.md 파일). Input, Output, 실행 상태가 기록됨.
Task 상태:
| 상태 | 의미 |
|---|---|
| Pending | 대기 중 |
| Processing | 실행 중 |
| Processed | 완료 |
| Failed | 실패 |
Worker
특정 Executor로 작업을 수행하는 인스턴스. Multi-Worker 설정 시 동일 입력을 여러 AI 모델이 동시에 처리.
workers:
- executor: gemini_cli
label: Gemini
- executor: claude_code
label: Claude
→ 상세: (4) Orchestrator 설정#Worker 설정 필드
Executor
실제 작업을 수행하는 AI 실행 엔진.
| Executor | 설명 |
|---|---|
claude_code |
Claude Code CLI (기본값) |
gemini_cli |
Google Gemini CLI |
codex_cli |
OpenAI Codex CLI |
Prompt
Agent가 실행할 작업 지침. _Settings_/Prompts/ 디렉토리에 마크다운 파일로 저장.
파일 명명 규칙:
EIC.md → Enrich Ingested Content
DDC.md → Daily Driver Cache
SPE.md → Search Pilot Eval
이벤트 & 트리거
Trigger
Agent 실행을 시작하는 조건.
| 타입 | 설명 |
|---|---|
new_file |
새 파일 생성 감지 |
updated_file |
파일 수정 감지 |
manual |
수동 실행 |
cron |
스케줄 실행 |
Poller
외부 데이터를 주기적으로 가져오는 컴포넌트.
| Poller | 데이터 소스 |
|---|---|
limitless |
Limitless 대화 기록 |
apple_photos |
Apple Photos 사진 |
설정 & 구조
Vault
Obsidian 개념을 계승한 지식 저장소. 마크다운 파일과 설정 파일이 저장되는 폴더.
orchestrator.yaml
Vault 루트에 위치한 Orchestrator 설정 파일.
→ 상세: (4) Orchestrator 설정
max_concurrent vs max_parallel
| 설정 | 범위 | 설명 |
|---|---|---|
max_concurrent |
전역 | 시스템 전체 동시 실행 Agent 수 |
max_parallel |
Agent별 | 동일 Agent의 동시 Task 수 |
도구
Gobi Desktop
Orchestrator의 GUI 클라이언트. 시각적 설정, 모니터링, Task 관리 제공.
→ 상세: (2) Gobi Desktop 가이드
CLI Agent
터미널에서 AI와 대화하며 작업을 수행하는 커맨드라인 도구.
| CLI Agent | 설명 |
|---|---|
| Claude Code | Anthropic의 공식 CLI (권장) |
| Gemini CLI | Google의 Gemini CLI |
| Codex CLI | OpenAI의 Codex CLI |
모든 CLI Agent를 사용할 수 있지만, 스킬 시스템 지원과 MCP 연동 등 확장 기능이 가장 잘 지원되는 Claude Code를 권장합니다.
claude # 대화 시작
claude "오늘 할 일 정리" # 즉석 요청
claude --resume # 이전 대화 이어가기
DDA (Daily Driver Agent)
일상 운영을 담당하는 기본 Agent. 매일 브리핑, 저널 작성, 일정 관리 등을 수행.
→ 상세: (3) Agent Skill 가이드#DDA (Daily Driver Agent) 연동
CLI Agent 확장
Agent Config 파일
각 CLI Agent의 컨텍스트와 설정을 정의하는 파일. Vault 루트에 위치.
| 파일 | 대상 Agent | 설명 |
|---|---|---|
CLAUDE.md |
Claude Code | 프로젝트 구조, 컨벤션, 특별 지침 |
AGENTS.md |
공통 | 모든 Agent가 참조하는 공통 설정 |
GEMINI.md |
Gemini CLI | Gemini 전용 설정 |
# CLAUDE.md 예시
- 이 프로젝트는 TypeScript 사용
- 테스트는 Jest로 작성
- 커밋 메시지는 Conventional Commits 형식
Skill
CLI Agent의 재사용 가능한 기능 모듈. 특정 작업을 수행하는 프롬프트와 로직이 패키징된 형태.
Claude Code:
# 자동 감지 및 호출
claude "/commit" # 커밋 메시지 생성
claude "/review-pr" # PR 리뷰
다른 CLI Agent (Gemini, Codex):
# 명시적 스킬 파일 경로 지정 필요
gemini --system-instruction "$(cat ~/.claude/skills/commit/SKILL.md)" "커밋 메시지 생성해줘"
스킬은 SKILL.md 파일 형식으로 정의되며, 다른 CLI Agent에서도 사용 가능합니다.
단, Claude Code와 달리 명시적으로 스킬 파일을 지정해야 합니다.
Skill 저장 위치:
- 사용자 Skill:
~/.claude/skills/ - 프로젝트 Skill:
.claude/skills/
→ 상세: (3) Agent Skill 가이드
Obsidian 확장
Base
Obsidian의 데이터베이스 플러그인. 마크다운 파일을 테이블/보드 뷰로 관리.
| 뷰 타입 | 용도 |
|---|---|
| Table | 스프레드시트 형태 |
| Board | 칸반 보드 |
| Gallery | 이미지 갤러리 |
| Calendar | 캘린더 뷰 |
Dataview
마크다운 파일을 쿼리로 조회하는 플러그인. frontmatter와 인라인 필드를 기반으로 동적 목록 생성.
| File | 생성일 | status |
|---|
Templater
동적 템플릿 플러그인. 날짜, 파일명, 사용자 입력 등을 변수로 활용.
참조
- (0) Orchestrator 개요 - 아키텍처 개요
- (4) Orchestrator 설정 - 설정 레퍼런스
- (0) 실전 가이드 개요 - 시작 가이드
학습 경로
| 레벨 | 추천 문서 |
|---|---|
| 초보자 | (0) 실전 가이드 개요 → (2) Gobi Desktop 가이드 |
| 중급자 | (0) Orchestrator 개요 → (4) Orchestrator 설정 |
| 고급자 | (3) Agent Skill 가이드 |