1. ひとことで

AIVEST 開発ハーネスは LINE を窓口に、Claude Max と ChatGPT サブスクの 2 モデルをクロスチェックさせる開発ワークフロー。

• Claude（Max20x サブスク）= 実装担当（coder）
• Codex（ChatGPT サブスク）= 上流（COO / CTO）+ レビュー（reviewer）
• 状態は tasks/<id>/state.json をファイルベースで管理、エージェント間は直接対話せずファイル経由でやりとり。

2. 全体図

3. コンポーネント

4. データの流れ（典型 1 ターン）

1. CEO が LINE で「x バズらせるウェブアプリ作りたい」と送信
2. LINE Platform が webhook を Cloudflare Tunnel に POST
3. codex-line-bot/server.ts が受信、署名と allowlist を検証
4. orchestrator.classify(text, openTaskId) で分類
   • 平文 + open task 無 → new_task
   • 平文 + open task 有 → continue_task
   • /... → 対応コマンド
5. handleNewTask or handleContinueTask
   • tools/task-new.sh で tasks/<id>/ 生成
   • discussion.md に CEO 発話を append
   • 即時 reply「📨 task ... 着任…」
   • 進捗タイマー（90s / 240s に「思考中」push）
   • Loading indicator を 25 秒毎にリフレッシュ
6. runCOOConversation
   • プロンプト構築（タスクID + 原文 + 既存 discussion + 役割定義）
   • docker compose run --rm codex codex exec --json - で spawn
7. Codex container 内で agent が動く
   • AGENTS.md 自動読込
   • profiles/general/roles/coo.md 読み込み
   • モード判定（壁打ち vs spec 確定）
   • モード1: discussion.md に追記 → DISCUSSING
   • モード2: coo-spec.md/json を書く → SPEC_READY
8. orchestrator が stream-json を parse、usage 記録、state.json を SQLite に同期
9. CEO に push 返信

5. タスクのライフサイクル

6. 役割と担当モデル

7. LINE コマンド一覧

主要操作

デバッグ

8. 中間進捗・監視

• ローディングインジケータ：LINE 標準のタイピング表示。25 秒毎にリフレッシュして agent 走行中ずっと点灯
• 生存 push：90 秒経過で「🤔 COO 思考中... 1.5m 経過」、240 秒で「⏳ 引き続き走行中... 4m 経過」を自動 push（最大 2 回）
• タイムアウト：agent 走行 15 分（AGENT_TIMEOUT_MS）で SIGTERM
• 沈黙検知：hooks/on_silence.sh 雛形あり watchdog 発火元 未実装

9. 認証情報の所在

10. データベース

/Users/ren/AI/01_APP/codex-line-bot/data/ 配下に 3 つの SQLite DB：

• sessions.db — /codex /claude 直叩きの session_id resume 用
• sessions.tasks.db — TaskStore（task_id → state, line_user_id, title, timestamps）
• usage.db — 全 agent 呼び出しのトークン/コスト記録（/budget の元データ）

正本の状態は tasks/<id>/state.json（ディスク）。SQLite は高速検索用のキャッシュ。

11. 現状の制約

12. 次のステップ

1. A. Phase 2 実装 — coder / reviewer ループ、最大の機能空白
2. B. 動的 workspace 切替 — /project switch <path> で bind mount を変える
3. C. VERCEL_TOKEN セット + vercel build / preview deploy 動作確認
4. D. Cloudflare Tunnel を named tunnel に（URL 安定化）
5. E. JSON 出力の機械検証（spec の生成失敗を自動検知）

13. 主要ファイル

/Users/ren/AI/01_APP/
├── codex-line-bot/                ← Mac で動く Hono サーバ
│   ├── src/
│   │   ├── orchestrator.ts        ← フェーズ駆動の中核
│   │   ├── agents.ts              ← claude/codex/grok 抽象化
│   │   ├── tasks.ts               ← TaskStore
│   │   ├── usage.ts               ← コスト計測
│   │   ├── server.ts              ← webhook
│   │   └── ... (他 6 ファイル)
│   ├── data/                       ← SQLite × 3
│   ├── .env                        ← dotenvx 暗号化済
│   └── start.sh
│
├── claude-sandbox/
│   ├── Dockerfile                  ← Playwright base + Claude Code + Vercel CLI
│   ├── docker-compose.yml
│   ├── start.sh
│   └── shared/                     ← ★ ハーネス本体（/workspace）
│       ├── OVERVIEW.md             ← この内容の md 版
│       ├── ARCHITECTURE.md
│       ├── EXECUTION.md
│       ├── CLAUDE.md / AGENTS.md
│       ├── profiles/general/{roles,templates}/
│       ├── profiles/domains/coding/
│       ├── tasks/<id>/
│       ├── tools/
│       ├── hooks/
│       ├── memory/
│       └── monitor/
│
└── codex-sandbox/
    ├── Dockerfile                  ← Playwright base + Codex CLI + Vercel CLI
    ├── docker-compose.yml
    └── start.sh