BiyouCheck Agent Architecture

Design Principles（Anthropic公式準拠）

このプロジェクトのエージェント設計は2層構造に従う:

agent.md には手順（How-to）を書かない。手順は必ず SKILL.md へ。cron-prompt は agent と skill を指定する以上の実装を持たない（hojokin-agent.jp パターン準拠、2026-05-17 確定）。

ディレクトリ構造

.claude/agents/<name>/
├── agent.md                    ← 薄ラッパー（~79行）
└── references/
    ├── persona.md              ← キャラクターの人格・口調・禁じ手
    └── (optional reference files)

.claude/skills/<skill-name>/
├── SKILL.md                    ← 厚手順書（~495行）
└── references/
    └── (templates / taxonomies / reference data)

---

TOP ZONE — 戦略・自律改善

三忍 Multi-Provider 設計

異プロバイダーへの実呼び出しで多様性を確保:

akatsuki が strategy-tournament スキルを起動
  ├─→ jiraiya (Claude Opus)        : 大局仮説
  ├─→ tsunade (Google Gemini API)  : リスク審査  curl + GEMINI_API_KEY
  └─→ orochimaru (xAI Grok API)    : 逆張り仮説  curl + GROK_API_KEY
            ↓
       Elo トーナメントで勝者選定 → 該当 BOTTOM Agent へ handoff

---

SHARED BRAIN — 共有の脳

すべての Agent 間連携は kaguya（DB）を通じて間接的に行う。直接 RPC は禁止。

---

BOTTOM ZONE — 実行

---

主要 Handoff グラフ

オウンドメディア記事の制作フロー

naruto（編集長）が brief 承認
  ↓
kakashi が記事執筆オーケストレーション
  ├─→ neji (subagent)    : 構成・論理・文体編集
  ├─→ hinata (subagent)  : SEO構造・キーワード最適化
  └─→ guy (subagent)     : 第三者記事品質レビュー（PUBLISH/REVISE/REJECT）
  ↓
asuma が挿し絵生成（codex exec + gpt-image-2）
  ↓
choji が R2 にアーカイブ
  ↓
hinata が公開後 KPI 観測 → naruto へ改善候補

hojokin型運用システムのNARUTO対応（2026-05-17統合）

補助金Agent配布版から取り込むのはキャラクターではなく、運用骨格:

DB中心の制作ライン:

media_topics                ← naruto が「書きたいネタ」を補充
  ↓
media_content_items          ← kakashi が「制作単位」を作成
  ↓
media_research_notes         ← sai/ino/kakashi が出典・引用・使用箇所を保存
  ↓
