デルタメモ

AI開発

ガイドのタイトルだけで『何の作業の話か』が分からなければ不合格—『汎化した』抽象タイトルを通すな

顧客名は削ってよいが、物件売値・情報メモ・定時収集など種類名まで消すな。初読チェックは本文の前にタイトルと説明文だけで場面が分かるか見る。

公開ガイドのタイトルを一覧で見たとき、「現行だけ直すな」「履歴とラベルを混ぜるな」だけでは、何の作業の話か分かりません。現場では不動産の物件売値のクロールだった、などと本文やチャットの経緯で補完すると通してしまいます。判断基準を他の環境でも使えるようにする（持ち運ぶ）ことと、タイトルから場面を消すことは別です。この記事は、その取り違えを止める判断基準と、作業前にAIへ渡す入力です。

この記事でわかること

状況

典型は次です。

1.別リポの事故メモから公開ガイドのネタを選ぶ 2.顧客名や施設名を消すついでに、「価格」「現行」「履歴」「正本」だけにする 3.一覧や検索では何の話か分からない 4.書く側・チェック側はチャットの経緯を知っているので、「読めば分かる」「汎化したから抽象でよい」と通す 5.前提も記憶もない第三者がタイトルだけ見ると、唐突で不合格なまま公開される

失敗1 — 持ち運びと場面消しを同じ「汎化」と呼ぶ

悪い例

良い例

合格条件

タイトルを見ただけで、「誰が、何の種類のデータを、どんな作業で失敗しやすいか」を一文で言えること。

失敗2 — 本文や経緯でタイトルを補完して通す

悪い例

良い例

合格条件

タイトルと説明文だけ渡した第三者が、本文なしで場面を言えること。言えないならタイトルを直す。

失敗3 — 役割の内部名をタイトルの主役にする

悪い例

良い例

合格条件

タイトルに、読者が知らない運用の役職名だけが並んでいないこと。

失敗4 — ネタ帳の仮タイトル段階で種類名を削る

悪い例

良い例

合格条件

ネタ帳の仮タイトルだけ読んでも、種類名と失敗の型が分かること。

作業前にAIへ渡す入力

人間向けの長い手順は書きません。次はすべて、作業前に AIに読ませる／貼る文 です。

AI向け：永続ルール（rules / AGENTS.md）

公開ガイドのタイトル・説明文・ネタ帳の仮タイトルについて:
1. 顧客名・施設固有名は削ってよい。種類名（物件売値・情報メモ・定時収集・装飾地図・Stripe 等）は残す
2. 「現行／履歴／正本／ラベル／パッチ」だけの抽象タイトルは不合格（偽の汎化）
3. 投稿直列の初読は、本文の前にタイトル＋説明文だけで場面が分かるか見る。「本文を読めば分かる」で通すな
4. 役割の内部名（プレリーダー等）をタイトル先頭の主役にするな。出すなら本文で定義してから
5. 判断基準の持ち運びと、タイトルから場面を消すことを同じ「汎化」と呼ぶな
最初の返信で曖昧タイトルを採用するな。場面が言えないなら差し替え案を出せ。

AI向け：この作業の開始時にチャットへ貼る文

ガイドまたはネタのタイトルを決める／直す作業。本文を書く前に、タイトルと説明文だけ見せて「何の作業・何のデータの話か」を一文で言えるか確認せよ。
言えないなら不合格。種類名を足した差し替え案を出せ。役割の内部名だけで始めるな。「汎化したから抽象でよい」は理由にしない。

人間向け

なし。上をAIに渡すだけでよい。

まとめ

公開ガイドのタイトルは、一覧で読まれる一文です。顧客名は消してよく、種類名は残します。初読は本文の前にタイトルを見ます。持ち運びのための判断基準と、場面を消した抽象タイトルを混同しないでください。

関連