infographics

Basic Memory Images

根拠に基づく内容と標準の出力パスを使用して、リポジトリのビジュアルを生成します。互換性のため、ファイル名とマーカー名には引き続き「infographic」とありますが、PR の生成では画像を最優先します。PR の意図を表すシーン、ポスター、絵画、写真、カバー、タブロー、演出されたアーティファクト、その他のエディトリアルなビジュアル表現を生成します。PR 画像はマージを妨げない BM Bossbot のアーティファクトです。変更履歴とリリース概要の画像は、手動でエビデンスパックを作成するワークフローです。

出力仕様

• 出力先の基底ディレクトリ：docs/assets/infographics/
• PR 画像：docs/assets/infographics/pr-<number>.webp
• 変更履歴画像：docs/assets/infographics/changelog.webp
• 週次画像：
  • 常に 2 週間のレトロスペクティブ期間を対象とします。前週の ISO 週から今週の ISO 週までです（start-week = current-week - 1、end-week = current-week）。
  • 同一年の期間：docs/assets/infographics/<year>-w<start-week>-w<end-week>.webp
  • 年をまたぐ期間： docs/assets/infographics/<start-year>-w<start-week>-<end-year>-w<end-week>.webp

PR モード

PR モードでは、BM Bossbot の要約ブロックを素材として使用します。PR の本文にない内容を主張として手書きしないでください。

1. PR の本文を取得します。

gh pr view <number> --json body --jq '.body // ""' > /tmp/bm-pr-body.md

2. 標準のアセットを生成します。

uv run --script scripts/generate_pr_infographic.py \
  --pr-number <number> \
  --pr-body-file /tmp/bm-pr-body.md \
  --theme "<optional visual theme>" \
  --provenance-output /tmp/bm-infographic-provenance.md \
  --output docs/assets/infographics/pr-<number>.webp

PR の本文に管理対象の画像テーマブロックが含まれている場合、スクリプトが自動的に読み取ります。

<theme>

画像生成を実行する前に、プロンプトの経路をローカルでテストします。

uv run --script scripts/generate_pr_infographic.py \
  --pr-number <number> \
  --pr-body-file /tmp/bm-pr-body.md \
  --theme "<optional visual theme>" \
  --output docs/assets/infographics/pr-<number>.webp \
  --print-prompt

--dry-run は --print-prompt の別名です。どちらも最終プロンプトを出力し、OpenAI を呼び出さずに終了します。

テーマが指定されていない場合、スクリプトは PR 番号と Bossbot の要約に基づき、以下のスタイルプールから決定的な BM ビジュアルの方向性を選択します。これにより、PR 画像を繰り返し生成しても、同じようなありきたりなビジュアルに偏ることを防ぎます。

画像を生成する際は、--provenance-output <path> を指定して来歴情報も書き込みます。BM Bossbot は、次のマーカーを使ってこの管理対象ブロックを PR の本文に公開します。

...

来歴ブロックには、生成されたアセットのパス、画像モデル、サイズ、品質、画像モード、テーマの情報源、選択されたビジュアルの方向性が記録されます。生成されたプロンプト全文を PR の本文に出力することは意図的に避けています。このブロックはデバッグとクリエイティブ上の来歴情報としてのみ扱ってください。マージのゲートにはなりません。

PR 画像は視覚的な補助にすぎません。マージの正式なゲートは、GitHub のコミットステータス BM Bossbot Approval です。

変更履歴モード

プロンプトを書く前に、エビデンスパックを作成します。

• 差分の根拠：マージ済みの PR 差分、マージコミット、またはローカルで再構成した差分
• 変更ファイルの把握：git diff --stat と主要ファイルの読み込み
• 影響の記録：実際の変更に関連付けた変更前後の結果
• 除外リスト：誤解を招くタイトル、取り消された作業、名前の変更だけの差分、推測に基づく TODO
• 選択した画像形式：ポスター、シーン、タブロー、カバー、絵画、写真、演出されたアーティファクト、その他のエディトリアルなビジュアル表現
• 選択した BM スタイルカテゴリー：以下の選択プールからカテゴリーを 1 つだけ選択

プロンプトを作成する前に、以下の資料を読みます。

• references/prompt-blueprint.md
• references/style-balance.md

現在の CHANGELOG.md の項目を読み、最新の重要な変更を含めます。

