AIインスタ担当 v3 実装計画書

2026-04-17 | AI経営共創パートナーズ | 実行フェーズ

1. v3 の位置づけ

04_AIインスタ担当v2_設計書.html で挙げた改善提案6件のうち、コードで機械的に実装可能な範囲をCCが先行実装した版。実装後にCodexによるアドバーサリアルレビュー、最終的に子安氏の承認を経て本番化する。

v3 実装スコープ

2. 実行フロー（並行ストリーム設計）

2.1 フェーズ依存関係

2.2 Phase 1 並行ストリーム

2.3 並行可能性の判断根拠

3. Phase別詳細

3.1 Phase 0: 準備

3.2 Phase 1-Stream A: コア実装（CC）

提案2: token仕様の設計書明記＋コード確認

• 現状: generateSecureToken() は32byte(256bit)の crypto.getRandomValues を使用。既に128bit以上クリア
• 現状: APPROVAL_EXPIRY_HOURS 定数で有効期限管理
• 対応: 設計書に「256bitエントロピー / 有効期限72h」を明記するのみ（コード変更なし）

提案4: プロンプトバージョニング

• プロンプトを prompts/ ディレクトリにバージョン別分離
• posts テーブルに method_version カラム追加（マイグレーション 0002）
• /api/publish / /api/generate フローでバージョン記録
• 既定: method-v1（現行プロンプトをv1として固定）

提案5: 二重実行防止

• posts テーブルに processing_started_at カラム追加
• Cron処理で「SELECT → UPDATE processing_started_at IS NULL なレコードのみ」ロック取得
• 投稿成功→ status=published、失敗→ processing_started_at=NULL で戻す（最大3回リトライ）
• retry_count カラムも同時追加

3.3 Phase 1-Stream B: 運用監視設計書

別セッションで並行実行。成果物: 06_v3運用監視設計.html。

3.4 Phase 2: 統合

• Stream A成果をビルド確認（TypeScript+Wrangler dev）
• Stream B設計書をv3計画書にリンク
• マイグレーションSQLの整合性確認

3.5 Phase 3: Codex反論レビュー

別セッションで /codex:adversarial-review を実行。観点は設計書04-11.1 に基づく9項目。

3.6 Phase 4: 子安氏パッケージ

4. 別セッションで動かすべきもの

insta-auto-v3 の運用監視設計書を作成してください。

前提:
- Cloudflare Workers + D1 + KV 構成
- 既存コード: ~/projects/insta-auto-v3/
- 設計書: 20_機能別/子安君_案件共有/04_AIインスタ担当v2_設計書.html の提案6

含めるべき内容:
1. Cloudflare Logpush 設定（Workers実行ログ保全先）
2. Sentry 導入（Frontend + Workers）の初期化コード
3. Slack Webhook アラート 3種類（投稿失敗・Cron失敗・ログイン失敗スパイク）
4. IGトークン失効48h前の事前通知設計
5. 必要な環境変数・シークレット一覧
6. 工数見積もりの根拠

出力先: 20_機能別/子安君_案件共有/06_v3運用監視設計.html

/codex:adversarial-review ~/projects/insta-auto-v3/packages/worker/

特に以下の観点で厳しく反論してください:
- 提案5（二重実行防止）の実装が並行性バグを防げているか
- 提案4（プロンプトバージョニング）の版管理設計
- approval_requests テーブル周りのセキュリティ
- Cron トリガーの idempotency

出力: 07_v3_Codex反論レビュー.md に記録

5. 進捗管理