Hermes 디렉토리 구조 템플릿

Hermes 디렉토리 구조 템플릿 이 저장소는 목적에 따라 체계적으로 구성된 ~/.hermes 폴더를 위한 표준화된 파일 시스템 레이아웃 템플릿을 제공합니다. 이는 Hermes AI 에이전트를 구성, 확장 및 관리하기 위한 보일러플레이트 (Boilerplate) 역할을 합니다.

파일 시스템 레이아웃
~/.hermes/
├── config.yaml # 메인 설정 (Main configuration)
├── .env # API 키 및 비밀 정보 (API keys and secrets)
├── auth.json # OAuth 제공자 자격 증명 (OAuth provider credentials)
├── SOUL.md # 에이전트 정체성 (시스템 프롬프트의 슬롯 #1)
├── memories/ │
│ ├── MEMORY.md # 지속적인 에이전트 사실 정보 (Persistent agent facts) │
│ └── USER.md # 사용자 모델 (User model)
├── skills/ # 모든 기술 (Skills) (번들형, 허브형, 에이전트 생성형)
│ ├── mlops/ │
│ │ ├── axolotl/ │
│ │ │ ├── SKILL.md # 기술을 위한 시스템 프롬프트 (The system prompt for the skill) │
│ │ │ ├── references/ # 에이전트가 읽는 문서 (Docs the agent reads) │
│ │ │ └── scripts/ # 실행 가능한 헬퍼 (Executable helpers) │
│ │ └── vllm/ │
│ └── devops/ │
└── .hub/ # Skills Hub 상태 (Skills Hub state)
├── sessions/ # 플랫폼별 세션 메타데이터 (Per-platform session metadata)
├── state.db # FTS5가 적용된 SQLite 세션 저장소 (SQLite session store with FTS5)
├── cron/ │
│ ├── jobs.json # 예약된 작업 (Scheduled jobs) │
│ └── output/ # Cron 실행 출력 (Cron run outputs)
├── plugins/ # 커스텀 플러그인 (Custom plugins)
├── hooks/ # 라이프사이클 훅 (Lifecycle hooks)
├── skins/ # CLI 테마 (CLI themes)
└── logs/ │
├── agent.log # 핵심 에이전트 진단 로그 (Core agent diagnostics) │
├── gateway.log # 게이트웨이 트래픽 로그 (Gateway traffic logs) └── errors.log # 에러 추적 (Error tracking)

구성 요소 분석

1. 설정 (Configuration)
   에이전트가 매 실행 시마다 부팅하는 데 사용하는 핵심 파일들입니다.
   config.yaml : 글로벌 설정, 모델 엔드포인트(Model endpoints) 및 운영 파라미터를 처리합니다.
   .env : 민감한 API 키 및 토큰 전용 로컬 환경 변수입니다.
   auth.json : 활성 OAuth 토큰 및 멀티 제공자 자격 증명을 관리합니다.
   SOUL.md : 에이전트의 핵심 정체성, 행동 제약 조건 및 성격 기준을 정의합니다.

2. 지식 (Knowledge)
   모든 활성 통신 채널과 세션에 걸쳐 유지되는 지속적인 메모리 계층입니다.
   MEMORY.md : 에이전트에 의해 수집된 사실 기반 및 장기적 세계 지식입니다.
   USER.md : 사용자에 대해 컴파일된 프로필, 선호도 및 행동 통찰력입니다.

3. 역량 (Capabilities/Skills)
   에이전트에게 특정 실행 가능한 능력을 부여하는 모듈형 기술 팩입니다.

기술 (Skills)은 내장될 수도 있고, Hub를 통해 다운로드하거나 에이전트 스스로가 동적으로 생성할 수도 있습니다. 각 개별 기술은 엄격한 내부 구조를 따릅니다:

• SKILL.md: 에이전트에게 기술을 어떻게, 언제 호출해야 하는지 지시하는 기술적 시스템 프롬프트 (System Prompt).
• references/: 기술에 필요한 문맥적 문서, API 명세(API specs) 또는 참조 가이드.
• scripts/: 기술이 실행하는 실행 가능한 자동화 코드, 바이너리(Binaries) 또는 헬퍼 도구(Helper tools).

4. 런타임 상태 (Runtime State)
   휘발성 실행 데이터 및 플랫폼 정렬 상태를 추적합니다.

• sessions/: 특정 플랫폼(예: Slack, Discord, Terminal)별로 분할된 메타데이터를 저장합니다.
• state.db: 초고속 전체 텍스트(Full-text) 이력 검색을 위해 FTS5 확장을 사용하는 임베디드 SQLite 데이터베이스.

5. 자동화 (Automation)
   사용자의 명시적인 호출 없이도 에이전트가 주기적이고 자율적인 작업을 수행할 수 있도록 합니다.

• cron/jobs.json: 백그라운드 작업의 일정, 간격 및 대상 함수를 정의합니다.
• cron/output/: 에이전트가 자신의 백그라운드 작업을 감사(Audit)할 수 있도록 실행 로그 및 표준 출력(Standard output)을 캡처합니다.

6. 확장 (Extension)
   고급 커스터마이징을 위한 전용 커스터마이징 영역입니다.

• plugins/: 핵심 아키텍처 역량을 확장하는 독립적인 로직 블록.
• hooks/: 시스템 생명주기 이벤트(예: 부팅 전(Pre-boot), 응답 후(Post-response))를 가로채는 인터셉터(Interceptors).
• skins/: 명령줄 인터페이스(CLI)를 위한 사용자 정의 시각적 정의 및 스타일 시트.

7. 관측 가능성 (Observability)
   오류 격리, 정기 감사 및 디버깅을 위한 전용 진단 시스템입니다. 로그는 스택 트레이스(Stack trace) 분석을 간소화하기 위해 서브시스템별(agent.log, gateway.log, errors.log)로 분리됩니다.

시작하기
환경 내 로컬에 이 구조를 초기화하려면, 이 템플릿을 홈 디렉토리 또는 대상 경로로 직접 클론(Clone)하세요:

git clone https://github.com/KhaiTrang1995/hermes-structure.git ~/.hermes