@takagaki/cortex-decisions-viewer 0.4.33 → 0.4.36

package/dist/build.js

@@ -1022,6 +1022,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,6 +197,47 @@ function buildTutorialData(site, codeUrl, repoSlug) {
             prompt: "直近2週間の主要な動き・論点・未解決事項を、議事録や決定記録を横断してまとめてください。",
         },
     ];
+    // ここから先は「書き込み・外部連携」の体験。案件の構成に無い能力のチャレンジは出さない（表示条件つき）
+    const tools = site.tools ?? {};
+    const internals = site.internalSources ?? [];
+    const externals = site.externalSources ?? [];
+    // メンバーの自分のレコードを直す体験（Members セクションがある案件のみ出す）
+    if ((site.sections ?? []).some((s) => s.name === "Members" || s.name === "メンバー")) {
+        specs.push({
+            title: "自分の名前を変更してみよう",
+            desc: "メンバー一覧の自分のレコードをAIに直してもらう",
+            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 {
         slug: repoSlug,
         challenges: specs.map((s, i) => ({
@@ -226,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;
@@ -457,13 +584,9 @@ a:hover { text-decoration: underline; }
 .badge.cat-インフラ { background: #efe9fb; color: #6d28d9; }
 .badge.cat-ビジネス { background: #fde9ef; color: #be185d; }
 .badge.cat-デザイン { background: #fce7f3; color: #a21caf; }
-.badge.draft { background: #fef3c7; color: #92400e; border: 1px solid #fcd34d; }
 .badge.error { background: #fee2e2; color: #b91c1c; border: 1px solid #fca5a5; }
-.draft-note {
-  display: flex; gap: 8px; align-items: flex-start;
-  background: #fffbeb; border: 1px solid #fcd34d; border-radius: 8px;
-  padding: 10px 14px; margin: 12px 0 4px; font-size: 13.5px; color: #92400e; line-height: 1.7;
-}
+/* 未確認（status: draft = AI生成・人間未確認）の印。ほとんどのレコードが該当しうるため色もアイコンも使わない */
+.unverified { margin-left: 8px; font-size: 11.5px; font-weight: 400; color: var(--muted); white-space: nowrap; }
 .adoption-note {
   display: flex; gap: 8px; align-items: flex-start;
   background: #eff6ff; border: 1px solid #bfdbfe; border-radius: 8px;
@@ -491,6 +614,24 @@ a:hover { text-decoration: underline; }
   box-shadow: var(--shadow); white-space: nowrap;
 }
 .edit-btn:hover { border-color: var(--accent); color: var(--accent); text-decoration: none; }
+/* ---- AI導線ボタン（AIで編集・＋AIで登録。claude.ai/code へのディープリンク・AIアクションはオレンジ系で統一） ---- */
+.ai-edit-btn {
+  -webkit-backdrop-filter: blur(10px) saturate(150%); backdrop-filter: blur(10px) saturate(150%);
+  flex: 0 0 auto; display: inline-flex; align-items: center; gap: 6px;
+  padding: 8px 14px; border: 1px solid rgba(217,119,87,0.55); border-radius: var(--radius);
+  background: rgba(217,119,87,0.1); color: #b45309; font-size: 13.5px; font-weight: 600;
+  box-shadow: var(--shadow); white-space: nowrap;
+}
+.ai-edit-btn:hover { background: rgba(217,119,87,0.18); border-color: rgba(217,119,87,0.85); text-decoration: none; }
+.ai-add-bar { margin-bottom: 16px; }
+.ai-add-btn {
+  display: inline-flex; align-items: center; gap: 6px; padding: 8px 16px; border-radius: 999px;
+  border: 1px solid rgba(255,255,255,0.55); background: rgba(217,119,87,0.82); color: #fff;
+  font-size: 13px; font-weight: 600; white-space: nowrap;
+  -webkit-backdrop-filter: blur(12px) saturate(160%); backdrop-filter: blur(12px) saturate(160%);
+  box-shadow: 0 2px 10px rgba(190,90,60,0.3), inset 0 1px 0 rgba(255,255,255,0.45);
+}
+.ai-add-btn:hover { background: rgba(194,94,63,0.92); text-decoration: none; }
 .section-label { font-size: 12px; font-weight: 700; color: var(--muted); letter-spacing: .04em; text-transform: uppercase; margin: 24px 0 8px; }
 /* ---- はじめに（チュートリアル・Homeタブ下部） ---- */
 .tut-section { margin-top: 34px; padding-top: 22px; border-top: 1px solid var(--border); }
@@ -737,13 +878,19 @@ const CLIENT_JS = `
   // 本文は bodies/<i>.html に外出しされ詳細表示時に fetch されるため、linkify は loadBody 側で適用する
   // （ここで inline bodyHtml に適用すると検索テキストにHTMLが混ざるため適用しない）。
 
+  // Gold層ディレクトリ名（英語）→ タブ・フォルダの表示名（日本語）の辞書。
+  // 辞書に無いディレクトリはディレクトリ名のまま表示する（案件が独自ディレクトリを足しても壊れない）。
+  // 内部の識別子（タブkey・フォルダ状態）は英語ディレクトリ名のまま扱い、表示だけ差し替える。
+  var DIR_LABELS = { Decisions: "決定事項", Glossary: "用語集", Members: "メンバー", Rules: "ルール" };
+  function dirLabel(name) { return DIR_LABELS[name] || name; }
+
   // タブ: ホーム → Decisions → records/ を持つ各ディレクトリ（自動発見）
   // オンボーディングのチュートリアル（5チャレンジ）は独立タブを廃止し、Homeタブ下部に統合した
   var TABS = [];
   if (SITE.home) TABS.push({ key: "home", label: "Home" });
-  TABS.push({ key: "decisions", label: "Decisions", items: SITE.decisions });
+  TABS.push({ key: "decisions", label: dirLabel("Decisions"), items: SITE.decisions });
   (SITE.sections || []).forEach(function (sec) {
-    TABS.push({ key: "dir:" + sec.name, label: sec.name, items: sec.records });
+    TABS.push({ key: "dir:" + sec.name, label: dirLabel(sec.name), items: sec.records });
   });
   if (SITE.graph && SITE.graph.nodes.length > 0) {
     TABS.push({ key: "graph", label: "ナレッジグラフ" });
@@ -786,6 +933,208 @@ const CLIENT_JS = `
   function catBadge(cat) {
     return el("span", { class: "badge cat-" + cat, text: cat || "未分類" });
   }
+  // 未確認（status: draft = AI生成・人間未確認）の印。タイトル脇に小さく添えるだけで、active・status無しには何も出さない
+  function unverifiedMark(rec) {
+    return rec && rec.rstatus === "draft" ? el("span", { class: "unverified", text: "未確認" }) : null;
+  }
+  // 未確認の絞り込み（フィルタのセレクトの選択肢は 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 を開く。
+  var REPO_SLUG = SITE.repoBaseUrl
+    ? SITE.repoBaseUrl.replace(/^https?:\\/\\/github\\.com\\//, "").replace(/\\.git$/, "")
+    : "";
+  function codeUrl(prompt) {
+    return REPO_SLUG
+      ? "https://claude.ai/code?repo=" + REPO_SLUG + "&prompt=" + encodeURIComponent(prompt)
+      : "https://claude.ai/code/";
+  }
+  // editUrl（.../edit/<branch>/<path>）からリポジトリ相対のファイルパスを取り出す（プロンプトで対象を指し示すため）
+  function repoPathOf(rec) {
+    if (!rec || !rec.editUrl) return "";
+    var m = rec.editUrl.match(/\\/edit\\/[^/]+\\/(.+)$/);
+    return m ? decodeURIComponent(m[1]) : "";
+  }
+  // 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: [
+        "これから伝える決定事項を 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" };
+  function goldSkill(sectionName) {
+    return GOLD_SKILL[sectionName] || GOLD_SKILL[GOLD_ALIAS[sectionName]] || null;
+  }
+  // セクション（Gold型）の一覧上部に置く「＋AIで登録」ボタン。スキルの無いディレクトリでは null
+  function aiAddBar(sectionName) {
+    var g = goldSkill(sectionName);
+    if (!g) return null;
+    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で登録" }),
+    ]);
+  }
+  // 各Goldレコードの「AIで編集」ボタン（GitHubで編集の隣）。スキルの無い型では null
+  function aiEditBtn(rec, sectionName, title) {
+    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;
+    return el("a", { class: "ai-edit-btn", href: codeUrl(prompt), target: "_blank", rel: "noopener", text: "AIで編集" });
+  }
   // 本文HTMLは bodies/<i>.html に外出しされている。詳細表示時にfetchして埋める（キャッシュ・失敗時フォールバック付き）
   var bodyCache = {};
   function loadBody(rec, mount) {
@@ -812,7 +1161,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;
@@ -869,11 +1218,14 @@ const CLIENT_JS = `
         btnLabel: "実行履歴を確認 →",
         btnUrl: base ? base + "/actions/workflows/update-decision-log.yml" : null,
       },
-      "dir:用語集": {
-        text: "毎晩の自動走査が新しい用語を draft として直接追加します（update-glossary-auto）。AIが生成した定義は仮のものです。「AI生成・未確認」の用語は必ず内容を確認し、適切な定義に置き換えて status: active にしてください。",
+      "dir:Glossary": {
+        text: "毎晩の自動走査が新しい用語を draft として直接追加します（update-glossary-auto）。AIが生成した定義は仮のものです。「未確認」の用語は内容を確認し、適切な定義に置き換えて status: active にしてください。",
         btnLabel: "実行履歴を確認 →",
         btnUrl: base ? base + "/actions/workflows/update-glossary.yml" : null,
       },
+      "dir:Rules": {
+        text: "案件で継続的に守る制約・ルールの一覧です。AIはここを読んで、違反する提案を避けます。",
+      },
       "graph": {
         text: "決定・用語・レポートと、その根拠になった課題・議事録・資料のつながりを自動でつないだ地図です。点をクリックすると、そのページや実際のシステム（Backlog・GitHub等）に移動できます。",
       },
@@ -881,9 +1233,7 @@ const CLIENT_JS = `
         text: "決定・用語・レポートを起点に、つながり（根拠・出典・リンク）を1列ずつ辿る表示です。行をクリックすると右に次の列が開きます。",
       },
       "dir:レポート": {
-        text: "週次cronが自動生成します（weekly-report）。",
-        btnLabel: "実行履歴を確認 →",
-        btnUrl: base ? base + "/actions/workflows/weekly-report.yml" : null,
+        text: "レポートの生成は終了し、履歴として凍結されています（レポートはSlack配信に一本化されました）。以下は過去に生成されたレコードです。",
       },
     };
     var infoKey = listState.tab === "graph" ? (knowledgeView === "map" ? "graph" : "explorer") : listState.tab;
@@ -938,8 +1288,8 @@ const CLIENT_JS = `
     if (!challenges.length) return; // 最小データ（チュートリアル無し）では出さない
 
     var sec = el("section", { class: "tut-section" });
-    sec.appendChild(el("h2", { class: "tut-section-head", text: "はじめに — このプロジェクトを掴む5ステップ" }));
-    sec.appendChild(el("p", { class: "tut-intro", text: "AIS Viewer と Claude Code を使ってこのプロジェクトを掴むための5ステップです。各ボタンを押すと、質問が入力済みの状態で Claude Code Web が開きます（このリポジトリへのアクセス権が必要です）。" }));
+    sec.appendChild(el("h2", { class: "tut-section-head", text: "はじめに — このプロジェクトを掴む" + challenges.length + "ステップ" }));
+    sec.appendChild(el("p", { class: "tut-intro", text: "AIS Viewer と Claude Code を使ってこのプロジェクトを掴むための" + challenges.length + "ステップです。各ボタンを押すと、質問が入力済みの状態で Claude Code Web が開きます（このリポジトリへのアクセス権が必要です）。" }));
 
     // 進捗ヘッダ（{完了数}/5・バー・全完了で祝福）
     var doneCount = challenges.filter(function (c) { return tutIsDone(c.n); }).length;
@@ -1401,8 +1751,14 @@ 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");
+    if (addBarD) app.appendChild(addBarD);
+
     var listWrap = el("div", { class: "card-list", id: "card-list" });
     app.appendChild(listWrap);
     drawCards();
@@ -1425,6 +1781,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;
@@ -1459,7 +1816,7 @@ const CLIENT_JS = `
       meta.appendChild(traceD);
       var card = el("div", { class: "card" }, [
         meta,
-        el("div", { class: "card-title", text: d.title }),
+        el("div", { class: "card-title", text: d.title }, [unverifiedMark(d)]),
         d.summary ? el("p", { class: "card-summary", text: d.summary }) : null,
       ]);
       card.addEventListener("click", function () { go(d.id); });
@@ -1480,14 +1837,21 @@ 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:/, ""));
+    if (addBarG) app.appendChild(addBarG);
+
     var listWrap = el("div", { class: "card-list" });
     app.appendChild(listWrap);
 
     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;
       });
@@ -1503,7 +1867,6 @@ 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,
           r.date ? el("span", { class: "mono", text: r.date }) : null,
           el("span", { class: "mono", text: r.id }),
         ]);
@@ -1514,7 +1877,7 @@ const CLIENT_JS = `
         meta.appendChild(traceR);
         var card = el("div", { class: "card" }, [
           meta,
-          el("div", { class: "card-title", text: r.title }),
+          el("div", { class: "card-title", text: r.title }, [unverifiedMark(r)]),
           r.summary ? el("p", { class: "card-summary", text: r.summary }) : null,
         ]);
         card.addEventListener("click", function () { go(r.id); });
@@ -1537,17 +1900,18 @@ const CLIENT_JS = `
     app.appendChild(back);
 
     var head = el("div", { class: "detail-head" });
-    head.appendChild(el("div", {}, [ el("h1", { class: "detail-title", text: r.title }) ]));
+    head.appendChild(el("div", {}, [ el("h1", { class: "detail-title", text: r.title }, [unverifiedMark(r)]) ]));
     var traceBtn2 = el("a", { class: "edit-btn", href: "?tab=graph", text: "🕸 つながり" });
     traceBtn2.addEventListener("click", function (ev) { ev.preventDefault(); openExplorerFor(r); });
     head.appendChild(traceBtn2);
     if (r.editUrl) {
       head.appendChild(el("a", { class: "edit-btn", href: r.editUrl, target: "_blank", rel: "noopener", text: "✏️ GitHubで編集" }));
     }
+    var aiEditR = aiEditBtn(r, r._section, r.title);
+    if (aiEditR) head.appendChild(aiEditR);
     app.appendChild(head);
 
     app.appendChild(el("div", { class: "detail-meta" }, [
-      r.rstatus === "draft" ? el("span", { class: "badge draft", text: "AI生成・未確認" }) : null,
       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,
@@ -1556,13 +1920,6 @@ 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 genBody = el("div", { class: "body" });
     app.appendChild(genBody);
     loadBody(r, genBody);
@@ -2191,7 +2548,7 @@ const CLIENT_JS = `
     app.appendChild(back);
 
     var head = el("div", { class: "detail-head" });
-    var headLeft = el("div", {}, [ el("h1", { class: "detail-title", text: d.title }) ]);
+    var headLeft = el("div", {}, [ el("h1", { class: "detail-title", text: d.title }, [unverifiedMark(d)]) ]);
     head.appendChild(headLeft);
     var traceBtn = el("a", { class: "edit-btn", href: "?tab=graph", text: "🕸 つながり" });
     traceBtn.addEventListener("click", function (ev) { ev.preventDefault(); openExplorerFor(d); });
@@ -2199,6 +2556,8 @@ const CLIENT_JS = `
     if (d.editUrl) {
       head.appendChild(el("a", { class: "edit-btn", href: d.editUrl, target: "_blank", rel: "noopener", text: "✏️ GitHubで編集" }));
     }
+    var aiEditD = aiEditBtn(d, "Decisions", d.title);
+    if (aiEditD) head.appendChild(aiEditD);
     app.appendChild(head);
 
     var meta = el("div", { class: "detail-meta" }, [
@@ -2294,7 +2653,7 @@ const CLIENT_JS = `
     // パンくず（フォルダ › レコード › つながり…）
     var crumbs = [];
     if (!q && explorerState.folder) {
-      crumbs.push({ label: explorerState.folder, click: function () { explorerState.path = []; renderList(); } });
+      crumbs.push({ label: dirLabel(explorerState.folder), click: function () { explorerState.path = []; renderList(); } });
     }
     explorerState.path.forEach(function (id, i) {
       crumbs.push({
@@ -2392,7 +2751,7 @@ const CLIENT_JS = `
             return nodeById[id] && recordText(byId[id]).indexOf(q2) !== -1;
           });
           if (!hits.length) return;
-          itemsBox.appendChild(el("div", { class: "mc-group", text: g.name }));
+          itemsBox.appendChild(el("div", { class: "mc-group", text: dirLabel(g.name) }));
           hits.forEach(function (id) { itemsBox.appendChild(makeRecordRow(id)); });
         });
         if (!itemsBox.children.length) itemsBox.appendChild(el("div", { class: "mc-empty", text: "一致なし" }));
@@ -2400,7 +2759,7 @@ const CLIENT_JS = `
         goldGroups.forEach(function (g) {
           var row = el("div", { class: "mc-item mc-folder" + (explorerState.folder === g.name ? " selected" : "") });
           row.appendChild(el("span", { text: "📁" }));
-          row.appendChild(el("span", { class: "mc-label", text: g.name }));
+          row.appendChild(el("span", { class: "mc-label", text: dirLabel(g.name) }));
           row.appendChild(el("span", { class: "mc-count", text: String(g.ids.length) }));
           row.addEventListener("click", function () {
             explorerState.folder = g.name;
@@ -2432,7 +2791,7 @@ const CLIENT_JS = `
       goldGroups.forEach(function (g) { if (g.name === explorerState.folder) g0 = g; });
       if (g0) {
         var colR = el("div", { class: "mc-col" });
-        colR.appendChild(el("div", { class: "mc-col-head" }, [el("span", { text: g0.name + "（" + g0.ids.length + "）" })]));
+        colR.appendChild(el("div", { class: "mc-col-head" }, [el("span", { text: dirLabel(g0.name) + "（" + g0.ids.length + "）" })]));
         g0.ids.forEach(function (id) { if (nodeById[id]) colR.appendChild(makeRecordRow(id)); });
         if (!g0.ids.length) colR.appendChild(el("div", { class: "mc-empty", text: "レコードはまだありません" }));
         cols.appendChild(colR);

package/package.json

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