src/content/blog/*.mdx       ← kakashi が記事実体を生成
  ↓
media_review_logs            ← guy/neji/hinata が判定履歴を保存
  ↓
reflections                  ← 各Agentの実行ログ・改善案

設計原則:

• 起動条件と書きたいネタを分離する。起動は launchd/GitHub Actions、ネタは DB/Markdown queue。
• agent.md は薄い役割定義、SKILL.md は厚い手順書。
• Jina Reader / note MCP / check_article.py は複数目的で再利用する。
• Reviewer は否定役ではなく品質保証役。自動修正できるものは直し、構造・出典・医療広告リスクは差し戻す。
• DB行は削除しない。queued / in_progress / published / drafted / failed で状態遷移する。

オウンドメディア記事の制作フロー（kakashi、毎朝 09:00 + 毎夜 21:00）

kakashi-am/pm 起動
  ↓
Step 0: media_topics から status='queued' を 1 件取得 → in_progress
  ↓
kakashi が記事執筆オーケストレーション
  ├─→ neji (subagent)    : 構成・論理・文体編集
  ├─→ hinata (subagent)  : SEO構造・キーワード最適化
  └─→ guy (subagent)     : check_article.py E01〜E16 機械検出 + LLM 判定
  ↓
guy 判定:
  ├─ PUBLISH → 公開（git push → Cloudflare Pages auto-deploy）
  ├─ REJECT  → DRAFTED で終了（人間レビュー）
  └─ REVISE  → kakashi 修正 → 再 guy 判定（最大 3 回）→ 超過で DRAFTED
  ↓
asuma がアイキャッチ生成（codex exec + gpt-image-2）
  ↓
choji が R2 にアーカイブ
  ↓
media_topics.status = 'published'

note 記事の自動公開フロー（kiba、毎朝 08:30）

kiba 起動
  ↓
Step 0: media_topics から status='queued', assigned_agent='kiba' を 1 件取得
  ↓
本文生成 + 画像 H2 数 + 1 枚（codex imagegen） + R2 アーカイブ
  ↓
二重ゲート:
  ├─ policy-gate-judge (green でなければ ERROR)
  └─ guy (article-quality-review)
  ↓
判定:
  ├─ PUBLISH → mcp__note-api__publish-note で即公開
  ├─ REJECT  → DRAFTED（下書き保留、人間レビュー）
  └─ REVISE  → kiba 修正 → 再 guy（最大 3 回）→ 超過で DRAFTED
  ↓
media_topics.status = 'published' / 'drafted'

戦略トーナメント（三忍、日 02:00）

akatsuki 起動
  ↓
過去 7 日の reflection / cron-state を集約
  ↓
strategy-tournament スキルが 4 並列呼び出し:
  ├─→ jiraiya (Claude Opus)        : 大局仮説
  ├─→ tsunade (Google Gemini API)  : リスク審査
  ├─→ orochimaru (xAI Grok API)    : 逆張り仮説
  └─→ deidara                       : 広告クリエイティブ
  ↓
Elo トーナメント評価 → Top 3 採用打ち手
  ↓
.planning/strategy/week-{YYYY-WW}.md に来週ガイダンス出力
  ↓
媒体への影響は naruto の月曜 06:00 で knowledge 辞書経由で吸収

自律改善ライン（毎朝、ミュウ + ミューツーモデル）

[毎朝 05:00] sakura（ミュウ役）
  ├─ D1 reflections（直近 24h）+ cron-state 観察
  ├─ 全 agent.md ペルソナ + 通知口調レビュー
  └─ 改善仮説起草（low/medium/high、最大 5 件）
        ↓ 仮説バトン
[毎朝 05:30] sasuke（ミューツー役）
  ├─ low/medium 仮説を git branch で適用（high は人間判断）
  ├─ T+1d / T+7d で効果測定スケジュール登録
  ├─ 過去実験の評価 → 改善は PR、悪化は auto-revert（branch 削除）
  └─ main は無傷を保証

[月曜 06:00] naruto（アルセウス役、週次）
  ├─ 1 週間分の reflection / 競合観察 / sai pain を集約
  ├─ knowledge 辞書（risk-dictionary / success-patterns）に追記候補
  └─ media_topics に新規ネタを INSERT（kakashi/kiba のキューを補充）

コスト + DB の鼓動（毎時）

[毎時 :05] kaguya（バタフリー役）
  └─ D1 行数 + R2 オブジェクト差分監視（5 分以内）

[毎時 :30] kakuzu
  ├─ 当月コスト集計
  ├─ $100/$200/$300/$400 段階で Discord アラート（各初回のみ）
  └─ $500 超で `_PAUSED` 作成 → kaguya/kakuzu 以外 skip（月初 auto resume）

---

一覧: エージェント25キャラクター

TOP ZONE (9)
  naruto / sasuke / sakura / akatsuki / jiraiya / tsunade / orochimaru / deidara / kakuzu

SHARED BRAIN (1)
  kaguya

BOTTOM ZONE (13)
  shikamaru / ino / choji / kakashi / guy / hinata / kiba / tenten / shino / neji / rock-lee / asuma / sai

DEPRECATED (1)
  temari   ← 機能は voice-bank-match スキルに吸収済、エージェントとしての中継不要

合計 25キャラクター + 1 DEPRECATED = .claude/agents/ に存在するディレクトリ数。

---

一覧: スキル一覧（25+）

---

削除済（v1 で整理）

これらは以前存在したが、canonical キャラクター統合により削除済:

• biyoucheck-pain-researcher → sai に統合
• biyoucheck-editor-in-chief → naruto に統合
• biyoucheck-note-writer → kiba に統合
• biyoucheck-owned-media-editor → hinata + neji + kakashi に統合
• biyoucheck-compliance-editor → guy + policy-gate-judge スキルに統合
• biyoucheck-growth-analyst → shikamaru に統合
• 旧 sasuke-sakura（一体定義） → sasuke + sakura に分離

---

重要な制約（プロジェクト全体）

medical-ad-rule 準拠のため、全エージェント共通で以下を守る:

• 個別クリニック名指しは無条件 Red（auto-generated content では即停止）
• 「監修済み」「専門医監修」表記は expert_approvals テーブルに承認ログがある時のみ
• SNS 自動投稿は 4週間連続 Red判定ゼロ達成までブロック
• AI推論コストは kakuzu が hourly monitor、$100/$200/$300/$400 段階アラート、$500 で _PAUSED
• risk-dictionary-check を通っていないテキストは公開禁止
• 全 launchd 起動は scripts/cron/_run-agent.sh 経由（timeout + reflection 連動）
• 全 agent.md に timeout_sec: 必須（軽量 300 / 中規模 1800 / 重 3600）
• 全 agent 実行は D1 reflections テーブルに記録（hojokin パターン、4 層 reflection）
• 記事生成は media_topics キューから取得 → in_progress → published 更新（hojokin subsidies パターン）
• guy 判定は check_article.py E01〜E16 機械検出 + LLM 判定 → REVISE 時はリトライ最大 3 回

---

関連ドキュメント

• CLAUDE.md — プロジェクト全体ルール
• README.md — プロジェクト全体俯瞰
• docs/runbook/agent-schedule.md — 17 plist + 24h タイムテーブル + 全機能解説
• docs/runbook/mac-mini-bootstrap.md — Mac mini ゼロからセットアップ
• .planning/STATE.md — 現在進捗
• .planning/SOURCE-DOCS/04-PHASE-2.5-MEDIA-DISCOVERY-v4.md — 現行 Phase 2.5 v4 正式 SPEC
• docs/knowledge/risk-dictionary.md — リスク表現辞典
• docs/knowledge/claim-taxonomy.md — 主張分類辞典
• D1 migrations:
• .claude/db/migrations/0001_init.sql — 初期 schema
• .claude/db/migrations/0003_cost_tracking.sql — kakuzu コスト追跡
• .claude/db/migrations/0004_reflections.sql — agent reflection 集約
• .claude/db/migrations/0005_media_topics.sql — 記事ネタキュー