スタイルとカテゴリーの選択

意味上の適合性に基づいて、画像ごとに BM スタイルカテゴリーを 1 つだけ選択します。ビジネス用途で読みやすさを保ちながら、認識しやすく上品なビジュアル表現にします。

変更内容を伝える、画像を最優先したビジュアル形式を作成します。ポスター、シーン、タブロー、カバー画像、絵画、写真、演出されたアーティファクト、その他のエディトリアルなビジュアル表現が該当します。地図、図、資料ファイル、グラフ、ラベルをシーン内の小道具として登場させることはできますが、テキスト中心のインフォグラフィックにはしないでください。

BM カテゴリーの選択プール：

• コンピュータサイエンスの大学教科書: SICP 風の図、アルゴリズムの講義、 コンパイラのパイプライン、オートマタ、データベースシステム、型理論、オペレーティングシステム
• 古典文学の題材: 航海、ゴシック風の荘園、ディケンズ風の都市地図、 オースティン風の人間関係グラフ、図書館の書き込み、旅行日記
• ファンタジー／D&D 風: クエストマップ、ダンジョンの鍵、ギルドの台帳、魔導書、 動物誌、酒場の掲示板。著作権で保護された設定は使用しない
• 音楽: メタル、ハードロック、パンク、テクノ、ソウル、レゲエのバンド。ポップミュージックは不可、バンドロゴそのもの、アルバムカバー、ミュージシャンの肖像も不可
• SF: 『スター・ウォーズ』に着想を得たノックオフ、『スペースボールズ』寄りのスペースオペラ、艦隊の航路、 ミッションコンソール、密輸品の目録。著作権で保護されたキャラクター、 ロゴ、名の知られた架空の世界観は避ける
• 『コナン・ザ・バーバリアン』に着想を得たソード＆ソーサリー: 崩れた神殿、砂漠のルート、 軍旗、古地図。名の知られたキャラクターの肖像は不可
• コミックブック: 号の表紙、見開きページ、アクションパネルの地図、キャプションボックス、 ハーフトーンのエネルギー、クリーンな効果音のタイポグラフィ
• フレンチ・ニューウェーブ映画: ポスターのスタイル、硬質なタイポグラフィ、街のルートマップ、 ジャンプカットのシークエンス、ハイコントラストのエディトリアル写真の手がかり
• 第二次世界大戦のプロパガンダポスター: 銃後の広報ポスターの言語、 兵站の矢印、配給表、動員地図、大胆で単純化された人物。実在の政党のシンボル、ヘイトを想起させる図像、非人間化するスローガン、誤った 歴史的主張は不可
• イタリア映画のポスター: 手描きのドラマ、大胆なクレジット、表現豊かな色彩、 ルートマップのコラージュ、1960 年代または 1970 年代の映画のエネルギー。直接的な映画タイトルや 俳優の肖像は不可
• シェイクスピア: 舞台図、幕と場面、登場人物一覧、王宮、 舞台裏のキューシート
• ギリシャ神話: 神殿の図、星座のルート、英雄の旅の地図、 神託の石板、迷宮、船の航路
• ノワール探偵のボード: 事件ファイル、赤い糸の地図、タイプされた証拠ラベル、 分署の壁チャート
• NASA のミッションコントロールのダッシュボード: 打ち上げタイムライン、テレメトリマップ、軌道 ルート、ステータスボード
• 宇宙探査と天文学: 天体図譜、天文台の図表、 星野図、軌道力学の図、惑星探査のルート、 望遠鏡の注釈、ミッションの軌道、深宇宙のタイムライン
• 絵画: 抽象画、古典的風景画、レミントンに着想を得た西部の アクション絵画、レンブラントに着想を得たキアロスクーロ、歴史的壁画、嵐の 海景、寓意的なエディトリアル絵画
• 古典的なモノクロ写真: ドキュメンタリーのフィールドレポート、ニュースルームの アーカイブプリント、エディトリアルフォトエッセイ、ストリートフォトグラフィー、ハイコントラストの 暗室プリント、コンタクトシート、都市インフラの写真
• 80 年代のアクション映画: 実写的な爆発、煙る逆光の倉庫、ネオンの街路、 ヘリコプターのサーチライト、ミッションの書類、英雄的なシルエット、 緊迫したカウントダウン、描き込まれた群像ポスター。直接的な俳優の肖像、 実在の映画タイトル、フランチャイズのマーク、決め台詞は不可
• 錬金術の写本: 変成の図、注釈付きのシンボル、レシピのような プロセスマップ、装飾された余白
• ブルータリズムの都市計画: 交通マップ、コンクリートのサイネージ、ゾーニングのブロック、 インフラの図

