eve-repo-upkeep

Eve リポジトリのメンテナンス

アプリのリポジトリを Eve の規約に準拠した状態に保ちます。チェック項目はそれぞれ独立しているため、複数の領域に対応が必要な場合は並行して実行してください。

使用するタイミング

• Eve プラットフォームの更新後、またはマニフェストスキーマの変更後
• 大規模なデプロイまたはリリースの前
• 新しいメンテナーのオンボーディング時

フェーズ 1：評価

対応が必要な領域をすばやく特定します。以下のファイルが存在するか、古くなっていないかを確認します。すべてのファイルを詳しく読む必要はありません。対応が必要な領域だけを把握してください。

• .eve/manifest.yaml — 存在しますか？スキーマ行は eve/compose/v1 ですか？
• skills.txt — 存在しますか？固定された項目や古い項目はありますか？
• AGENTS.md / CLAUDE.md — 現在のスキルを参照していますか？
• agents/ ディレクトリ — agents.yaml、teams.yaml、chat.yaml は存在しますか？
• コードベース — 明らかに非推奨の CLI パターンやインラインのシークレットはありますか？

対応が必要な領域が 1 つだけなら、その領域に直接対応します。それ以外の場合は、フェーズ 2 に進みます。

フェーズ 2：ワーカーの割り当て

更新が必要な領域ごとにワーカーを 1 つ作成します。以下の各ワーカーの説明は単独で完結しているため、他のワーカーのコンテキストがなくても担当領域の作業を実行できます。

ワーカー：マニフェストの整合性

.eve/manifest.yaml を確認して修正します。

• schema: eve/compose/v1 が存在することを確認します。
• 古い components: よりも services: を優先します。
• x-eve のイングレスとパイプライン定義を正確な状態に保ちます。
• x-eve.defaults をハーネスのデフォルト（harness/profile/options）と同期させます。
• x-eve.agents のプロファイルをオーケストレーションポリシーに合わせます。
• x-eve.agents.config_path と x-eve.chat.config_path が有効なファイルを指していることを確認します。
• シークレットには ${secret.KEY} を使用していることを確認します。
• デプロイパイプラインには、release の前に build ステップを含めます。
• Docker イメージを使うサービスには build.context を定義します。
• レジストリ認証用シークレット（REGISTRY_USERNAME + REGISTRY_PASSWORD）が必要なのは、カスタムの BYO レジストリに限ります。

ワーカー：スキルファイル

skills.txt を確認して修正します。

• Eve スキルパックの参照を最新の状態に保ちます。
• 古いパックや固定バージョンを削除します。

ワーカー：エージェントの指示

AGENTS.md、CLAUDE.md、agents/ の設定ファイルを確認して修正します。

• スキルの参照を更新し、eve-se-index を含めます。
• 古いコマンドや URL を削除します。
• agents/agents.yaml はエージェントとスキルを定義します。各項目が最新であることを確認します。
• agents/teams.yaml はチーム構成とディスパッチを定義します。構造を確認します。
• agents/chat.yaml はチャットのルーティングルールと権限を定義します。ルールを確認します。

ワーカー：非推奨パターン

コードベース内の非推奨パターンを検索し、修正するか、問題として報告します。

• 古い CLI コマンド（eve deploy と eve env deploy の違い）
• --ref パラメーターのない古いデプロイ構文
• ドキュメントやマニフェスト内のハードコードされたドメイン
• リポジトリファイル内のインラインのシークレット
• リポジトリ URL を指定した org.opencontainers.image.source ラベルが欠けている Dockerfile
• release の前に build ステップがないパイプライン
• Docker イメージを使っているのに build.context の設定がないサービス
• カスタムレジストリ用の認証シークレット（REGISTRY_USERNAME、REGISTRY_PASSWORD、またはプロバイダーに相当する名前）の不足

フェーズ 3：検証

すべてのワーカーの作業が完了したら、最終検証を実行します。

# Local validation (Docker Compose)
docker compose up --build

# Staging deploy (requires --ref with 40-char SHA or a ref resolved against --repo-dir)
eve env deploy staging --ref main --repo-dir .

# Use --direct to bypass pipeline if needed
eve env deploy staging --ref main --repo-dir . --direct

eve job follow でデプロイジョブを追跡します。