vercel/eve：READMEから読む機能と導入時の確認点

ファイルシステム優先のエージェント構造

eve は永続的な AI エージェントのためのファイルシステム優先フレームワークです。リポジトリは TypeScript で書かれています。README の中心的な主張は、コアのエージェント機能が従来の場所に置かれるため、プロジェクトの検査、拡張、運用が容易になるというものです。典型的なレイアウトには agent ディレクトリがあり、agent.ts（オプション、モデルとランタイム設定）、instructions.md（必須、常時有効なシステムプロンプト）、tools/（オプション、モデルが呼び出せる型付き関数）、skills/（オプション、オンデマンドで読み込まれる手順）、channels/（オプション、HTTP、Slack、Discord などのメッセージチャネル）、schedules/（オプション、定期的な cron ジョブ）が含まれます。README はこれらのディレクトリがすべて必須かどうかを明記していません。ツリーでは instructions.md だけが必須とされており、他はオプションです。また、完全なプロジェクトレイアウトとガイドについては eve.dev/docs のドキュメントを参照するよう述べています。

vercel/eveの「ファイルシステム優先のエージェント構造」を読むと、READMEが想定する利用場面と、資料からは判断できない範囲を分けて考えられます。ここで確認できるのはREADMEに書かれた説明であり、未記載の性能や互換性を保証するものではありません。conventional locationsを手掛かりに、入力、処理、出力、終了状態を一つずつ記録すると、説明と手元の結果を比較できます。vercel/eveを既存環境へ組み込むなら、依存関係、権限、実行ディレクトリ、生成物の保存先を先に確認します。設定を変えた場合は変更前後の値を残し、エラーや警告も成功結果と分けて扱います。READMEにない挙動は文書未記載として扱い、推測で補いません。vercel/eveの第1節で示す判断は、この資料の事実と、conventional locationsを使った小さな確認に限定されます。

vercel/eveの「導入前の確認」を読むと、READMEが想定する利用場面と、資料からは判断できない範囲を分けて考えられます。ここで確認できるのはREADMEに書かれた説明であり、未記載の性能や互換性を保証するものではありません。A typical eve agent hasを手掛かりに、入力、処理、出力、終了状態を一つずつ記録すると、説明と手元の結果を比較できます。vercel/eveを既存環境へ組み込むなら、依存関係、権限、実行ディレクトリ、生成物の保存先を先に確認します。設定を変えた場合は変更前後の値を残し、エラーや警告も成功結果と分けて扱います。READMEにない挙動は文書未記載として扱い、推測で補いません。vercel/eveの第1節で示す判断は、この資料の事実と、A typical eve agent hasを使った小さな確認に限定されます。

init によるクイックスタート

README に記載された開始方法は `npx eve@latest init my-agent` です。README によると、このコマンドは新しい my-agent ディレクトリを作成し、依存関係をインストールし、Git を初期化し、対話型ターミナル UI を起動します。既存のプロジェクトに eve を追加するには、README は `cd myapp` を実行してから `npx eve@latest init .` を実行するよう示しています。README の注記によると、eve パッケージには完全なドキュメントが含まれており、コーディングエージェントは node_modules/eve/docs からローカルで読むことができます。README には代替のインストール方法や環境要件は記載されておらず、それらはドキュメントまたはパッケージ自体で確認する必要があります。

vercel/eveの「init によるクイックスタート」を読むと、READMEが想定する利用場面と、資料からは判断できない範囲を分けて考えられます。ここで確認できるのはREADMEに書かれた説明であり、未記載の性能や互換性を保証するものではありません。A typical eve agent hasを手掛かりに、入力、処理、出力、終了状態を一つずつ記録すると、説明と手元の結果を比較できます。vercel/eveを既存環境へ組み込むなら、依存関係、権限、実行ディレクトリ、生成物の保存先を先に確認します。設定を変えた場合は変更前後の値を残し、エラーや警告も成功結果と分けて扱います。READMEにない挙動は文書未記載として扱い、推測で補いません。vercel/eveの第2節で示す判断は、この資料の事実と、A typical eve agent hasを使った小さな確認に限定されます。