選択ルール:

• カテゴリは 1 つだけ選択してください。混在させたマッシュアップは作成しないでください。
• 最も適切な画像形式を選択してください。テキスト主体のインフォグラフィックよりも、実際のシーン、ポスター、 絵画、写真、タブロー、カバーを優先してください。
• メタファーは内容に合わせてください。ただし考えすぎないようにしてください。カテゴリは創造的な 触媒であり、意味上の制約ではありません。
• 洗練されたエディトリアルなレンダリング方向性を使用してください。滑らかなアンチエイリアス テキスト、高コントラスト、クリーンなエッジ、読みやすいラベル。
• カテゴリが、読み取れる演出された瞬間、 エディトリアルな構図、象徴的な環境、ルート、アーティファクト、または視覚的 メタファーを通じて構図を導くようにしてください。
• 理解を助けるのに十分なほど構造をリテラルに保ちつつ、 エンジニアリング上の意味を覆い隠すほど重くしないでください。
• レイアウト、構造、カラーパレット、 視覚的メタファーについては画像生成器に創造的な裁量を与えてください。表示する内容については正確に、どのように表示するかについては緩やかにしてください。
• 著作権で保護されたキャラクター、ロゴ、または名前の付いた架空の世界観を使用しないでください。代わりに ジャンルの手がかり、ノックオフ、オリジナルの構図を使用してください。

コンテンツファーストの美的契約

意味は読み取れ、明確に階層化されている必要があります。それ以外はすべて 創造的な領域です。画像形式、レイアウト、視覚的メタファー、装飾要素、 色の選択、カテゴリ固有の視覚言語。

階層:

1. 意味: 何が出荷されたか、何が変わったか、なぜそれが重要なのかが明確でなければなりません。
2. 画像がテキスト、ラベル、セクション、または根拠の箇条書きを使用する場合、それらは 判読可能でなければなりません。
3. 選択されたカテゴリの視覚的 DNA が、ポスター、 シーン、絵画、写真、タブロー、カバー、または象徴的なオブジェクト配置として構図を導くようにしてください。
4. 安全策を取らないでください。誰かが見たくなる視覚的に印象的な画像は、 正確でも退屈なものに勝ります。

厳格なルール:

• コンテンツセクションとラベルは、存在する場合には読み取り可能でなければなりません。テキストは 装飾によって覆い隠されてはなりません。
• エンジニアリングやビジネス上の意味と競合する物語性の強いコピーを使用しないでください。
• すべてのプロンプトには、明確な画像ファーストの構図キューを含める必要があります。演出されたシーン、 ポスター構図、絵画、写真、象徴的なタブロー、ヒーローオブジェクト、 ミッションルーム、ドシエ、アーティファクト、ルート、または視覚的メタファー。
• 正確な座標やパネルのジオメトリを過度に指定しないでください。構図の 骨格を与え、モデルがその周囲で構成できるようにしてください。

生成

1. 最終的なプロンプトを一時的な markdown ファイルに書き込みます。
2. 共有画像ヘルパーで生成します:

uv run --script scripts/generate_infographic.py \
  --prompt-file /tmp/bm-infographic-prompt.md \
  --output docs/assets/infographics/<name>.webp

3. 成功を報告する前に、画像が存在し読み取り可能であることを確認します。

品質基準

• 漠然とした改善主張ではなく、具体的なビフォーアフターの価値ストーリーを伝えてください。
• エンジニアと非技術系のステークホルダーの両方にとって理解しやすいものにしてください。
• テキストが存在する場合は、平易な言葉のセクションタイトルとラベルを使用してください。
• 明確な視覚的階層を含めてください。タイトル、演出されたフォーカルポイント、象徴的なシーン、 根拠となる小道具、またはヒーローオブジェクト。
• でっち上げられた事実は避けてください。提供されたソース資料のみを使用してください。
• 中間または差し戻された作業よりも、出荷された成果を優先してください。
• 高コントラスト、極小でないラベル、整理された レイアウトで読みやすさを保ってください。