@takagaki/cortex-decisions-viewer 0.4.34 → 0.4.37

package/dist/build.js

@@ -177,6 +177,15 @@ async function readFleetSources(repoRoot) {
     }
     return { externalSources, internalSources, pipelines, tools };
 }
+/** パスがディレクトリとして存在するか */
+async function isDirectory(dirAbs) {
+    try {
+        return (await node_fs_1.promises.stat(dirAbs)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
 /** ディレクトリ内の .md を汎用レコードとして読み込む（存在しなければ空配列） */
 async function loadGenericRecords(dirAbs, exclude, repoBaseUrl, branch) {
     let entries;
@@ -915,8 +924,11 @@ async function build(opts) {
         for (const e of rootEntries) {
             if (!e.isDirectory() || e.name === "Decisions")
                 continue;
-            const records = await loadGenericRecords(path.join(knowledgeRoot, e.name, "records"), exclude, repo.baseUrl, repo.branch);
-            if (records.length)
+            const recordsDir = path.join(knowledgeRoot, e.name, "records");
+            const records = await loadGenericRecords(recordsDir, exclude, repo.baseUrl, repo.branch);
+            // レコード0件でもタブは出す（空状態から「＋AIで登録」できる導線になる）。
+            // records/ 自体が無いディレクトリ（その区画が未導入の案件）はタブにしない
+            if (records.length || (await isDirectory(recordsDir)))
                 sections.push({ name: e.name, records });
         }
         sections.sort((a, b) => a.name.localeCompare(b.name, "ja"));
@@ -1022,6 +1034,7 @@ async function parseDecision(raw, fileName, repoRelDir, repoBaseUrl, branch) {
         bodyHtml,
         bodyRef: "",
         searchText: toSearchText(content),
+        rstatus: data.status != null ? String(data.status) : "",
         fileName,
         editUrl,
         fm: sanitizeFm(data),

package/dist/render.js

@@ -197,12 +197,45 @@ function buildTutorialData(site, codeUrl, repoSlug) {
             prompt: "直近2週間の主要な動き・論点・未解決事項を、議事録や決定記録を横断してまとめてください。",
         },
     ];
-    // メンバーの自分のレコードを update-member スキルで直す体験（Members セクションがある案件のみ出す）
-    if ((site.sections ?? []).some((s) => s.name === "Members" || s.name === "メンバー")) {
+    // ここから先は「書き込み・外部連携」の体験。案件の構成に無い能力のチャレンジは出さない（表示条件つき）
+    const tools = site.tools ?? {};
+    const internals = site.internalSources ?? [];
+    const externals = site.externalSources ?? [];
+    // メンバーの自分のレコードを直す体験（Members セクションにレコードがある案件のみ出す）
+    if ((site.sections ?? []).some((s) => (s.name === "Members" || s.name === "メンバー") && s.records.length)) {
         specs.push({
             title: "自分の名前を変更してみよう",
             desc: "メンバー一覧の自分のレコードをAIに直してもらう",
-            prompt: "update-member スキルを使って、メンバー一覧の中のあなた自身のレコードの表示名を変更してください（Gold層への書き込みを体験します）。",
+            prompt: TUT_MEMBER_PROMPT,
+        });
+    }
+    // Backlogに記票する体験（課題管理にBacklogを使う案件のみ出す）
+    const usesBacklog = tools["課題管理"] === "backlog" ||
+        internals.some((s) => s.kind === "課題管理" && s.tool === "backlog" && s.enabled !== false);
+    if (usesBacklog) {
+        specs.push({
+            title: "Backlogに記票してみよう",
+            desc: "AIから自分の名義で課題にコメントする",
+            prompt: TUT_BACKLOG_PROMPT,
+        });
+    }
+    // 画面インベントリを読む体験（デザインを同期している案件のみ出す）
+    const usesDesign = (tools["デザイン"] != null && tools["デザイン"] !== "none") ||
+        internals.some((s) => s.kind === "デザイン" && s.enabled !== false);
+    if (usesDesign) {
+        specs.push({
+            title: "デザインを読んでみよう",
+            desc: "画面インベントリから1画面を選んで理解する",
+            prompt: TUT_DESIGN_PROMPT,
+        });
+    }
+    // 完了をSlackに知らせる体験（チャットにSlackを宣言している案件のみ出す。最終チャレンジ）
+    const usesSlack = tools["チャット"] === "slack" || externals.some((s) => s.type === "slack");
+    if (usesSlack) {
+        specs.push({
+            title: "Slackに完了を知らせよう",
+            desc: "チュートリアルの完了を案件のチャンネルに投稿する",
+            prompt: TUT_SLACK_PROMPT,
         });
     }
     return {
@@ -234,6 +267,92 @@ function tutorialChallenge4Prompt(decisions) {
     return (`このプロジェクトの決定「${picked.title}」（${picked.id}）について、なぜこの結論に至ったのか、` +
         "根拠になった会議や課題まで遡って経緯を説明してください。関連する未解決の論点があれば併せて教えてください。");
 }
+/**
+ * 書き込み・外部連携をともなうチャレンジのプロンプト。
+ * リンク先はクラウド実行のセッションでエンジンのスキルがロードされないため、規約・手順を埋め込んで自己完結させる
+ * （AI導線ボタンのプロンプトと同じ方針）。スキルが使える環境ではそちらを優先させる旨を冒頭に添える。
+ */
+const TUT_MEMBER_PROMPT = [
+    "（update-member スキルが使える環境なら、そのスキルの手順を優先してください。使えない場合は以下に従ってください。）",
+    "",
+    "Cortex/Members/records/ にある、わたし自身のメンバーレコードの表示名（title）を変更してください。Gold層へ書き込む練習です。名簿にわたしのレコードが無ければ、新規登録として1ファイル作ってかまいません。",
+    "",
+    "前提:",
+    "- 名簿は更新型です。氏名・所属・役割が変わったら 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の課題に、わたしの名義でコメントを1件投稿してください。Backlogの画面を開かずにAIから記票する練習です。",
+    "",
+    "Backlogのつなぎ方（本人名義で投稿するには Backlog MCP の接続が必要です）:",
+    "- 手元の Claude Code（CLI・デスクトップ）なら /mcp コマンドから backlog を選んで認証する",
+    "- クラウドのセッション（claude.ai/code）なら、セッションのコネクタ設定で 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を報告する",
+    "",
+    "注意:",
+    "- 今回はコメントの追加だけです。課題の削除・クローズ・属性変更はしないでください",
+    "- 売上・単価・工数・人事評価などの内部限定情報は書かないでください（顧客も閲覧します）",
+].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からの同期で上書きされる生成物です。手で編集しないでください",
+].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 を見て判断し、迷ったら確認する",
+    "2. 次の雛形で本文を作る（{名前} は Cortex/Members/records/ にあるわたしのレコードの表記に合わせる）",
+    "",
+    "🎉 {名前} さんが Cortex のチュートリアルを完了しました",
+    "できるようになったこと: Gold層から案件を把握する・自分の情報を更新する・Backlogに記票する・資料を投入する",
+    "使い方の質問はこのチャンネルへどうぞ",
+    "",
+    "3. 投稿先のチャンネルと本文をプレビューして、承認を得る",
+    "4. 承認後に投稿し、投稿したメッセージのリンクを報告する",
+    "",
+    "注意:",
+    "- 売上・単価・工数・人事評価などの内部限定情報は書かないでください",
+].join("\n");
 const CSS = `
 :root {
   --bg: #f6f7f9;
@@ -818,6 +937,24 @@ const CLIENT_JS = `
   function catBadge(cat) {
     return el("span", { class: "badge cat-" + cat, text: cat || "未分類" });
   }
+  // 未確認（status: draft = AI生成・人間未確認）の印。Gold層の4型（決定事項・用語集・メンバー・ルール）共通で、active・status無しには何も出さない
+  function draftBadge(rec) {
+    return rec && rec.rstatus === "draft" ? el("span", { class: "badge draft", text: "AI生成・未確認" }) : null;
+  }
+  // 詳細ページの警告。バッジより強く「そのまま信じないでほしい」と伝える
+  function draftNote(rec) {
+    if (!rec || rec.rstatus !== "draft") return null;
+    return el("div", { class: "draft-note" }, [
+      el("span", { text: "⚠️" }),
+      el("span", { text: "この内容はAIが自動生成したものです（人間未確認）。必ず内容を確認し、適切な内容に直したうえで frontmatter の status を active に変更してください。" }),
+    ]);
+  }
+  // 未確認の絞り込み（フィルタのセレクトの選択肢は draft の1つだけ）
+  function statusLabel(v) { return v === "draft" ? "未確認のみ" : v; }
+  // 未確認が1件も無い一覧では絞り込みを出さない
+  function hasUnverified(items) {
+    return (items || []).some(function (r) { return r.rstatus === "draft"; });
+  }
 
   // ---------- AI導線（Gold層への人間の書き込み口。claude.ai/code へのディープリンク） ----------
   // ヘッダー「AIに聞く」と同じ方式。repoBaseUrl から slug を導出し、プロンプトを入力済みで Claude Code Web を開く。
@@ -835,13 +972,155 @@ const CLIENT_JS = `
     var m = rec.editUrl.match(/\\/edit\\/[^/]+\\/(.+)$/);
     return m ? decodeURIComponent(m[1]) : "";
   }
-  // Gold型（ディレクトリ名）→ 手動更新スキルの対応。決定事項/用語集/メンバー/ルールの4型のみ。
-  // レポート等スキルの無いディレクトリは対象外（ボタンを出さない）。プロンプトは手順を埋め込まずスキル呼び出しの1〜2行にする。
+  // Gold型（ディレクトリ名）→ 書き込みプロンプトの対応。決定事項/用語集/メンバー/ルールの4型のみ。
+  // レポート等スキルの無いディレクトリは対象外（ボタンを出さない）。
+  // リンク先はクラウド実行のセッションでエンジンのスキルがロードされないため、プロンプトには規約を埋め込んで自己完結させる。
+  // スキルが使える環境（手元のCLI・デスクトップ等）ではそちらを優先させる旨を冒頭に添える。
+  function aiHead(skill) {
+    return "（" + skill + " スキルが使える環境なら、そのスキルの手順を優先してください。使えない場合は以下に従ってください。）\\n\\n";
+  }
+  // 4型すべてに付ける共通の規律（承認・重複・安定ID・公開範囲）
+  var AI_COMMON = [
+    "",
+    "",
+    "共通ルール:",
+    "- 書き込む前に、作成・更新する内容を提示して承認を得てください",
+    "- 同じ対象に複数ファイルを作らないよう、既存レコードとの重複を必ず確認してください",
+    "- relations の target にファイルパスは書かず、安定ID（決定ID YYYYMMDD-NNN / term:{代表表記} / rule:{slug} / member:{氏名} / 課題キー / minute:{定例名}:{YYYYMMDD}）で張ってください",
+    "- 売上・単価・工数・人事評価などの内部限定情報は書かないでください（このリポジトリは顧客も閲覧します）",
+  ].join("\\n");
   var GOLD_SKILL = {
-    "Decisions": { skill: "update-decision", noun: "決定", add: "これから伝える決定事項を記録してください（決定の変更は既存記録を書き換えず supersedes で新しい記録として残します）", edit: "の変更を扱ってください（決定の変更は既存記録を書き換えず supersedes で新しい記録として残します）" },
-    "Glossary": { skill: "update-glossary", noun: "用語", add: "これから伝える用語を登録してください", edit: "を修正してください" },
-    "Members": { skill: "update-member", noun: "メンバー", add: "これから伝えるメンバーを登録してください", edit: "を修正してください" },
-    "Rules": { skill: "update-rule", noun: "ルール", add: "これから伝えるルールを登録してください", edit: "を修正してください" },
+    "Decisions": {
+      skill: "update-decision",
+      noun: "決定",
+      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. 確定した決定だけを記録する（検討中・未確定の議論は記録しない）",
+      ].join("\\n"),
+      edit: function (target) {
+        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 のままにする",
+        ].join("\\n");
+      },
+    },
+    "Glossary": {
+      skill: "update-glossary",
+      noun: "用語",
+      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〜数段落で具体的に書く（一般的な意味に加え、この案件で特殊な使われ方があれば補足する）",
+      ].join("\\n"),
+      edit: function (target) {
+        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 のままにする",
+        ].join("\\n");
+      },
+    },
+    "Members": {
+      skill: "update-member",
+      noun: "メンバー",
+      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. 名簿に書くのは氏名・所属・役割・表記揺れだけ。人の評価・人事・単価・工数は書かない",
+      ].join("\\n"),
+      edit: function (target) {
+        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 のままにする",
+        ].join("\\n");
+      },
+    },
+    "Rules": {
+      skill: "update-rule",
+      noun: "ルール",
+      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. 本文は「## 制約」「## 適用範囲」「## 違反するとどうなるか」「## 出典」で構成する",
+      ].join("\\n"),
+      edit: function (target) {
+        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 のままにする",
+        ].join("\\n");
+      },
+    },
   };
   // ディレクトリ名が日本語の案件（用語集 等）でも同じ4型に解決できるよう、表示名（DIR_LABELS）→英語キーの別名も引く
   var GOLD_ALIAS = { "決定事項": "Decisions", "用語集": "Glossary", "メンバー": "Members", "ルール": "Rules" };
@@ -852,7 +1131,7 @@ const CLIENT_JS = `
   function aiAddBar(sectionName) {
     var g = goldSkill(sectionName);
     if (!g) return null;
-    var prompt = g.skill + " スキルを使って、" + g.add + "。";
+    var prompt = aiHead(g.skill) + g.add + AI_COMMON;
     return el("div", { class: "ai-add-bar" }, [
       el("a", { class: "ai-add-btn", href: codeUrl(prompt), target: "_blank", rel: "noopener", text: "＋ AIで登録" }),
     ]);
@@ -865,8 +1144,8 @@ const CLIENT_JS = `
     var target = pathRef
       ? pathRef + " の" + g.noun + "「" + title + "」"
       : "この" + g.noun + "「" + title + "」（" + rec.id + "）";
-    var prompt = g.skill + " スキルを使って、" + target + g.edit + "。";
-    return el("a", { class: "ai-edit-btn", href: codeUrl(prompt), target: "_blank", rel: "noopener", text: "🤖 AIで編集" });
+    var prompt = aiHead(g.skill) + g.edit(target) + AI_COMMON;
+    return el("a", { class: "ai-edit-btn", href: codeUrl(prompt), target: "_blank", rel: "noopener", text: "AIで編集" });
   }
   // 本文HTMLは bodies/<i>.html に外出しされている。詳細表示時にfetchして埋める（キャッシュ・失敗時フォールバック付き）
   var bodyCache = {};
@@ -894,7 +1173,7 @@ const CLIENT_JS = `
     window.scrollTo(0, 0);
   }
 
-  var listState = { tab: DEFAULT_TAB, q: "", category: "", month: "", page: 1 };
+  var listState = { tab: DEFAULT_TAB, q: "", category: "", month: "", status: "", page: 1 };
 
   // 一覧のページネーション（描画コスト対策。1ページあたりの件数）
   var PAGE_SIZE = 30;
@@ -1484,6 +1763,9 @@ const CLIENT_JS = `
       filters.appendChild(buildSelect("すべての期間", SITE.months, listState.month, function (v) { listState.month = v; listState.page = 1; drawCards(); }, monthLabel));
     }
     filters.appendChild(buildSelect("すべてのカテゴリー", SITE.categories, listState.category, function (v) { listState.category = v; listState.page = 1; drawCards(); }));
+    if (hasUnverified(SITE.decisions)) {
+      filters.appendChild(buildSelect("すべての状態", ["draft"], listState.status, function (v) { listState.status = v; listState.page = 1; drawCards(); }, statusLabel));
+    }
     app.appendChild(filters);
 
     var addBarD = aiAddBar("Decisions");
@@ -1511,6 +1793,7 @@ const CLIENT_JS = `
     var items = SITE.decisions.filter(function (d) {
       if (listState.month && d.date.slice(0, 7) !== listState.month) return false;
       if (listState.category && d.category !== listState.category) return false;
+      if (listState.status && d.rstatus !== listState.status) return false;
       if (q) {
         var hay = (d.title + " " + d.summary + " " + d.searchText + " " + d.deciders.join(" ")).toLowerCase();
         if (hay.indexOf(q) === -1) return false;
@@ -1534,6 +1817,7 @@ const CLIENT_JS = `
 
     pg.slice.forEach(function (d) {
       var meta = el("div", { class: "card-meta" }, [
+        draftBadge(d),
         el("span", { class: "mono", text: d.date || "----" }),
         catBadge(d.category),
         el("span", { class: "mono", text: d.id }),
@@ -1566,6 +1850,9 @@ const CLIENT_JS = `
     var search = el("input", { type: "search", placeholder: "キーワード検索" });
     search.value = listState.q;
     filters.appendChild(search);
+    if (hasUnverified(items)) {
+      filters.appendChild(buildSelect("すべての状態", ["draft"], listState.status, function (v) { listState.status = v; listState.page = 1; draw(); }, statusLabel));
+    }
     app.appendChild(filters);
 
     var addBarG = aiAddBar(listState.tab.replace(/^dir:/, ""));
@@ -1577,13 +1864,18 @@ const CLIENT_JS = `
     function draw() {
       var q = listState.q.trim().toLowerCase();
       var shown = items.filter(function (r) {
+        if (listState.status && r.rstatus !== listState.status) return false;
         if (!q) return true;
         return (r.title + " " + r.summary + " " + r.searchText).toLowerCase().indexOf(q) !== -1;
       });
       listWrap.innerHTML = "";
       if (!shown.length) {
         countEl.textContent = "0 / " + items.length + " 件";
-        listWrap.appendChild(el("div", { class: "empty", text: "該当するレコードはありません" }));
+        // レコード0件のセクション（区画はあるがまだ書かれていない）と、絞り込みの結果0件とを言い分ける
+        listWrap.appendChild(el("div", {
+          class: "empty",
+          text: items.length ? "該当するレコードはありません" : "まだ登録されていません",
+        }));
         return;
       }
       var pg = paginate(shown);
@@ -1592,7 +1884,7 @@ const CLIENT_JS = `
         (pg.pages > 1 ? "（" + pg.page + "/" + pg.pages + "ページ）" : "");
       pg.slice.forEach(function (r) {
         var meta = el("div", { class: "card-meta" }, [
-          r.rstatus === "draft" ? el("span", { class: "badge draft", text: "AI生成・未確認" }) : null,
+          draftBadge(r),
           r.date ? el("span", { class: "mono", text: r.date }) : null,
           el("span", { class: "mono", text: r.id }),
         ]);
@@ -1638,7 +1930,7 @@ const CLIENT_JS = `
     app.appendChild(head);
 
     app.appendChild(el("div", { class: "detail-meta" }, [
-      r.rstatus === "draft" ? el("span", { class: "badge draft", text: "AI生成・未確認" }) : null,
+      draftBadge(r),
       r.date ? el("span", { class: "mono", text: r.date }) : null,
       el("span", { class: "mono", text: r.id }),
       r.summary ? el("span", { text: r.summary }) : null,
@@ -1647,12 +1939,8 @@ const CLIENT_JS = `
     var en2 = fmErrorNote(r);
     if (en2) app.appendChild(en2);
 
-    if (r.rstatus === "draft") {
-      app.appendChild(el("div", { class: "draft-note" }, [
-        el("span", { text: "⚠️" }),
-        el("span", { text: "この定義はAIが自動生成したものです（人間未確認）。必ず内容を確認し、適切な定義に置き換えたうえで frontmatter の status を active に変更してください。" }),
-      ]));
-    }
+    var dn2 = draftNote(r);
+    if (dn2) app.appendChild(dn2);
 
     var genBody = el("div", { class: "body" });
     app.appendChild(genBody);
@@ -2295,6 +2583,7 @@ const CLIENT_JS = `
     app.appendChild(head);
 
     var meta = el("div", { class: "detail-meta" }, [
+      draftBadge(d),
       el("span", { class: "mono", text: d.date || "----" }),
       catBadge(d.category),
       el("span", { class: "mono", text: d.id }),
@@ -2304,6 +2593,9 @@ const CLIENT_JS = `
     var en = fmErrorNote(d);
     if (en) app.appendChild(en);
 
+    var dn = draftNote(d);
+    if (dn) app.appendChild(dn);
+
     if (d.summary) {
       app.appendChild(el("div", { class: "section-label", text: "要約" }));
       app.appendChild(el("div", { class: "summary-box", text: d.summary }));

package/package.json

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