エージェントカーネル：ステートフルAIエージェントのための3つのMarkdownファイル

Agent Kernelの機能

Agent Kernelは、3つのマークダウンファイルとgitリポジトリを使用してAIコーディングエージェントをステートフルにする最小限の実装です。データベース、ベクトルストア、カスタムフレームワークを必要とせず、AGENTS.md、CLAUDE.md、.cursorrulesなどのファイルからプロジェクト指示を読み取る既存のメカニズムを活用します。

主要コンポーネント

カーネルは3つのマークダウンファイルで構成されます：

• AGENTS.md – カーネル本体（汎用的、編集不可）
• IDENTITY.md – エージェントの役割を定義（エージェントが管理）
• KNOWLEDGE.md – ナレッジファイルのインデックス（エージェントが管理）

2つのディレクトリ構造が異なるタイプのメモリを扱います：

• knowledge/ – 状態情報を含む：現在の状況に関する事実。エージェントは現実が変化したときにこれらを更新します。
• notes/ – ナラティブ情報を含む：決定、アクション、未解決事項を記録する日次セッションログ。これらは追加のみで、日付が変わった後に変更されることはありません。

セットアップと使用方法

任意のコーディングエージェントでの基本的なセットアップ：

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

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 # or claude, codex, etc.

これにより、同じカーネルを使用しながら異なるアイデンティティとナレッジベースを持つ複数の専門エージェント（ホームラボ、投資、健康など）を実行できます。

仕組み

このアプローチが機能するのは、AIエージェントがすでにAGENTS.mdなどのファイルをプロジェクト指示として読み取るためです。カーネルは「あなたはステートフルです、方法はこちら」と記述したファイルを提供し、プレーンマークダウンファイルでメモリを保存するためにgitリポジトリを使用することで、エージェントに記憶方法を教えます。