# instinct: 新規ボットを追加する前にscraper_bots_helpers.pyのBOTS定義とscraper_bot_scheduleへの行を確認する

新規ボットをvvvシステムに追加する際、topics.jsonへの記載だけでは不十分。scraper_bots_helpers.pyのBOTS辞書とscraper_bot_scheduleテーブルの両方に登録しないと、スケジューラーから呼び出されない。実例: yt_search_learn(group_id=703)がtopics.jsonには存在したにもかかわらずBOTS dictとscheduleテーブルに未登録だったため、スケジューラーから一切呼ばれていなかった。ボット追加時は必ず3箇所（topics.json・BOTS dict・scheduleテーブル）の整合性を確認すること。

## ポイント
- topics.jsonへの記載だけではボットは動かない — BOTS辞書とscheduleテーブルへの登録が必須
- yt_search_learn(group_id=703)が未登録だったことで発覚した実インシデント
- スケジューラーはscraper_bot_scheduleテーブルを参照してボットを起動する
- ボット追加チェックリスト: ①topics.json ②scraper_bots_helpers.py BOTS dict ③scraper_bot_scheduleテーブル

## 関連ページ
[[新規 bot を追加する前に bot_registry.py の BOTS 辞書にキーが含まれているか確認]] [[LLMモデル名を変更する前に全ボット共通のllm_client.pyを修正し他のタスクへの影響を確認する]] [[PM2 dangling process detection]] [[INSERT/UPDATE を含むバッチ実行前に UNIQUE 制約や外部キー制約を確認する]]

## 関連概念（未作成）
`scraper_bot_schedule テーブルスキーマと登録手順` `vvv ボット追加標準チェックリスト` `topics.json と BOTS dict の同期検証スクリプト`