@takagaki/cortex-decisions-viewer 0.4.37 → 0.4.38

package/dist/render.js

@@ -269,89 +269,57 @@ function tutorialChallenge4Prompt(decisions) {
 }
 /**
  * 書き込み・外部連携をともなうチャレンジのプロンプト。
- * リンク先はクラウド実行のセッションでエンジンのスキルがロードされないため、規約・手順を埋め込んで自己完結させる
- * （AI導線ボタンのプロンプトと同じ方針）。スキルが使える環境ではそちらを優先させる旨を冒頭に添える。
+ * 規約はプロンプトに書き写さず、規約のあるファイル（README.md・template.md）をAIに読ませ、
+ * 中身は利用者に聞き返させる（AI導線ボタンのプロンプトと同じ方針）。
+ * 規約がどこにも無い手順（外部サービスへのつなぎ方・投稿経路の判定）だけを骨子として残す。
+ * スキルが使える環境ではそちらを優先させる旨を冒頭に添える。
  */
 const TUT_MEMBER_PROMPT = [
-    "（update-member スキルが使える環境なら、そのスキルの手順を優先してください。使えない場合は以下に従ってください。）",
+    "（update-member スキルが使える環境なら、そのスキルの手順を優先してください。）",
     "",
-    "Cortex/Members/records/ にある、わたし自身のメンバーレコードの表示名（title）を変更してください。Gold層へ書き込む練習です。名簿にわたしのレコードが無ければ、新規登録として1ファイル作ってかまいません。",
+    "Cortex/Members/README.md と Cortex/Members/template.md を読んで規約を把握してから、Cortex/Members/records/ にあるわたし自身のメンバーレコードの表示名（title）を変更してください。Gold層へ書き込む練習です。名簿にわたしのレコードが無ければ、新規に1件作ってかまいません。",
+    "わたしが誰で、何をどう変えたいかは、まずわたしに質問してください。",
+    "あなた（人間）が内容を確認して編集したので、status が draft なら active に上げてください。",
+    "書き込む前に、作成・変更する内容を提示して承認を得てください。",
     "",
-    "前提:",
-    "- 名簿は更新型です。氏名・所属・役割が変わったら frontmatter・本文を直接更新してかまいません（変更履歴は git が持ちます）",
-    "- 新しい表記揺れ（文字起こしの誤変換・呼称）は新規ファイルを作らず aliases に追記します",
-    "- 本人やPMに確認が取れたら status: draft を active に上げます。確証が無い項目は推測で埋めず空のままにします",
-    "- 離任しても削除せず status: inactive にします（過去の議事録・決定の人名正規化の根拠として残すため）",
-    "",
-    "手順:",
-    "1. Cortex/Members/README.md（スキーマ）と、対象になるレコードを読む",
-    "2. わたしのレコードが無ければ、ファイル名 records/{氏名（スペース無し）}.md・id member:{氏名（スペース無し）} で新規に作る",
-    "3. frontmatter の必須は type: member / id（member:{氏名（スペース無し）}） / title / description / status。任意は yomi・aliases・org・side（cm | client | vendor）・role・email。README 定義以外のフィールドは追加しない",
-    "4. 名簿に書くのは氏名・所属・役割・表記揺れだけ。人の評価・人事・単価・工数は書かない",
-    "",
-    "共通ルール:",
-    "- 書き込む前に、作成・更新する内容を提示して承認を得てください",
-    "- 同じ人に複数ファイルを作らないよう、既存レコードとの重複を必ず確認してください",
-    "- relations の target にファイルパスは書かず、安定ID（member:{氏名} / 決定ID YYYYMMDD-NNN / 課題キー 等）で張ってください",
-    "- 売上・単価・工数・人事評価などの内部限定情報は書かないでください（このリポジトリは顧客も閲覧します）",
+    "売上・単価・工数・人事評価などの内部限定情報は書かないでください（このリポジトリは顧客も閲覧します）。",
 ].join("\n");
 const TUT_BACKLOG_PROMPT = [
-    "（backlog-push スキルが使える環境なら、そのスキルの手順を優先してください。使えない場合は以下に従ってください。）",
+    "（backlog-push スキルが使える環境なら、そのスキルの手順を優先してください。）",
     "",
     "Backlogの課題に、わたしの名義でコメントを1件投稿してください。Backlogの画面を開かずにAIから記票する練習です。",
+    "どの課題に何を書くかは、まずわたしに質問してください（課題は 課題管理/issues/ から選べます。課題キーは各ファイルの「基本情報 > 課題キー」）。",
     "",
-    "Backlogのつなぎ方（本人名義で投稿するには Backlog MCP の接続が必要です）:",
-    "- 手元の Claude Code（CLI・デスクトップ）なら /mcp コマンドから backlog を選んで認証する",
-    "- クラウドのセッション（claude.ai/code）なら、セッションのコネクタ設定で Backlog を有効にする",
+    "投稿経路は次の優先順で判定し、Backlog上の名義とあわせて先に伝えてください。",
+    "1. mcp__backlog__ で始まるツール（あなた本人の名義。手元にAPIキーは不要）",
+    "2. 環境変数 DOMAIN / PROJECT_KEY / BACKLOG_API_KEY があれば Backlog REST API を直接呼ぶ（キーの持ち主の名義）",
+    "3. 課題管理/backlog-proxy.json（url / projectKey / token）の中央プロキシ（共有bot名義になるため、本文の冒頭に自分の名前を記名する）",
+    "4. どれも無ければ、つなぎ方（手元の Claude Code なら /mcp コマンドから backlog、クラウドならセッションのコネクタ設定）を案内して止まる",
     "",
-    "手順:",
-    "1. どの経路で書き込むかを次の優先順で判定し、判定結果とBacklog上の名義を最初に伝える",
-    "   - mcp__backlog__ で始まるツールが使えるなら、それを使う（あなた本人の名義。手元にAPIキーは不要）",
-    "   - 使えない場合、環境変数 DOMAIN / PROJECT_KEY / BACKLOG_API_KEY が参照できるなら Backlog REST API を直接呼ぶ（キーの持ち主の名義）",
-    "   - どちらも無ければ 課題管理/backlog-proxy.json（url / projectKey / token）を読み、その中央プロキシ経由で投稿する（共有bot名義になるため、本文の冒頭に自分の名前を記名する）",
-    "   - 3つとも無ければ、上記のつなぎ方を案内して止まる",
-    "2. 課題管理/issues/ からコメントする課題を1件選ぶ（候補を挙げて確認する）。課題キーは各ファイルの「基本情報 > 課題キー」にある",
-    "3. 投稿する課題キー・本文・使う経路・Backlog上の名義を提示して、承認を得る",
-    "4. 承認後に投稿し、投稿先のURLを報告する",
-    "",
-    "注意:",
-    "- 今回はコメントの追加だけです。課題の削除・クローズ・属性変更はしないでください",
-    "- 売上・単価・工数・人事評価などの内部限定情報は書かないでください（顧客も閲覧します）",
+    "投稿する前に、課題キー・本文・経路・名義を提示して承認を得てください。投稿後は投稿先のURLを報告してください。",
+    "今回はコメントの追加だけです。課題の削除・クローズ・属性変更はしないでください。",
+    "売上・単価・工数・人事評価などの内部限定情報は書かないでください（このリポジトリは顧客も閲覧します）。",
 ].join("\n");
 const TUT_DESIGN_PROMPT = [
-    "デザイン/inventory/ の画面インベントリから画面を1つ選び、それがどんな画面なのかを説明してください。",
-    "",
-    "手順:",
-    "1. デザイン/inventory/ を一覧し、主要そうな画面を1つ選ぶ（1画面1ファイル。frontmatter に安定ID design:{fileKey}:{nodeId} とFigmaへのディープリンクがあります）",
-    "2. その画面のファイルを読み、画面の役割・主な要素・前後の画面とのつながりを、読み取れる範囲で説明する",
-    "3. 関連する決定（Cortex/Decisions/）・用語（Cortex/Glossary/）・課題（課題管理/issues/）があれば、安定IDをたどって補足する",
-    "4. 最後に、Figmaで実物を開くリンクを提示する",
-    "",
-    "注意:",
-    "- 読むだけです。ファイルの作成・更新はしないでください",
-    "- インベントリはFigmaからの同期で上書きされる生成物です。手で編集しないでください",
+    "デザイン/inventory/ の画面インベントリから画面を1つ選び、それがどんな画面なのかを説明してください。1画面1ファイルで、frontmatter に安定ID（design:{fileKey}:{nodeId}）とFigmaへのディープリンクがあります。",
+    "どの画面が見たいかは、まずわたしに質問してください（希望が無ければ主要そうな画面をあなたが選んでかまいません）。",
+    "画面の役割・主な要素・前後の画面とのつながりを説明し、関連する決定・用語・課題があれば安定IDをたどって補足し、最後にFigmaで実物を開くリンクを提示してください。",
+    "読むだけの練習です。インベントリはFigmaからの同期で上書きされる生成物なので、手で編集しないでください。",
 ].join("\n");
 const TUT_SLACK_PROMPT = [
     "Cortex のチュートリアルを完了したことを、この案件の Slack チャンネルに投稿してください。最後のステップです。",
     "",
-    "Slackのつなぎ方:",
-    "- 手元の Claude Code（CLI・デスクトップ）なら /mcp コマンドから slack を選んで認可する",
-    "- クラウドのセッション（claude.ai/code）なら、セッションのコネクタ設定で Slack を有効にする",
-    "- どちらもできない場合は、その旨とつなぎ方を案内して止まってください",
-    "",
-    "手順:",
-    "1. チャット/channels.json を読み、登録されているチャンネル（name / url / description）から投稿先を選ぶ。複数あれば description を見て判断し、迷ったら確認する",
+    "1. チャット/channels.json を読んで投稿先のチャンネルを選ぶ（複数あれば description を見て判断し、迷ったらわたしに聞く）",
     "2. 次の雛形で本文を作る（{名前} は Cortex/Members/records/ にあるわたしのレコードの表記に合わせる）",
     "",
     "🎉 {名前} さんが Cortex のチュートリアルを完了しました",
     "できるようになったこと: Gold層から案件を把握する・自分の情報を更新する・Backlogに記票する・資料を投入する",
     "使い方の質問はこのチャンネルへどうぞ",
     "",
-    "3. 投稿先のチャンネルと本文をプレビューして、承認を得る",
-    "4. 承認後に投稿し、投稿したメッセージのリンクを報告する",
+    "3. 投稿先と本文をプレビューして承認を得てから投稿し、メッセージのリンクを報告する",
     "",
-    "注意:",
-    "- 売上・単価・工数・人事評価などの内部限定情報は書かないでください",
+    "Slack につながっていない場合は、つなぎ方（手元の Claude Code なら /mcp コマンドから slack、クラウドならセッションのコネクタ設定）を案内して止まってください。",
+    "売上・単価・工数・人事評価などの内部限定情報は書かないでください（このリポジトリは顧客も閲覧します）。",
 ].join("\n");
 const CSS = `
 :root {
@@ -974,150 +942,86 @@ const CLIENT_JS = `
   }
   // Gold型（ディレクトリ名）→ 書き込みプロンプトの対応。決定事項/用語集/メンバー/ルールの4型のみ。
   // レポート等スキルの無いディレクトリは対象外（ボタンを出さない）。
