# Ops: vvv-bots detail_cron ボットキー整合性

vvv-bots の `detail_cron.sh` で指定するボット名は、`bot_registry.py` の `BOTS` 辞書の**キー名**と完全一致させる必要がある。`dir` フィールドとは別物であり、混同すると `manage.py detail ` が辞書引きに失敗し「見つかりません」エラーが継続発生する。2026-04-19 に `engineer_factory`/`freelance_start` と `engineer`/`freelancestart` の不一致により2ボットの詳細取得が長期停止した実例あり。新規ボット追加時は必ず `bot_registry.BOTS` のキー名で `detail_cron.sh` に登録し、`logs/detail_fetch.log` の ERROR ログと Python アサーションで整合性を検証する。

## ポイント
- `detail_cron.sh` の BOTS 配列には `bot_registry.BOTS` の**辞書キー名**を指定する（`dir` フィールドではない）
- 不一致時は `logs/detail_fetch.log` に `[ERROR] ボット 'xxx' が見つかりません` が毎回記録される
- 検証: `from bot_registry import BOTS; assert key in BOTS` で全キーの存在を確認する
- 新規ボット追加フロー: bot_registry.BOTS にキー追加 → detail_cron.sh に同じキー名を追加 → ログで動作確認

## 関連ページ
[[PM2 dangling process detection]] [[INSERT/UPDATE を含むバッチ実行前に UNIQUE 制約や外部キー制約を確認する]] [[LLMモデル名を変更する前に全ボット共通のllm_client.pyを修正し他のタスクへの影響を確認する]] [[SQLを実行する前にカラム名を正確に確認する（特に PostgreSQL の統計ビュー）]]

## 関連概念（未作成）
`bot_registry.py キー命名規約` `vvv-bots 新規ボット追加チェックリスト` `detail_fetch ログ監視アラート設定`