CLAUDE.example.md

# CLAUDE.md（（サイト名をここに書く））

<!-- 使い方: このファイルをプロジェクトのルートに CLAUDE.md という名前でコピーし、（）の部分を自分の値に置き換えてください。
     エージェントは作業のたびにこのファイルを読みます。短く保ち、詳しい規約は docs/ に書きます。 -->

毎回読む最小限の情報です。詳しい規約は `docs/` が正です。
このファイルでは、最終判断をする人を「運営者」と呼びます（呼び方は `config.yaml` の `operator_name` で変えられます）。

## ドキュメントの地図

| ファイル | 役割 | 読む場面 |
|---|---|---|
| `docs/writing_guide.md` | 執筆規約（frontmatter・記法・字数基準・広告配置・AIのクセ禁止リスト） | 執筆・書き直し・レビューのとき（ライターは必読） |
| （ビルドや公開の手順書があれば書く） | （役割） | （読む場面） |
| （残タスクの一覧があれば書く） | （役割） | 作業を始めるとき |

## サイトの基本情報

- サイト名と URL: （例: 週末ベランダ菜園ノート https://example.com/）
- ひとことで言うと: （例: ベランダで野菜を育てる初心者向けのブログ）
- 主な読者: （例: 初めて野菜を育てる30代。園芸用語は知らない）
- 収益の方法: （例: 利用している ASP 経由の商品リンク。広告を置かないなら「なし」）
- 公開の方法: （例: 静的 HTML をサーバーへ手動でアップロード）
- 記事一覧の正: （例: `content/articles/` のファイル。記事数をこのファイルに書かない）

## フォルダの地図

| フォルダ | 中身 |
|---|---|
| `content/articles/` | 記事の原本（`{slug}.md`）。**編集するのはここだけ** |
| `ideas/` | 企画（blog-idea-scout が書く） |
| `research/` | 裏取りの結果（blog-researcher が書く） |
| `reviews/` | レビュー結果。**公開フォルダの外に置き、公開しない** |
| `reviews/drafts/` | 初稿スナップショット |
| `reports/` | 分析レポート |
| `public/` | 公開フォルダ。（例: ビルドが生成するので直接編集しない） |
| `docs/` | 規約・手順書 |
| `scripts/` | スクリプト（`review_metrics.py` など） |

プロジェクトのルートに新しいファイルを作らない。置き場所に迷ったら運営者に聞く。

## 禁止・注意（このサイト固有）

- 認証情報（`.env` など）の値を表示しない・コミットしない。
- 事実・仕様・数値は一次情報で裏を取る。出典は実在する URL だけ。誇大表現は使わない。価格には「執筆時点」の注記を付ける。
- 広告リンクのコードは、運営者が管理画面で発行した実物だけを使う（AI が推測で作らない）。
- （このサイト固有の禁止事項を書く。例: 農薬・肥料の使い方は製品ラベルの記載を超えて勧めない）
- 公開に関わる操作（アップロード・push）は、実行前に運営者へ確認する。

## 各エージェントの役割

| エージェント | 役割 | 出力先 |
|---|---|---|
| `blog-idea-scout` | 次に書く記事のネタを提案する | `ideas/` |
| `blog-researcher` | 一次情報の収集と裏取り | `research/` |
| `blog-writer` | 執筆と、レビューを反映した書き直し | `content/articles/` |
| `legal-reviewer` | 法務（景品表示法・ステマ規制・規約・著作権など）。TIER1 | `reviews/legal_*.md` |
| `consistency-reviewer` | 事実整合と校正。TIER1 | `reviews/consistency_*.md` |
| `growth-reviewer` | SEO と収益導線。TIER2 | `reviews/seo_*.md`・`reviews/cro_*.md` |
| `blog-readers-panel` | 読者体験。TIER2 | `reviews/panel_*.md` |
| `confidentiality-reviewer` | 機密・発信者の特定リスク。（このサイトで使う／使わない） | `reviews/confidentiality_*.md` |

レビュアーは記事を書き換えません。修正は必ず `blog-writer` に戻します。

## 公開ゲート

- 記事を新しく書いた・大きく加筆した・書き直したら、公開前に必ずレビューを通す。
- **TIER1（legal・consistency）**: 「必須」の指摘が1件でもあれば、点数に関係なく公開しない。
- **TIER2（seo・cro・panel）**: 合格点（`config.yaml` の `gate.pass_score`）未満なら `blog-writer` に差し戻す。目標点は `gate.target_score`。書き直しは上限回数（`gate.max_rewrite_loops`）まで。超えたら運営者が判断する。
- 機密レビュー: （`gate.confidentiality_required` が true のサイトでは毎回必須、と書く。使わないならこの行を消す）
- レビューのあとに本文を変えたら、再レビューが終わるまで公開しない（レビューファイルの md5 と照合する）。
- （書き直し後に走らせる検証コマンドがあれば書く。`config.yaml` の `build_check_command` と揃える）
- **最終的な公開判断は、必ず運営者が自分の目で行う。**エージェントの「合格」は公開の許可ではない。

## 作業の流れ

企画（`blog-idea-scout`）→ 裏取り（`blog-researcher`）→ 執筆（`blog-writer`）→ レビュー（各レビュアー）→ 書き直し（`blog-writer`）→ 再レビュー → 運営者の確認 → 公開（運営者）