# instinct: デイリードキュメント更新とDiscord通知を同一スクリプトにまとめる

## 背景

ドキュメントの更新と通知を別々のcronに分割すると、タイミングのズレや管理コストが増える。
一つのスクリプトで「更新→ビルド→通知」を完結させることで保守性が上がる。

## パターン

```python
# docs_daily_update.py の3フェーズ構造
1. データ収集: git log --since=24h, gh pr list --state=merged
2. CHANGELOG更新: 今日のエントリを先頭に追記
3. VitePress ビルド: npm run build
4. Discord 通知: DISCORD_WEBHOOK_OPS に送信
```

## --dry-run フラグが必須

本番送信を止めて動作確認できる `--dry-run` オプションを必ず用意する。
`--stdout` オプションで Discord 送信なしの出力テストも可能にする。

## cron 設定

```
30 8 * * * cd /home/ubuntu/workspace/web/vvv && venv/bin/python3 scripts/docs_daily_update.py >> logs/docs_daily_update.log 2>&1
```

毎朝8:30 — daily_report.py (21:00) と時間帯を分けることで Discord の通知間隔を確保。

## 関連ファイル

- `scripts/docs_daily_update.py` — 実装本体
- `scripts/docs_build.sh` — VitePress ビルドのみ（毎時0分）
- `tools/daily_report.py` — vvv-bots の統合日報（毎日21:00）