-  // リンク先はクラウド実行のセッションでエンジンのスキルがロードされないため、プロンプトには規約を埋め込んで自己完結させる。
+  // プロンプトには規約を書き写さない。各区画の README.md（規約）と template.md（雛形）をAIに読ませ、
+  // 中身は利用者に聞き返させる（規約の二重定義を避け、READMEの更新がそのまま効くようにするため）。
   // スキルが使える環境（手元のCLI・デスクトップ等）ではそちらを優先させる旨を冒頭に添える。
   function aiHead(skill) {
-    return "（" + skill + " スキルが使える環境なら、そのスキルの手順を優先してください。使えない場合は以下に従ってください。）\\n\\n";
+    return "（" + skill + " スキルが使える環境なら、そのスキルの手順を優先してください。）\\n\\n";
   }
-  // 4型すべてに付ける共通の規律（承認・重複・安定ID・公開範囲）
-  var AI_COMMON = [
-    "",
-    "",
-    "共通ルール:",
-    "- 書き込む前に、作成・更新する内容を提示して承認を得てください",
-    "- 同じ対象に複数ファイルを作らないよう、既存レコードとの重複を必ず確認してください",
-    "- relations の target にファイルパスは書かず、安定ID（決定ID YYYYMMDD-NNN / term:{代表表記} / rule:{slug} / member:{氏名} / 課題キー / minute:{定例名}:{YYYYMMDD}）で張ってください",
-    "- 売上・単価・工数・人事評価などの内部限定情報は書かないでください（このリポジトリは顧客も閲覧します）",
-  ].join("\\n");
+  // 4型すべてに付ける共通の規律。READMEに書けない公開範囲の注意だけを1行残す
+  var AI_COMMON =
+    "\\n\\n売上・単価・工数・人事評価などの内部限定情報は書かないでください（このリポジトリは顧客も閲覧します）。";
   var GOLD_SKILL = {
     "Decisions": {
       skill: "update-decision",
       noun: "決定",
+      dir: "Cortex/Decisions",
       add: [
-        "これから伝える決定事項を Cortex/Decisions/records/ に1決定1ファイルで記録してください。",
-        "",
-        "手順:",
-        "1. Cortex/Decisions/README.md（フィールド定義・カテゴリー一覧）と Cortex/Decisions/template.md を読む",
-        "2. 既存の records/ を一覧し、同じ決定が記録済みでないかと、決定日の連番の続きを確認する",
-        "3. ファイル名は YYYYMMDD-NNN-決定内容の要約.md（YYYYMMDD=決定日、NNN=同日内の連番）",
-        "4. frontmatter の必須は type: decision / id（YYYYMMDD-NNN） / title / date / sprint（スプリント運用が無ければフェーズ名） / category（ビジネス・技術選定・設計方針・運用ルール・インフラ・デザインから選ぶ） / deciders（Cortex/Members/records/ の正式表記に揃える。名簿に無い人名は「（要確認）」を付ける） / description（1文要約） / references（出典への人間向けリンク）。README 定義以外のフィールドは追加しない",
-        "5. 根拠がある場合は relations に rel: based_on で安定IDを張る（議事録は minute:{定例名}:{YYYYMMDD}、課題は課題キー）",
-        "6. 本文は「# タイトル」「## 背景」（なぜ必要になったか）「## 理由」（なぜその選択をしたか・他案との比較）",
-        "7. 過去の決定を変える内容なら、その記録は書き換えず新しい記録を作り、relations に rel: supersedes で元の決定IDを張る",
-        "8. 確定した決定だけを記録する（検討中・未確定の議論は記録しない）",
+        "Cortex/Decisions/README.md と Cortex/Decisions/template.md を読んで記録の規約を把握してから、決定事項を1件記録してください。",
+        "何を記録するかは、まずわたしに質問してください。",
+        "書き込む前に、作成するファイルの内容を提示して承認を得てください。",
       ].join("\\n"),
-      edit: function (target) {
+      edit: function (target, subject) {
         return [
-          target + "について、これから伝える変更を反映してください。",
-          "",
-          "重要: 決定の内容そのものが変わる場合、この記録は書き換えません。Cortex/Decisions/records/ に新しいファイル（YYYYMMDD-NNN-決定内容の要約.md。YYYYMMDD=新しい決定日、NNN=同日内の連番）を作り、frontmatter の relations に rel: supersedes / target: 元の決定ID を張って、背景・理由に変更の経緯を書いてください。誤字・リンク切れなど決定の中身が変わらない訂正だけ、その場で直してかまいません。",
-          "",
-          "手順:",
-          "1. Cortex/Decisions/README.md（フィールド定義・カテゴリー一覧）と対象ファイルを読む",
-          "2. 新しい記録を作る場合は、既存の records/ で連番の続きと重複を確認する",
-          "3. frontmatter の必須は type: decision / id / title / date / sprint / category / deciders（Cortex/Members/records/ の正式表記に揃える） / description / references。README 定義以外のフィールドは追加しない",
-          "4. 本文は「# タイトル」「## 背景」「## 理由」の構成を保つ",
-          "5. あなた（人間）が内容を確認して編集したので、status が draft（AI生成・人間未確認）なら active に上げる。内容を確認せず表記・形式だけ直した場合は draft のままにする",
+          target + " を読んでから、" + subject + "を修正してください。",
+          "何を直すかは、まずわたしに質問してください。",
+          "決定の内容そのものが変わる場合は、この記録を書き換えず、supersedes で新しい記録を作ってください。",
+          "あなた（人間）が内容を確認して編集したので、status が draft なら active に上げてください。",
+          "書き込む前に、変更内容を提示して承認を得てください。",
         ].join("\\n");
       },
     },
     "Glossary": {
       skill: "update-glossary",
       noun: "用語",
+      dir: "Cortex/Glossary",
       add: [
-        "これから伝える用語を Cortex/Glossary/records/ に1用語1ファイルで登録してください。",
-        "",
-        "手順:",
-        "1. Cortex/Glossary/README.md（スキーマ・除外用語リスト）と Cortex/Glossary/template.md を読む",
-        "2. 既存 records/ の title と synonyms を確認する。既存用語の表記揺れなら新規ファイルを作らず、その用語の synonyms に追記する。除外用語リストに載っている語は登録しない",
-        "3. ファイル名は records/{代表表記}.md、id は term:{代表表記}",
-        "4. frontmatter の必須は type: term / id / title / description（1文要約） / scope（project=案件固有 | organization=全社共通） / status / date（登録日）。任意は synonyms（表記揺れ）・source（この案件での出典）・references。README 定義以外のフィールドは追加しない",
-        "5. 案件固有語は社内の情報源（議事録・課題・資料）の記述だけを根拠に定義する（Web検索せず references も付けない）。Figma・OIDC のような一般公開のサービス・技術・規格は、Web で公式ドキュメント等の一次情報を確認してから定義し、そのURLを references に入れる。推測で書かない",
-        "6. 定義を人間と確認できた場合のみ status: active。確証が持てなければ status: draft（AI生成・人間未確認の印）にする",
-        "7. 本文にはこの案件における意味を1〜数段落で具体的に書く（一般的な意味に加え、この案件で特殊な使われ方があれば補足する）",
+        "Cortex/Glossary/README.md と Cortex/Glossary/template.md を読んで登録の規約を把握してから、用語を1件登録してください。",
+        "何を登録するかは、まずわたしに質問してください。",
+        "書き込む前に、作成するファイルの内容を提示して承認を得てください。",
       ].join("\\n"),
-      edit: function (target) {
+      edit: function (target, subject) {
         return [
-          target + "について、これから伝える修正を反映してください。",
-          "",
-          "前提:",
-          "- 用語集は更新型です。定義が変わったら本文・frontmatter を直接更新してかまいません（変更履歴は git が持ちます）",
-          "- 新しい表記揺れは新規ファイルを作らず synonyms に追記します",
-          "- 定義を人間と確認できたら status: draft を active に上げます",
-          "- 使われなくなった用語は削除せず status: superseded にします",
-          "",
-          "手順:",
-          "1. Cortex/Glossary/README.md（スキーマ）と対象ファイルを読む",
-          "2. frontmatter の必須は type: term / id（term:{代表表記}） / title / description / scope / status / date。README 定義以外のフィールドは追加しない",
-          "3. 一般公開のサービス・技術・規格は Web で公式ドキュメント等の一次情報を確認してから定義を直し、references にそのURLを入れる。案件固有語は社内の情報源だけを根拠にし、推測で書かない",
-          "4. あなた（人間）が内容を確認して編集したので、status が draft（AI生成・人間未確認）なら active に上げる。内容を確認せず表記・形式だけ直した場合は draft のままにする",
+          target + " を読んでから、" + subject + "を修正してください。",
+          "何を直すかは、まずわたしに質問してください。",
+          "あなた（人間）が内容を確認して編集したので、status が draft なら active に上げてください。",
+          "書き込む前に、変更内容を提示して承認を得てください。",
         ].join("\\n");
       },
     },
     "Members": {
       skill: "update-member",
       noun: "メンバー",
+      dir: "Cortex/Members",
       add: [
-        "これから伝えるメンバーを Cortex/Members/records/ に1人1ファイルで登録してください。",
-        "",
-        "手順:",
-        "1. Cortex/Members/README.md（スキーマ）と Cortex/Members/template.md を読む",
-        "2. 既存 records/ の title・aliases・side を確認する。既存メンバーの表記揺れなら新規ファイルを作らず、その人の aliases に追記する（同一人物に複数ファイルを作らない）",
-        "3. ファイル名は records/{氏名（スペース無し）}.md、id は member:{氏名（スペース無し）}",
-        "4. frontmatter の必須は type: member / id / title（氏名の正式表記。スペースを含んでよい） / description（何者かの1文） / status（active=在籍 | inactive=離任 | draft=AI生成・人間未確認）。任意は yomi・aliases・org・side（cm=開発側 | client=顧客 | vendor=ベンダー）・role・email。README 定義以外のフィールドは追加しない",
-        "5. 氏名・所属・side を推測で確定させない。確証が無い項目は空にし、確認が取れていないレコードは status: draft のままにする",
-        "6. 本文にも何者かを1〜2文書く（Viewer の個別ページに表示されるため空にしない）",
-        "7. 名簿に書くのは氏名・所属・役割・表記揺れだけ。人の評価・人事・単価・工数は書かない",
+        "Cortex/Members/README.md と Cortex/Members/template.md を読んで登録の規約を把握してから、メンバーを1人登録してください。",
+        "誰を登録するかは、まずわたしに質問してください。",
+        "書き込む前に、作成するファイルの内容を提示して承認を得てください。",
       ].join("\\n"),
-      edit: function (target) {
+      edit: function (target, subject) {
         return [
-          target + "について、これから伝える修正を反映してください。",
-          "",
-          "前提:",
-          "- 名簿は更新型です。氏名・所属・役割が変わったら frontmatter・本文を直接更新してかまいません（変更履歴は git が持ちます）",
-          "- 新しい表記揺れ（文字起こしの誤変換・呼称）は新規ファイルを作らず aliases に追記します",
-          "- 本人やPMに確認が取れたら status: draft を active に上げます。確証が無い項目は推測で埋めず空のままにします",
-          "- 離任しても削除せず status: inactive にします（過去の議事録・決定の人名正規化の根拠として残すため）",
-          "",
-          "手順:",
-          "1. Cortex/Members/README.md（スキーマ）と対象ファイルを読む",
-          "2. frontmatter の必須は type: member / id（member:{氏名（スペース無し）}） / title / description / status。任意は yomi・aliases・org・side（cm | client | vendor）・role・email。README 定義以外のフィールドは追加しない",
-          "3. 名簿に書くのは氏名・所属・役割・表記揺れだけ。人の評価・人事・単価・工数は書かない",
-          "4. あなた（人間）が内容を確認して編集したので、status が draft（AI生成・人間未確認）なら active に上げる。内容を確認せず表記・形式だけ直した場合は draft のままにする",
+          target + " を読んでから、" + subject + "を修正してください。",
+          "何を直すかは、まずわたしに質問してください。",
+          "あなた（人間）が内容を確認して編集したので、status が draft なら active に上げてください。",
+          "書き込む前に、変更内容を提示して承認を得てください。",
         ].join("\\n");
       },
     },
     "Rules": {
       skill: "update-rule",
       noun: "ルール",
+      dir: "Cortex/Rules",
       add: [
-        "これから伝えるルール（案件で継続的に守る制約）を Cortex/Rules/records/ に1ルール1ファイルで登録してください。",
-        "",
-        "手順:",
-        "1. Cortex/Rules/README.md（スキーマ・除外ルールリスト）と Cortex/Rules/template.md を読む",
-        "2. Rule と Decision を判別する。Rule は「本番リリースは金曜禁止」のように今も効き続ける約束事だけ。一回きりの決定・単発のTODO・期限付きの依頼は Rule にしない（それは Cortex/Decisions/ の担当）",
-        "3. 既存 records/ の title を確認して重複を避ける。README の除外ルールに載っている制約は起票しない（除外リストは読むだけで編集しない）",
-        "4. ファイル名は records/{slug}.md、id は rule:{slug}（例: rule:本番リリース-金曜禁止）",
-        "5. frontmatter の必須は type: rule / id / title（制約の1行表現） / description（1文要約） / status（draft=AI生成・人間未確認 | active=確認済み）。README 定義以外のフィールドは追加しない",
-        "6. status は原則 draft。対話でユーザー本人が制約の内容に合意している場合だけ active にしてよい",
-        "7. 元になった決定があれば relations に rel: derived_from / target: 決定ID（YYYYMMDD-NNN）を、議事録・課題が根拠なら rel: based_on で安定IDを張る",
-        "8. 本文は「## 制約」「## 適用範囲」「## 違反するとどうなるか」「## 出典」で構成する",
+        "Cortex/Rules/README.md と Cortex/Rules/template.md を読んで登録の規約を把握してから、ルール（案件で継続的に守る制約）を1件登録してください。",
+        "何を登録するかは、まずわたしに質問してください。",
+        "書き込む前に、作成するファイルの内容を提示して承認を得てください。",
       ].join("\\n"),
-      edit: function (target) {
+      edit: function (target, subject) {
         return [
-          target + "について、これから伝える修正を反映してください。",
-          "",
-          "前提:",
-          "- ルールは更新型です。制約の表現・適用範囲が変わったら frontmatter・本文を直接更新してかまいません（変更履歴は git が持ちます）",
-          "- 内容を人間と確認できたら status: draft を active に上げます（本人の合意が無いものを勝手に active にしない）",
-          "- 効かなくなったルールは削除せず、本文に失効を追記して元の決定から履歴をたどれるようにします",
-          "- 継続的な制約でなくなる内容（一回きりの決定）は Rule ではなく Cortex/Decisions/ の担当です",
-          "",
-          "手順:",
-          "1. Cortex/Rules/README.md（スキーマ・除外ルール）と対象ファイルを読む",
-          "2. frontmatter の必須は type: rule / id（rule:{slug}） / title / description / status。README 定義以外のフィールドは追加しない",
-          "3. 本文は「## 制約」「## 適用範囲」「## 違反するとどうなるか」「## 出典」の構成を保つ",
-          "4. あなた（人間）が内容を確認して編集したので、status が draft（AI生成・人間未確認）なら active に上げる。内容を確認せず表記・形式だけ直した場合は draft のままにする",
+          target + " を読んでから、" + subject + "を修正してください。",
+          "何を直すかは、まずわたしに質問してください。",
+          "あなた（人間）が内容を確認して編集したので、status が draft なら active に上げてください。",
+          "書き込む前に、変更内容を提示して承認を得てください。",
         ].join("\\n");
       },
     },
@@ -1141,10 +1045,10 @@ const CLIENT_JS = `
     var g = goldSkill(sectionName);
     if (!g) return null;
     var pathRef = repoPathOf(rec);
-    var target = pathRef
-      ? pathRef + " の" + g.noun + "「" + title + "」"
-      : "この" + g.noun + "「" + title + "」（" + rec.id + "）";
-    var prompt = aiHead(g.skill) + g.edit(target) + AI_COMMON;
+    // target=AIに読ませるファイル（対象レコード＋規約のREADME）、subject=直す対象の呼び名
+    var target = (pathRef ? pathRef + " と " : "") + g.dir + "/README.md";
+    var subject = "この" + g.noun + "「" + title + "」" + (pathRef ? "" : "（" + rec.id + "）");
+    var prompt = aiHead(g.skill) + g.edit(target, subject) + AI_COMMON;
     return el("a", { class: "ai-edit-btn", href: codeUrl(prompt), target: "_blank", rel: "noopener", text: "AIで編集" });
   }
   // 本文HTMLは bodies/<i>.html に外出しされている。詳細表示時にfetchして埋める（キャッシュ・失敗時フォールバック付き）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takagaki/cortex-decisions-viewer",
-  "version": "0.4.37",
+  "version": "0.4.38",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,