この設計書は、これまでのCEOとの議論を1本に統合したものです。専門用語を避け、平易な言葉で書いています。
文中の ✅ 今あるもの は試作アプリで既に動いている機能、🆕 これから作るもの は今回追加する機能です。既にあるものを「新しく作る」とは書かず、区別しています。
CFCLのPR原稿づくりを、次の3点で変えることが出発点です。
この3点はすべて「PR担当の時間を、書く作業から“選ぶ・整える作業”へ移す」ことを狙っています。
PR担当は「用途を選んで」ボタンを押すだけ。
あとはツールが「承認済みの正しいお手本」と「ブランドの型（調教md）」に沿って、一気に・一定品質で・そのまま使える形（Excel） で原稿を出す。
気に入った原稿に「採用」の印を付ければ、それが自動で次回のお手本になり、使うほど賢くなる。
| 観点 | 現状（手作業中心） | あるべき姿（エンジン化後） |
|---|---|---|
| 生成の量 | 1商品ずつ、画面で1件ずつ ✅ | 用途に応じて「1件都度」も「全商品一括」も選べる 🆕 |
| 品質・トーン | 書き手によってばらつく／方針は頭の中 | 承認済みお手本＋調教mdで型が固定され、一定品質 🆕 |
| お手本の管理 | 良い原稿がどこにあるか属人的 | 「採用印」を付けた正しい原稿だけが自動で蓄積 ✅ 骨格あり → 強化 🆕 |
| 納品の形 | 原稿を手でExcelに貼り付け | 各商品行に書き戻したExcelを自動で返す 🆕 |
| 賢くする方法 | 担当の経験頼み | 人間が編集できるmdを書き足すだけで出力傾向が変わる（コード変更不要）🆕 |
現状の試作アプリで既に動いているのは、上表の「1商品ずつ画面で確認しながら生成 → 下書き保存 → 採用（お手本登録）」の一連の流れ ✅ です。今回はこれを土台に、量・品質・納品・学習の4点を伸ばします。
「商品単位」だけでなく、店舗向け・広告向け・その他まで洗い出しました。各用途に 粒度（1商品／複数まとめ＝コレクション／テーマ）、モード（都度＝1件ずつ画面確認／バルク＝一括Excel返却）、主な媒体・言語 を付けています。
| # | 用途（ユースケース） | 粒度 | 推奨モード | 主な媒体・言語 | 現状 |
|---|---|---|---|---|---|
| 1 | EC商品ページ原稿 | 1商品 | 都度／バルク両方 | Web・日英 | ✅ 近い機能あり |
| 2 | 店頭POP・下げ札（タグ）文言 | 1商品 | バルク | 店舗・日（英） | ✅ 近い機能あり |
| 3 | 店舗スタッフ用トークスクリプト | 1商品／コレクション | 都度 | 店舗・日 | 🆕 |
| 4 | Web・SNS広告コピー | 1商品／テーマ | 都度 | 広告・日英 | 🆕 |
| 5 | プレスリリース | コレクション／テーマ | 都度 | プレス・日（英） | 🆕 |
| 6 | Instagram投稿文 | 1商品／テーマ | 都度 | SNS・日（英） | 🆕 |
| 7 | ルックブック・カタログ紹介文 | コレクション | バルク | カタログ・日英 | 🆕 |
| 8 | メルマガ・EC特集ページ | テーマ／コレクション | 都度 | メルマガ・日 | 🆕 |
| 9 | 卸・展示会バイヤー向け説明文 | コレクション | バルク | 卸・日英 | 🆕 |
3つの代表的な流れを図にしました。
[ラインシート(Excel)を入力フォルダに置く]
│
▼
[用途を選ぶ]（例: EC商品ページ・日英）
│
▼
[一括生成] ← 承認済みお手本 + 調教md を毎回読み込む
・全商品を並列で生成（速い）
・生成のたびに一貫性チェック（トーン/NG語）
│
▼
[各商品行に原稿を書き戻したExcelを返却] ← そのまま納品可
│
▼
[PR担当が確認 → 良いものに「採用」印]
│
▼
[採用した原稿だけが自動でお手本ライブラリに追加]
（印なし＝間違い/ボツは参照されない）
[1商品を選ぶ] → [用途を選ぶ] → [生成（日英2レーン表示）]
│
▼
[画面で確認・手直し] → [下書き保存]
│
▼
[「採用」印] → お手本ライブラリに追加
※ この (B) の流れは 現状の試作アプリで既に動いています ✅。
[PR担当が調教md（人間編集可）を開く]
・ブランドボイス
・媒体別ルール（ECは長め/POPは短く 等）
・禁止表現・推奨表現・NG語
・過去の学び
│
▼
[書き足して保存]
│
▼
[次回の生成から、その方針が自動で反映される]
（書き足すほど出力が賢くなる）
CEOの強調点に沿って、A〜Eの5グループで整理します。
非エンジニア向けに、「部品どうしの関係」を図と言葉で示します。
┌─────────────────────────────────────────┐
PR担当 ──▶ │ 3つの入口（薄い呼び出し口） │
│ ・都度 ✅ ・バルク 🆕 ・用途別 🆕 │
└───────────────────┬─────────────────────┘
│ どの入口も、同じコアを呼ぶ
▼
┌─────────────────────────────────────────┐
│ 生成コア（1つの共通部品）✅骨格 │
│ 「対象 + 用途テンプレ + お手本 + 方針」 │
│ → 原稿 │
└───┬───────────┬───────────┬──────────────┘
読み込む │ │ │ 読み込む
┌─────────────┘ │ └─────────────┐
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ お手本ライブラリ│ │ 調教md 🆕 │ │ 用途テンプレ │
│（採用印付きのみ）│ │ ブランドボイス │ │ 媒体別の型 │
│ ✅骨格→強化🆕 │ │ 媒体ルール/NG語│ │ ✅一部→拡張🆕 │
└──────────────┘ └──────────────┘ └──────────────┘
│
生成した原稿は次へ
▼
┌─────────────────────────────────────────┐
│ 一貫性チェック（後段）🆕 │
│ ・承認原稿と照合 ・NG語/禁止表現 │
└───────────────────┬─────────────────────┘
▼
┌────────────────────────────┴────────────────────────┐
▼（都度） ▼（バルク）
┌──────────────┐ ┌──────────────────┐
│ 画面に日英表示 │ │ Excelに書き戻し │
│ → 下書き→採用 │ │ → そのまま納品 🆕 │
└──────┬───────┘ └──────────────────┘
│ 「採用」印
▼
[お手本ライブラリへ自動追加]（印なしは入らない）
すべて ローカル運用・API課金なし（組織のclaude CLIを使用）です。顧客の商品データはリポジトリにコミットしません（現状も data/ は非コミット ✅）。
| 種類 | 置き場所（案） | 形式 | 誰が触るか |
|---|---|---|---|
| 入力：ラインシート | 入力フォルダ（自動検出）✅ | Excel（.xlsx/.xlsm） | PR担当が置くだけ |
| 承認済みお手本 | お手本ストア ✅ → 用途タグ付き強化 🆕 | 1原稿=1ファイル（採用印＝承認フラグ付き） | 「採用」印で自動保存 |
| 調教md | 目的別のmdフォルダ 🆕 | Markdown（人間編集可） | PR担当が直接編集 |
| 用途テンプレ | テンプレ定義 ✅ 一部 → 拡張 🆕 | 媒体×言語ごとの型 | 基本は固定、必要時に追加 |
| 生成下書き | 下書きストア ✅ | 1件=1ファイル | 生成・確認時 |
| 出力：納品Excel | 出力フォルダ 🆕 | 原稿列を足したExcel | そのまま納品 |
ブランドボイス.md / 媒体別ルール.md / 禁止・推奨表現.md / 過去の学び.md。一度に全部作らず、早く効果が出る順に3段階で入れます。各フェーズは独立して価値が出ます。
✅ 現状の試作アプリは「都度生成 → 下書き → 採用（お手本化）」まで動いているため、フェーズ0はその上に載せるだけで始められます。
以下は方針を決めていただきたい点です。各案のメリット・デメリットと推奨を添えます。
Q1. 導入の入り口をどこにするか
→ 推奨は案A。小さく始めて効果を確かめ、すぐフェーズ1へ。
Q2. 用途（媒体）をどこまで最初に載せるか
→ 推奨は案A。量産系を先に、作り込み系は後で。
Q3. Excel書き戻しの形
→ 推奨：元シートに列を足す（先方が見慣れた形のまま、そのまま使える）。
Q4. 調教mdの初期内容を誰が用意するか
→ 生成品質はこの初版の質に大きく依存するため、初期の擦り合わせをご相談させてください。
clients/cfcl/pr-generator/ の拡張であり、ゼロからの作り直しではない。| 案 | 内容 | 採否 | 理由 |
|---|---|---|---|
| 案A | 既存アプリの生成コアを活かし、上に都度/バルク/用途別の入口を薄く乗せる | 採用 | 既存資産（生成コア・お手本の骨格）を最大限流用でき、品質が1箇所に集約される |
| 案B | 用途ごとに別々の生成処理を作る | 却下 | 用途が増えるたび品質基準が分散し、トーンがぶれる（強調点1に反する） |
| 案C | 外部SaaS／API従量課金の生成サービスを使う | 却下 | API課金なし・ローカル運用の前提に反する。顧客データの外部流通リスク |
| 案D | お手本を人手で選んで都度貼り付ける | 却下 | 属人的で工数が減らない。採用印→自動蓄積の仕組み（強調点3）に劣る |
clients/cfcl/pr-generator/ の拡張として設計（作り直しではない）