Agent Kernel（エージェント・カーネル） — ステートフルAIエージェントの最小カーネル

AI/ML
Agent Kernel（エージェント・カーネル） — ステートフルAIエージェントの最小カーネル

Agent Kernel（エージェント・カーネル） — ステートフルAIエージェントの最小カーネル

Agent Kernelは「クローンして起動、話しかけるだけ」で動作する極めてシンプルなAIエージェント基盤です。フレームワークやデータベースを用いず、3つのMarkdownファイルとGitリポジトリだけでエージェントの状態（会話履歴、アイデンティティ、知識）を永続化します。OpenCodeやClaude Code、Codex、Cursorなど任意のコーディング対応AIエージェントと連携でき、短時間でステートフルな開発エージェントを立ち上げられる点が特徴です。（約300字）

https://github.com/oguzbilgic/agent-kernel

概要

Agent Kernelは、AIコーディングエージェントを状態を持たせて運用するための「最小限のカーネル」です。データベースや複雑なフレームワークを導入せず、リポジトリ内の3つのMarkdownファイル（AGENTS.md、IDENTITY.md、KNOWLEDGE.md）を用いてエージェントの振る舞いや記憶を管理します。使い方は非常にシンプルで、リポジトリをクローンしてエージェントをポイントするだけ。会話の継続、ノートの保存、過去作業の継承といった「状態を持つ」機能が短時間で実現でき、既存のAIコード支援ツールと組み合わせて利用可能です。[導入が容易でプロトタイピングに最適]という位置づけのツールです。（約300字）

GitHub

リポジトリの統計情報

  • スター数: 62
  • フォーク数: 5
  • ウォッチャー数: 62
  • コミット数: 10
  • ファイル数: 4
  • メインの言語: 未指定

主な特徴

  • 最小構成：データベース不要、3つのMarkdownファイルとGitで状態管理を実現。
  • エージェント非依存：OpenCode、Claude Code、Codex、Cursorなど任意のAIコーディングエージェントと連携可能。
  • 即時起動：リポジトリをクローンしてエージェントを指すだけで利用開始できるシンプルなUX。
  • 履歴と知識の蓄積：会話の継続やノート保存、過去作業の参照を設計しやすい設計。

技術的なポイント

Agent Kernelの技術的核は「状態（state）のシンプルだが永続的な表現」にあります。通常、エージェントの状態管理は外部データベースや専用のバックエンドを必要としますが、本プロジェクトはGitリポジトリとMarkdownという軽量な表現でそれを代替します。AGENTS.mdはどのエージェント実装をどう起動するか、IDENTITY.mdはエージェントの性格や長期的なアイデンティティ、KNOWLEDGE.mdは参照可能なドメイン知識やメモを保持します。これにより、外部サービスに縛られずバージョン管理と履歴追跡がネイティブに効きます。

また、テキストベースの管理は可搬性と可監査性に優れます。Markdownで記述された状態は差分が明確で、Gitのコミット履歴を使えばエージェントの振る舞いや知識が時間とともにどう変化したかを追跡できます。さらに、任意のコーディング対応エージェントに対して同一の「状態ディレクトリ」をポイントするだけで、同じ記憶・設定を共有できるため、エージェント切替や比較実験が容易です。開発者は初期のプロトタイプや実験的なワークフローを短時間で構築でき、必要に応じて外部ストレージや複雑な管理層へ発展させるための橋渡しとしても機能します。

特に注目すべきは「最小限の抽象」であり、これにより学習コストを抑えつつ実用的な恩恵（永続化、追跡、共有）を得られる点です。エンタープライズ用途に直接投入する前のプロトタイプや教育目的、研究での比較評価など、手軽さを重視するユースケースにフィットします。（約700字）

プロジェクトの構成

主要なファイルとディレクトリ：

  • AGENTS.md: file
  • IDENTITY.md: file
  • KNOWLEDGE.md: file
  • README.md: file

各ファイルの役割（詳細）：

  • AGENTS.md
    • エージェント接続のエントリポイントと設定を記述するファイルです。どのCLIコマンドやラッパー（例: opencode、claude、codex、cursor）を使ってエージェントを起動するか、起動時に渡すべきコンテキストやプロンプトテンプレートの例が入る想定です。複数のエージェント定義を並べれば、同一リポジトリ上で振る舞いを比較する実験設計が簡単になります。
  • IDENTITY.md
    • エージェントの「人格」や長期的な指針、禁止事項、役割説明などを明文化するためのファイルです。たとえば、出力スタイル（丁寧語／砕けた口調）、セキュリティ上の扱い、受け取る入力の前提条件などをここで定義しておくことで、エージェントが一貫した応答を返しやすくなります。人間のチームと共有するドキュメントとしても有用です。
  • KNOWLEDGE.md
    • プロジェクト固有の知識、過去の設計決定、FAQ、外部参照リンク、メモなどをまとめる場所です。エージェントが参照するコンテキストやリファレンスの集合をここに蓄積することで、会話の質を向上させ、過去の成果を再利用できます。Markdownであるため、リンクやコードブロックを含められ、読み手（人／機械）双方にとって扱いやすい設計です。
  • README.md
    • 利用方法やクイックスタート、プロジェクトの目的を説明するドキュメントです。READMEに書かれた通り、クローン後にエージェントCLIを実行するだけで即座に試せるというUXがウリになっています。将来的により複雑な統合を行う場合の導線（外部サービスやCIの案内）もここに追記できます。

運用上の注意点：

  • Gitベースの永続化は便利だがコミット管理やブランチ運用が重要。機密情報をMarkdownに残さない運用ルールが必要です。
  • 複数人での利用時はコンフリクトやマージ方針を事前に決め、履歴の意味を保つ工夫（コミットメッセージのルールなど）を推奨します。
  • スケールやアクセス頻度が上がれば、Markdown→DBや専用ストレージへの移行を検討するのが自然な進化パスです。

まとめ

シンプルさを武器に、エージェントの「記憶」を手早く試せる実用的なプロトタイプ基盤です。（約50字）

リポジトリ情報：

READMEの抜粋：

Agent Kernel

The easiest way to create an AI agent. Clone, start, talk.

Your agent remembers between sessions, takes notes, and builds on past work. No framework, no database — just three markdown files and a git repo.

Works with any AI coding agent: OpenCode, Claude Code, Codex, Cursor, Windsurf, etc.

Quick start

git clone https://github.com/oguzbilgic/agent-kernel.git my-agent
cd my-agent

Start your agent:

opencode     # or claude, codex, cursor, etc.

That’…