vercel/eveの「導入前の確認」を読むと、READMEが想定する利用場面と、資料からは判断できない範囲を分けて考えられます。ここで確認できるのはREADMEに書かれた説明であり、未記載の性能や互換性を保証するものではありません。my-agent/を手掛かりに、入力、処理、出力、終了状態を一つずつ記録すると、説明と手元の結果を比較できます。vercel/eveを既存環境へ組み込むなら、依存関係、権限、実行ディレクトリ、生成物の保存先を先に確認します。設定を変えた場合は変更前後の値を残し、エラーや警告も成功結果と分けて扱います。READMEにない挙動は文書未記載として扱い、推測で補いません。vercel/eveの第2節で示す判断は、この資料の事実と、my-agent/を使った小さな確認に限定されます。

最小限の動作するエージェント

生成されたプロジェクトには agent ディレクトリが含まれます。README の最小限の例では、agent/instructions.md を、天気データがモックであるとアシスタントに伝える短いプロンプトに置き換えます。次に、agent/tools/get_weather.ts のツールは "eve/tools" から defineTool と zod をインポートし、都市の文字列を必要とする inputSchema を定義し、天気と温度を含む固定オブジェクトを返します。モデルの選択は agent/agent.ts で defineAgent と "anthropic/claude-sonnet-5" のようなモデル文字列を使って行います。編集後、`npm run dev` でエージェントを起動します。README はこれを動作するエージェントと呼び、必要に応じてヒューマンインザループのプロンプト、サブエージェント、スケジュールを追加できると述べています。これらの機能の設定方法については説明していません。

vercel/eveの「最小限の動作するエージェント」を読むと、READMEが想定する利用場面と、資料からは判断できない範囲を分けて考えられます。ここで確認できるのはREADMEに書かれた説明であり、未記載の性能や互換性を保証するものではありません。my-agent/を手掛かりに、入力、処理、出力、終了状態を一つずつ記録すると、説明と手元の結果を比較できます。vercel/eveを既存環境へ組み込むなら、依存関係、権限、実行ディレクトリ、生成物の保存先を先に確認します。設定を変えた場合は変更前後の値を残し、エラーや警告も成功結果と分けて扱います。READMEにない挙動は文書未記載として扱い、推測で補いません。vercel/eveの第3節で示す判断は、この資料の事実と、my-agent/を使った小さな確認に限定されます。

vercel/eveの「導入前の確認」を読むと、READMEが想定する利用場面と、資料からは判断できない範囲を分けて考えられます。ここで確認できるのはREADMEに書かれた説明であり、未記載の性能や互換性を保証するものではありません。Read theを手掛かりに、入力、処理、出力、終了状態を一つずつ記録すると、説明と手元の結果を比較できます。vercel/eveを既存環境へ組み込むなら、依存関係、権限、実行ディレクトリ、生成物の保存先を先に確認します。設定を変えた場合は変更前後の値を残し、エラーや警告も成功結果と分けて扱います。READMEにない挙動は文書未記載として扱い、推測で補いません。vercel/eveの第3節で示す判断は、この資料の事実と、Read theを使った小さな確認に限定されます。

コミュニティ、貢献、セキュリティ

README はコミュニティ活動を GitHub Discussions に誘導しており、ユーザーはそこで質問したり、アイデアを共有したり、作成したものを披露したりできます。貢献は歓迎されており、README は CONTRIBUTING.md を参照して、リポジトリをローカルで実行し変更を加える方法を説明しています。コラボレーションは issues と discussions を通じて行われ、参加者は行動規範に同意します。セキュリティ問題については、README は公開 issue を開かないよう明示的に求めており、代わりに SECURITY.md に従い、responsible.disclosure@vercel.com にメールするよう指示しています。README はセキュリティプロセス、期待される応答時間、過去の脆弱性開示については説明していません。

