# Agent Home (エージェント・ホーム)

*ロールごとのディレクトリ。履歴つきで、普通のファイルのまま持ち出せます。*

> **Agent Home** は、ロールごとに用意する、履歴つきのディレクトリです。指示、スキル、記憶、ジャーナル、作業場所のすべてが普通のファイルで入っています。どのランタイムからも入ることができ、離れるときは丸ごと持ち出せます。

**AN-01** · 準拠レベル: L0 Files · グループ: 作業

## 解決する課題

エージェントの状態は、フレームワークのデータベース、ベンダーがホストする記憶 API、いつ消えてもおかしくないサンドボックスのディスクに散らばっています。フレームワークやベンダーを変えれば状態は失われ、何かがおかしくなっても、エージェントが実際に何を知っているのかを一か所で確認する手段がありません。

一方で、主流のエージェントはファイルに収れんしつつあります。`AGENTS.md`、Agent Skills、Git で支えられた記憶のリポジトリなどです。足りないのは新しい形式ではなく、それらを置く場所、つまり **所有者、履歴、クォータ、保証されたエクスポート** のある場所です。

## 仕組み

- **レイアウトはオープンな慣習に従います。** 下のスケッチのとおり、`AGENTS.md`、Agent Skills の `SKILL.md`、YAML フロントマターつきの Markdown です。独自の形式は作りません。
- **Home は 1 回の実行ではなく、ロールに属します。** 実行は [ブランチ](https://agentnas.com/ja/concepts/agent-branch/) を通して Home を使います。変更はまずブランチに入り、レビューを経て Home にマージされます。
- **履歴があります。** すべての変更はコミットです。`nas export` や `git clone` で、`.nas/` のプレーンテキストのメタデータも含め、Home をまるごと持ち出せます。
- **起動時のコンテキストは、いくつかのファイルを読むだけです。** `AGENTS.md`、`memory/MEMORY.md`、受信箱の要約。特別な起動プロトコルはありません。NAS がトークン数を絞った `briefing` ビューを便宜として提供してもかまいませんが、必須ではありません。
- **自動で読み込まれるのは、レビュー済みのノートだけです。** `reviewed` とマークされたノートだけが `MEMORY.md` と自動読み込みのコンテキストに入ります。[Trust Labels](https://agentnas.com/ja/concepts/trust-labels/) と [Agent Memory](https://agentnas.com/ja/concepts/agent-memory/) を参照してください。
- **ライフサイクル。** テンプレートからの作成、クォータ、アーカイブと退役。退役時には後継者を指定できます。

## 小さく始める

- `AGENTS.md`、`skills/`、`memory/` を置いたディレクトリを作り、`git init` します。`CLAUDE.md` などは `AGENTS.md` へのシンボリックリンクにします。
- 実行のたびに `git worktree add` して、実行ごとに自分の作業ツリーで動かします。
- これが L0 です。Agent NAS のソフトウェアがなくても、履歴つきで持ち出せる Home がすでに手に入ります。

## インターフェースのスケッチ

説明用の例です。フィールド名は仕様 v0.3 までに変わる可能性があります。

*layout*

```text
/agents/cleo/                    # a role's Home: it belongs to the role, not to one run
├── AGENTS.md                    # instructions (open convention)
├── skills/                      # Agent Skills: one directory per skill
│   └── release-notes/SKILL.md
├── memory/
│   ├── MEMORY.md                # reviewed core memory: auto-loaded, token-capped
│   ├── notes/                   # notes: Markdown + YAML frontmatter
│   ├── journal/                 # raw log: append-only
│   └── quarantine/              # unreviewed notes: recallable, never auto-loaded
├── inbox/                       # tasks and messages received
├── outbox/                      # deliverables and replies
├── workspace/                   # scratch space (retention class: scratch)
└── .nas/                        # plain-text metadata: role.yaml, limits.yaml, maintenance.yaml
```

## 仕様が求めること

- Home は、Store だけから再構築できなければならない。読み取りが、導出データに依存してはならない。
- `.nas/` のメタデータはプレーンテキストでなければならず、Home と一緒にエクスポートされなければならない。
- 自動読み込みされるコンテキストは、トークン数に上限があり、レビュー済みのノートだけから来なければならない。
- レイアウトは、オープンな慣習（`AGENTS.md`、`SKILL.md`、YAML フロントマターつきの Markdown）に従うべきである。
- 実行は、ブランチを通して Home を使わなければならない。

## 借りたものと、新しいもの

以下はすべて既存のものを借りています。**新しい部分はごくわずか** です。レイアウトも Git もすでにあります。新しいのは、Home をクォータ、後継者、エクスポートの保証を備えた第一級のオブジェクトとして扱うことと、「自動で読み込まれるのはレビュー済みのノートだけ」という信頼の境界を置くことだけです。

- [AGENTS.md](https://agents.md)
- [Agent Skills](https://agentskills.io/specification)
- [Letta Context Repositories](https://www.letta.com/blog/context-repositories/)
- [Turso AgentFS](https://github.com/tursodatabase/agentfs)
- [Cloudflare Artifacts](https://blog.cloudflare.com/artifacts-git-for-agents-beta/)

## 正直な限界

- フレームワークごとにネイティブの記憶形式が違うため、Home の慣習へのマッピングは損失を伴います。
- ランタイムがこれらのファイルを読み書きしてくれる場合にしか役に立ちません。
- ベンダーのクラウドにあるような、ベンダー側に隠れた状態は取り込めません。

## 未解決の問い

- 異なるフレームワークの形式を、Home と双方向にどう対応づけるか。
- 非常に大きな Home で、起動時の負荷と遅延をどう抑えるか。

## よくある質問

### Agent Home は、ただの Git リポジトリですか？

ほとんどそのとおりで、意図してそうしています。`git clone` するだけで手に入ります。違いは、所有者（ロール）、クォータ、後継者、エクスポートの保証、そして「自動で読み込まれるのはレビュー済みのノートだけ」という規則があり、それを慣習に任せず NAS が強制することです。

### エージェントのフレームワークを変えると、記憶は失われますか？

失われません。新しいランタイムがファイルを読んでくれる限りは大丈夫です。Home はオープンな慣習を使っていて、`AGENTS.md`、`SKILL.md`、Markdown のノートは、特定のフレームワークに依存しません。対応づけで損失が出る部分は、取り込み時に未レビューとしてマークします。

### Home を使うのに、Agent NAS をインストールする必要はありますか？

ありません。`AGENTS.md` を置いた Git ディレクトリは、L0 の Home です。NAS が加えるのは、クォータ、保護されたマージ、リース、監査証跡であって、ファイル形式ではありません。

## 関連するコンセプト

- [Agent Branch (エージェント・ブランチ)](https://agentnas.com/ja/concepts/agent-branch/): 実行ごとに、コピーオンライトのブランチで作業します。メインに届くのは、レビューを経たマージだけです。
- [Agent Memory (エージェントの記憶)](https://agentnas.com/ja/concepts/agent-memory/): 読んで直せるノートが真実で、索引は捨てられるキャッシュです。
- [Capability Lease (ケイパビリティ・リース)](https://agentnas.com/ja/concepts/capability-lease/): 1 回の実行のための、期限と予算つきの狭い認可。子リースは、より狭くしかできません。

---

正規 URL: https://agentnas.com/ja/concepts/agent-home/
更新日: 2026-11-11 · 仕様ドラフト v0.2 · CC BY 4.0