
daily_limit=2 が、全Shortsを翌日送りにしていた
ある日、Shorts のアップロードが「全部翌日に予約されている」現象に気づいた。
朝のアップロードキューを見ると、Shorts ジョブが 6 件、すべて翌日の 8:00 / 20:00 スロットに予約されていた。当日のスロットには本編 2 件だけ。
「あれ、Shorts どこ行った?」と思って `upload_queue.py` のロジックを追った。
原因は、「同チャンネルのアップロード本数が 2 件に達したら、それ以上のジョブは翌日に送る」というルールが、本編 + Shorts を区別せずに数えていたことだった。
これは、`DAILY_PROJECT_LIMIT=2` という設定値が、想定外の解釈で全 Shorts を翌日送りにしていた話だ。

DAILY_PROJECT_LIMIT=2 の意図
最初、`DAILY_PROJECT_LIMIT=2` を導入した目的は、「同じチャンネルが 1 日に 2 つ以上の『プロジェクト』(企画)を投稿しないようにする」だった。
YouTube アルゴリズム的に、同 ch から短時間で連続投稿すると、視聴者の通知疲労を招くリスクがある。1 日 2 企画までに抑える運用方針。
ところが、コードの実装が:
def can_submit_today(channel: str) -> bool:
today_count = count_uploads_today(channel)
return today_count < DAILY_PROJECT_LIMIT # 2`count_uploads_today` が「本編+Shorts の合計」を数えていた。
1 企画 = 本編 1 本 + Shorts 1 本 = 2 アップロード。これで「2 件達成」になり、次のジョブはすべて翌日送り。
「2 企画」のつもりで「2 アップロード」になっていた。

当日 2 slug 到達で全 Shorts 翌日送り
具体的な進行:
朝 8:00、企画 A の本編アップロード(1 件目)
朝 8:30、企画 A の Shorts アップロード(2 件目)
ここで「today_count = 2」になり、DAILY_PROJECT_LIMIT に到達
夜 20:00 のスロット用にキューされた企画 B の本編 → 翌日送り
それ以降の Shorts ジョブもすべて翌日送り
結果として、当日に「企画 A の本編 + Shorts」だけ出る。企画 B 以降は完全に翌日。
8 ch 並列運用で、この罠が複数 ch で同時に発動。1 日のアップロード予定本数の半分以上が、翌日にスライドしていた。
「設定値の意味は同じ、解釈が違う」が、運用の累積で大きな事故になった。

1 日かけて気づかなかった理由
なぜ気づかなかったか?
ひとつ。個々の動画は予定通り公開されていた。当日朝 8:00 / 8:30 のスロットには、企画 A が出ている。「公開ゼロ」ではなかった。
ふたつ。翌日も同じ時刻にスロットがある。翌日 8:00 / 20:00 で別の企画が公開される。一見「順調」に見えた。
みっつ。「予約タイムライン」を俯瞰する仕組みがなかった。日次レポート(post-034)は当日のアップロードしか集計していなかった。「翌日まで含めて何本予約されているか」を見る目がなかった。
要するに、各動画の挙動は問題なし。でも「全体としてアップロード本数が想定の半分」という事実は、俯瞰しないと見えなかった。
事故が「目立たない」が、「累積する」タイプ。

upload-queue daily_limit を撤廃
修正の判断は、シンプルに「DAILY_PROJECT_LIMIT を撤廃する」だった。
代替案として「LIMIT を 4(本編 2 + Shorts 2)に上げる」も検討したが、
ひとつ。「企画」と「アップロード」の概念が混じる時点で、ロジックが脆い。
ふたつ。Shorts の量を増やしたい(post-027 で 10 倍に)時に、再び引っかかる。
みっつ。同 ch 短時間連投リスクは、別の仕組み(cooldown 30 分)で十分対応できている。
完全撤廃の方が、ロジックがシンプルで、想定外の挙動を生まない。
def can_submit_today(channel: str) -> bool:
return True # daily_limit 撤廃`memory/incidents/feedback_upload_queue_daily_limit_bug.md` に「撤廃済み」と記録して、`incidents/archive/` に移動。
「中途半端な制限」より「制限なし + 別の安全弁」のほうが、運用が安定する。

翌日にスライドした分の対応
撤廃時、すでに翌日に予約されていた分の対応も決めた。
ひとつ。翌日予約のままにする。順次公開させる。
ふたつ。翌々日以降の自然順位を維持。当日に巻き戻すと、視聴者の通知が短時間に集中する。
みっつ。publishAt を維持(post-021 の publishAt 戦略)。
「過去の事故は、自然消化させる」のが現実的。慌てて取り戻そうとすると、別の混乱を生む。
事故を発見した瞬間、「過去分をどう扱うか」も決めるのが、運用の落とし所。

数字の刷新
| 項目 | Before(LIMIT=2 誤動作) | After(撤廃) |
|---|---|---|
| 1 企画 = 何アップロード | 2(本編+Shorts) | 同じ |
| LIMIT 解釈 | アップロード件数 | 撤廃済み |
| 当日Shorts翌日送り | 半数以上発生 | ゼロ |
| 想定アップロード本数達成率 | 約45% | 100% |
| 同ch短時間連投の安全弁 | DAILY_LIMIT | cooldown 30分 + publishAt スロット |
学んだこと
ふたつだけ書く。
ひとつ。設定値の「意図」と「実装」のズレは、コメントを書いても防げない。
`DAILY_PROJECT_LIMIT` は「企画数」のつもりだったが、実装は「アップロード数」だった。コメントに「2 企画まで」と書いてあっても、コードを書くときに勘違いすれば事故になる。設定値の名前そのものが意図を表すように設計する(`DAILY_PROJECT_COUNT_LIMIT` のように具体的に)。コメントより命名で意図を伝える。
ふたつ。「俯瞰する仕組み」がないと、累積する事故は気づけない。
個々の動画は問題なく公開されていた。「全体の本数が半分」という事実は、俯瞰しないと見えない。日次レポートに「予約タイムライン」を載せる、ダッシュボードに「翌日以降の予約数」を表示する、こういう俯瞰の仕組みが事故検知に必要。「個別チェック」と「俯瞰チェック」の両方を持つ設計。
副次効果もあった。この事故をきっかけに、`upload_queue.py` の他のロジックも見直した。同じように「意図と実装が微妙にズレている」箇所が 2 つ見つかった。1 つの事故を起点に、関連コードのリファクタが進む。事故は痛いが、痛い瞬間しかコードを真剣に読み返さない、という現実もある。
次回予告
次回は、Phase 5 最終回。立ち上げ初月のメタ振り返り、何が効いて何が無駄だったかを書きます。
設計テンプレをプレゼントします
20体のAIエージェントを組むときに、どう役割分担を設計したか。それをテンプレ化したPDFを用意しています。実際に自分が使っている定義の抜粋とフォーマットが入っているので、そのまま明日から自分のプロジェクトに使えます。

公式LINEに登録してくれた方にお送りします。
法人のご相談はこちら
自社のYouTubeチャンネルを自動化したい、AIで動画運用代行を頼みたい、というご相談は、別途お受けしています。

リンク先: https://forms.gle/SkDkkZi7hMFJUF9w7