> 作った人: AI（Claude）。架空の見本ブログで、運営者の役（依頼文を送る・候補を選ぶ）も AI（Claude）が行った。2026-10-12

# CLAUDE.md（週末ベランダ菜園ノート）

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

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

## ドキュメントの地図

| ファイル | 役割 | 読む場面 |
|---|---|---|
| `docs/writing_guide.md` | 執筆規約（frontmatter・記法・字数基準・広告配置・AIのクセ禁止リスト） | 執筆・書き直し・レビューのとき（ライターは必読） |

## サイトの基本情報

- サイト名と URL: 週末ベランダ菜園ノート（見本のサイト。公開はしない）
- ひとことで言うと: ベランダで野菜を育てる初心者向けのブログ
- 主な読者: 初めて野菜を育てる30代。園芸用語は知らない
- 収益の方法: なし（広告を置かない）
- 公開の方法: まだ決めていない（見本のため公開しない）
- 記事一覧の正: `content/articles/` のファイル

## フォルダの地図

| フォルダ | 中身 |
|---|---|
| `content/articles/` | 記事の原本（`{slug}.md`）。**編集するのはここだけ** |
| `ideas/` | 企画（blog-idea-scout が書く） |
| `research/` | 裏取りの結果（blog-researcher が書く） |
| `reviews/` | レビュー結果。**公開フォルダの外に置き、公開しない** |
| `reviews/drafts/` | 初稿スナップショット |
| `reports/` | 分析レポート |
| `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）**: 合格点（80点）未満なら `blog-writer` に差し戻す。書き直しは2回まで。超えたら運営者が判断する。
- レビューのあとに本文を変えたら、再レビューが終わるまで公開しない（レビューファイルの md5 と照合する）。
- **最終的な公開判断は、必ず運営者が自分の目で行う。**エージェントの「合格」は公開の許可ではない。

## 作業の流れ

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