プロンプト作成を自動化するツール「Promogen」を社内リリースした
展示会用パンフレットのプロンプトを毎回手で書いていた工程を、Promogenが1クリックに変えた。製品資料をアップロードするだけで、Claude Design用の完成プロンプトが自動生成される。AI呼び出しは1回のみ、データベース不要のステートレス構成で、社内ツールとして即日Vercelにデプロイした。このツールがどう動き、開発中に何が分かったかを記録する。
解決した課題:毎回発生していた「プロンプト職人」問題
展示会に出展するたびに、担当者はパンフレット用のプロンプトを手で組み立てていた。やることは毎回同じ3ステップだ。製品資料を読んで要点を抽出し、ブランドの固定ルール(レイアウト指定・会社情報・出力形式)を書き起こし、それらを矛盾なく統合する。
この作業には二重の問題がある。一つは担当者の負荷で、毎回ゼロから書くため時間がかかる。もう一つは品質のばらつきで、書き手によって固定ルールの書き漏れや資料の解釈ミスが起きる。プロンプトの出来がそのままパンフレットの出来に直結するため、この工程の自動化は優先度が高い課題だった。
Promogenはこの3ステップを、製品名・資料ファイル・自由記述・含めたいセクション選択という4つの入力に置き換えた。入力後に生成ボタンを押せば、Claude Design用の完成プロンプトが出力される。担当者が手を動かすのは「コピーして貼り付ける」だけになる。
製品の特徴:11セクション対応、単一APIエンドポイントの設計
Promogenが持つ機能を事実ベースで列挙する。
PDF・Word(.docx)・Markdown・テキストの4形式、複数ファイル同時アップロード対応。ドラッグ&ドロップとファイル選択ダイアログの両方をサポートする。
パンフレットを構成しうる要素を11種定義している。デフォルトは全選択で、チェックボックスで任意に絞り込める。
生成プロンプトの文字数カウント表示、ワンクリックでのクリップボードコピーに対応する。
Promogen自体はパンフレットのHTMLを生成しない。出力物は「Claude Designに貼り付けるための文字列」であり、実際の生成は利用者が外部サービスで行う。この責務の切り分けにより、Promogen側の複雑度を最小に保っている。
実現の仕組み:Claude API呼び出し1回、残りは文字列置換
アーキテクチャは意図的にシンプルに保った。外部依存はAnthropic Claude APIのみ、データベースは持たない、永続化ストレージも持たない。全状態はブラウザのReact状態(useState)に閉じる。
処理の流れは以下の通りだ。
POST /api/generate へ FormData を送信pdf-parse、docx: mammoth、md/txt: UTF-8デコード)claude-sonnet-4-6、max_tokens: 2048)を1回だけ呼び出して事実ベースの要約(ブリーフ)を生成lib/template.ts の fillTemplate() がブリーフをテンプレートへ正規表現で文字列置換ステップ4はAI呼び出しではなく純粋な文字列置換だ。{{ phProductName }}と{{ phBriefText }}という2つのプレースホルダーをブリーフで埋めるだけ。AI呼び出しをステップ3の1回に絞ったことで、処理時間の予測可能性が上がり、コストの見通しも立てやすくなった。
モデル名はlib/template.tsのMODEL定数1箇所に集約している。モデル更新時の変更が1行で済む設計だ。Vercel Functionの実行上限は120秒で、これがシステム全体のタイムアウト制約になる。
制作を通じた気づき:「チェックボックス強制」は失敗だった
開発中に一度、設計判断の誤りに気づいて修正した。最も学びが大きかった変更を記録しておく。
当初、セクション選択チェックボックスは「チェックしたセクションを必ずパンフレットに出力する」強制指定として設計していた。しかし実際に動かすと問題が出た。資料に記載がないセクションがチェックされていると、Claude Designがそのセクションを「創作」で埋めようとする。事実ベースの制約と強制出力が矛盾するため、出力品質が不安定になった。
資料に無い項目もチェックされていれば出力しようとし、Claude Designが「創作」で埋める。出力品質が不安定になった。
出力可否はブリーフに具体的事実が含まれるかで判定。資料に書いていないことは出力しない、をシステムで担保する。
2026-07-07のコミットで「ブリーフ内容駆動」方式へ変更した。現在のチェックボックスは「ブリーフ生成時にClaude APIへ渡す対象範囲のヒント」としてのみ機能し、最終的にパンフレットへ何を出力するかはブリーフに当該セクションの具体的事実が含まれているかどうかで判定する。資料に書いていないことは出力しない、という方針をシステムレベルで担保する構造に変わった。
同時期の変更でもう一つ気づいたことがある。セクションIDの扱いだ。当初はAPIに渡すセクション指定を内部ID(例: "BEFORE")で送っていたが、これが原因で一部セクションの内容がブリーフに正しく反映されない不具合が発生した。Claude APIは「BEFOREというIDを処理しろ」という指示より「④Before/After というセクションの内容を整理しろ」という自然言語ラベルの方が意図を正確に解釈する。IDを表示ラベル(例: 「④Before/After」)に変換してから渡すよう修正することで不具合が解消した。
プロンプトの詳細度についても、開発後半で設計方針が逆転した。最初は画像プロンプトの型、ブランドカラー表、タイポグラフィ細則、コピーのトーンガイドなど詳細な指示をテンプレートに盛り込んでいた。しかし最終的には「絶対ルール+レイアウト判定ロジック+骨格情報のみ」に大幅に縮小した。詳細を減らしてClaude側の裁量に委ねるほど、出力の安定性が上がった。指示が多いほど良いという直感は、少なくともこのユースケースでは間違いだった。
今後の展望:履歴・ファイルサイズ制限・エラー表示
機能面では3つの課題が残る。一つ目は生成履歴の不在で、過去に生成したプロンプトを振り返る手段がない。担当者からの要望が積み上がれば履歴機能を追加する。二つ目はファイルサイズの上限バリデーションで、大きなファイルや多数ファイルの同時アップロード時にVercel Functionの120秒制限に達する可能性がある。三つ目はエラーメッセージの粒度で、APIキー未設定やレート制限時にconsole.errorしか出ていないため、利用者向けの分かりやすいフィードバックを追加する余地がある。
Promogenは「プロンプトを毎回手で書く」という工程を自動化することに特化したツールとして、現状の設計を維持する方針だ。パンフレット生成そのものには踏み込まない。このシステム境界を守ることが、ツールのシンプルさを担保する。
あなたのチームでも「毎回同じことを手で書く」工程はあるだろうか。そこにどんな固定ルールと可変情報が混在しているか、一度棚卸しする価値はあるはずだ。