에이전트 커널: 상태 유지 AI 에이전트를 위한 세 개의 마크다운 파일

Agent Kernel의 기능

Agent Kernel은 세 개의 마크다운 파일과 git 저장소를 사용하여 AI 코딩 에이전트를 상태 저장형으로 만드는 최소한의 구현체입니다. 데이터베이스, 벡터 저장소 또는 커스텀 프레임워크를 요구하는 대신, 에이전트가 AGENTS.md, CLAUDE.md 또는 .cursorrules와 같은 파일에서 프로젝트 지침을 읽는 기존 메커니즘을 활용합니다.

핵심 구성 요소

커널은 세 개의 마크다운 파일로 구성됩니다:

• AGENTS.md – 커널 자체 (일반적, 수정하지 않음)
• IDENTITY.md – 에이전트의 정체성을 정의 (에이전트가 유지 관리)
• KNOWLEDGE.md – 지식 파일 인덱스 (에이전트가 유지 관리)

두 가지 디렉토리 구조가 다양한 유형의 메모리를 처리합니다:

• knowledge/ – 상태 정보를 포함: 현재 상황에 대한 사실들. 에이전트는 현실이 변경될 때 이를 업데이트합니다.
• notes/ – 서술적 정보를 포함: 결정, 행동 및 미결 항목을 기록하는 일일 세션 로그. 이는 추가 전용이며 하루가 끝난 후에는 절대 수정되지 않습니다.

설정 및 사용법

어떤 코딩 에이전트와도 기본 설정:

git clone https://github.com/oguzbilgic/agent-kernel.git my-agent
cd my-agent
opencode # 또는 claude, codex, cursor 등

kern-ai와 함께 (에이전트-커널을 위해 데몬 모드, Telegram 및 Slack 통합을 추가하는 런타임):

npx kern-ai init my-agent
npx kern-ai tui

에이전트가 처음으로 커널을 읽을 때, 그것이 새 것임을 인식하고 당신이 원하는 정체성이 무엇인지 묻습니다. 일단 구성되면, 세션 간에 기억합니다.

다중 에이전트 및 아키텍처

각 에이전트는 자체 저장소에서 실행됩니다. 다른 에이전트를 생성하려면:

git clone https://github.com/oguzbilgic/agent-kernel.git another-agent
cd another-agent
opencode # 또는 claude, codex 등

이를 통해 동일한 커널을 사용하지만 다른 정체성과 지식 기반을 가진 여러 전문화된 에이전트(홈랩, 투자, 건강)를 실행할 수 있습니다.

작동 방식

이 접근 방식은 AI 에이전트가 이미 AGENTS.md와 같은 파일을 프로젝트 지침으로 읽기 때문에 작동합니다. 커널은 "당신은 상태 저장형입니다, 방법은 다음과 같습니다"라고 말하는 파일을 제공하고 git 저장소를 사용하여 일반 마크다운 파일에 메모리를 저장함으로써 에이전트가 기억하는 방법을 가르칩니다.