vercel/eveの「コミュニティ、貢献、セキュリティ」を読むと、READMEが想定する利用場面と、資料からは判断できない範囲を分けて考えられます。ここで確認できるのはREADMEに書かれた説明であり、未記載の性能や互換性を保証するものではありません。Read theを手掛かりに、入力、処理、出力、終了状態を一つずつ記録すると、説明と手元の結果を比較できます。vercel/eveを既存環境へ組み込むなら、依存関係、権限、実行ディレクトリ、生成物の保存先を先に確認します。設定を変えた場合は変更前後の値を残し、エラーや警告も成功結果と分けて扱います。READMEにない挙動は文書未記載として扱い、推測で補いません。vercel/eveの第4節で示す判断は、この資料の事実と、Read theを使った小さな確認に限定されます。

vercel/eveの「導入前の確認」を読むと、READMEが想定する利用場面と、資料からは判断できない範囲を分けて考えられます。ここで確認できるのはREADMEに書かれた説明であり、未記載の性能や互換性を保証するものではありません。npx eve@latest init my-agentを手掛かりに、入力、処理、出力、終了状態を一つずつ記録すると、説明と手元の結果を比較できます。vercel/eveを既存環境へ組み込むなら、依存関係、権限、実行ディレクトリ、生成物の保存先を先に確認します。設定を変えた場合は変更前後の値を残し、エラーや警告も成功結果と分けて扱います。READMEにない挙動は文書未記載として扱い、推測で補いません。vercel/eveの第4節で示す判断は、この資料の事実と、npx eve@latest init my-agentを使った小さな確認に限定されます。

ベータ状況と Apache-2.0 ライセンス

README は、eve が現在ベータ版であり、Vercel のベータ利用規約に従うと述べています。また、フレームワーク、API、ドキュメント、動作が一般公開前に変更される可能性があると警告しています。リポジトリは Apache-2.0 でライセンスされています。ライセンスの抜粋は、複製、派生作品の作成、公開表示、公開実行、サブライセンス、配布、および作品と派生作品の配布を行うための、永続的、世界的、非独占的、無償、ロイヤリティフリーの著作権ライセンスを付与します。また、特定の特許請求に適用される特許ライセンスも含まれており、特許訴訟によってこれらのライセンスが終了する可能性があると述べています。抜粋には保証、サポート、セキュリティ保証については言及されておらず、提供されたライセンス文書では扱われていません。

vercel/eveの「ベータ状況と Apache-2.0 ライセンス」を読むと、READMEが想定する利用場面と、資料からは判断できない範囲を分けて考えられます。ここで確認できるのはREADMEに書かれた説明であり、未記載の性能や互換性を保証するものではありません。npx eve@latest init my-agentを手掛かりに、入力、処理、出力、終了状態を一つずつ記録すると、説明と手元の結果を比較できます。vercel/eveを既存環境へ組み込むなら、依存関係、権限、実行ディレクトリ、生成物の保存先を先に確認します。設定を変えた場合は変更前後の値を残し、エラーや警告も成功結果と分けて扱います。READMEにない挙動は文書未記載として扱い、推測で補いません。vercel/eveの第5節で示す判断は、この資料の事実と、npx eve@latest init my-agentを使った小さな確認に限定されます。

vercel/eveの「導入前の確認」を読むと、READMEが想定する利用場面と、資料からは判断できない範囲を分けて考えられます。ここで確認できるのはREADMEに書かれた説明であり、未記載の性能や互換性を保証するものではありません。This creates a newを手掛かりに、入力、処理、出力、終了状態を一つずつ記録すると、説明と手元の結果を比較できます。vercel/eveを既存環境へ組み込むなら、依存関係、権限、実行ディレクトリ、生成物の保存先を先に確認します。設定を変えた場合は変更前後の値を残し、エラーや警告も成功結果と分けて扱います。READMEにない挙動は文書未記載として扱い、推測で補いません。vercel/eveの第5節で示す判断は、この資料の事実と、This creates a newを使った小さな確認に限定されます。

編集部の結論

vercel/eveはREADMEが示す用途と環境が合う読者に向いています。導入前にconventional locationsを使って小さな入力を処理し、終了状態、生成ファイル、警告、権限要求を記録してください。資料にない互換性や運用保証は断定せず、手元の構成で確認できた範囲を採用判断の基準にします。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes