product-playbook 1.0.0

package/install.sh

@@ -0,0 +1,418 @@
+#!/usr/bin/env bash
+# The Product Playbook — Install Script
+# https://github.com/kaminoikari/product-playbook
+#
+# Usage:
+#   curl -fsSL https://raw.githubusercontent.com/kaminoikari/product-playbook/main/install.sh | bash
+#   bash install.sh
+#   bash install.sh --lang en
+#   bash install.sh --lang zh-TW
+#   bash install.sh --uninstall
+#   bash install.sh --help
+
+set -euo pipefail
+
+# ─── Colors ───────────────────────────────────────────────────────────────────
+if [ -z "${NO_COLOR:-}" ] && [ -t 1 ]; then
+  RED='\033[0;31m'
+  GREEN='\033[0;32m'
+  YELLOW='\033[0;33m'
+  BLUE='\033[0;34m'
+  BOLD='\033[1m'
+  RESET='\033[0m'
+else
+  RED='' GREEN='' YELLOW='' BLUE='' BOLD='' RESET=''
+fi
+
+# ─── Constants ────────────────────────────────────────────────────────────────
+REPO_URL="https://github.com/kaminoikari/product-playbook.git"
+TMP_DIR="${TMPDIR:-/tmp}/product-playbook-install-$$"
+SKILL_DIR="$HOME/.claude/skills/product-playbook"
+COMMANDS_DIR="$HOME/.claude/commands"
+SUPPORTED_LANGS="en zh-TW ja zh-CN es ko"
+INSTALL_LANG=""
+
+# ─── Language Detection ───────────────────────────────────────────────────────
+detect_language() {
+  # 1. Explicit env var
+  if [ -n "${TPP_LANG:-}" ]; then
+    echo "$TPP_LANG"
+    return
+  fi
+  # 2. System locale
+  local sys_lang="${LANG:-${LC_ALL:-${LC_MESSAGES:-}}}"
+  case "$sys_lang" in
+    zh_TW*|zh_Hant*) echo "zh-TW" ;;
+    zh_CN*|zh_Hans*|zh*) echo "zh-CN" ;;
+    ja*) echo "ja" ;;
+    ko*) echo "ko" ;;
+    es*) echo "es" ;;
+    *)   echo "en" ;;
+  esac
+}
+
+# ─── i18n Messages ────────────────────────────────────────────────────────────
+msg() {
+  local key="$1"
+  case "$INSTALL_LANG" in
+    zh-TW)
+      case "$key" in
+        title)              echo "The Product Playbook — 安裝程式" ;;
+        usage_title)        echo "The Product Playbook — 安裝腳本" ;;
+        usage_install)      echo "安裝或更新" ;;
+        usage_lang)         echo "指定語言 (en, zh-TW)" ;;
+        usage_uninstall)    echo "解除安裝" ;;
+        usage_help)         echo "顯示此訊息" ;;
+        usage_paths)        echo "安裝路徑：" ;;
+        uninstalling)       echo "解除安裝 The Product Playbook..." ;;
+        deleted_dir)        echo "已刪除" ;;
+        dir_not_found)      echo "Skill 目錄不存在，跳過" ;;
+        deleted_cmds)       echo "個 slash command 檔案已刪除" ;;
+        no_cmds)            echo "未找到 product-*.md 指令檔案，跳過" ;;
+        uninstall_done)     echo "解除安裝完成！" ;;
+        git_not_found)      echo "找不到 git，請先安裝 git 後再執行。" ;;
+        local_repo)         echo "偵測到本地 repo，使用本地檔案安裝..." ;;
+        downloading)        echo "從 GitHub 下載最新版本..." ;;
+        version)            echo "版本" ;;
+        up_to_date)         echo "已是最新版本，無需更新。" ;;
+        installed_at)       echo "已安裝：" ;;
+        get_started)        echo "開始使用：" ;;
+        start_claude)       echo "啟動 Claude Code，然後輸入：" ;;
+        example_cmd)        echo "/product-quick 我想做一個記帳 App" ;;
+        old_install)        echo "偵測到舊版安裝，更新中..." ;;
+        installing_skill)   echo "安裝 Skill 檔案..." ;;
+        skill_installed)    echo "Skill 已安裝至" ;;
+        installing_cmds)    echo "安裝 Slash Commands..." ;;
+        cmds_installed)     echo "個 slash commands 已安裝" ;;
+        install_done)       echo "安裝完成！" ;;
+        update_hint)        echo "更新：重新執行本安裝指令即可。" ;;
+        uninstall_hint)     echo "解除安裝：" ;;
+        unknown_arg)        echo "未知參數" ;;
+        lang_label)         echo "語言" ;;
+        invalid_lang)       echo "不支援的語言。支援：" ;;
+      esac
+      ;;
+    *)
+      case "$key" in
+        title)              echo "The Product Playbook — Installer" ;;
+        usage_title)        echo "The Product Playbook — Install Script" ;;
+        usage_install)      echo "Install or update" ;;
+        usage_lang)         echo "Set language (en, zh-TW)" ;;
+        usage_uninstall)    echo "Uninstall" ;;
+        usage_help)         echo "Show this message" ;;
+        usage_paths)        echo "Install paths:" ;;
+        uninstalling)       echo "Uninstalling The Product Playbook..." ;;
+        deleted_dir)        echo "Deleted" ;;
+        dir_not_found)      echo "Skill directory not found, skipping" ;;
+        deleted_cmds)       echo "slash command file(s) deleted" ;;
+        no_cmds)            echo "No product-*.md command files found, skipping" ;;
+        uninstall_done)     echo "Uninstall complete!" ;;
+        git_not_found)      echo "git not found. Please install git first." ;;
+        local_repo)         echo "Local repo detected, installing from local files..." ;;
+        downloading)        echo "Downloading latest version from GitHub..." ;;
+        version)            echo "Version" ;;
+        up_to_date)         echo "Already up to date, no update needed." ;;
+        installed_at)       echo "Installed:" ;;
+        get_started)        echo "Get started:" ;;
+        start_claude)       echo "Launch Claude Code, then type:" ;;
+        example_cmd)        echo "/product-quick I want to build an expense tracking app" ;;
+        old_install)        echo "Previous installation detected, updating..." ;;
+        installing_skill)   echo "Installing Skill files..." ;;
+        skill_installed)    echo "Skill installed to" ;;
+        installing_cmds)    echo "Installing Slash Commands..." ;;
+        cmds_installed)     echo "slash commands installed" ;;
+        install_done)       echo "Installation complete!" ;;
+        update_hint)        echo "Update: re-run this install script." ;;
+        uninstall_hint)     echo "Uninstall:" ;;
+        unknown_arg)        echo "Unknown argument" ;;
+        lang_label)         echo "Language" ;;
+        invalid_lang)       echo "Unsupported language. Supported:" ;;
+      esac
+      ;;
+  esac
+}
+
+# ─── Helpers ──────────────────────────────────────────────────────────────────
+info()  { printf "${BLUE}▸${RESET} %s\n" "$*"; }
+ok()    { printf "${GREEN}✓${RESET} %s\n" "$*"; }
+warn()  { printf "${YELLOW}⚠${RESET} %s\n" "$*"; }
+err()   { printf "${RED}✗${RESET} %s\n" "$*" >&2; }
+
+cleanup() {
+  if [ -d "$TMP_DIR" ]; then
+    rm -rf "$TMP_DIR"
+  fi
+}
+trap cleanup EXIT
+
+usage() {
+  cat <<EOF
+${BOLD}$(msg usage_title)${RESET}
+
+Usage:
+  bash install.sh                  $(msg usage_install)
+  bash install.sh --lang <lang>    $(msg usage_lang)
+  bash install.sh --update         Update to latest version
+  bash install.sh --uninstall      $(msg usage_uninstall)
+  bash install.sh --help           $(msg usage_help)
+
+$(msg usage_paths)
+  Skill      → ~/.claude/skills/product-playbook/
+  Commands   → ~/.claude/commands/product-*.md
+EOF
+}
+
+# ─── Uninstall ────────────────────────────────────────────────────────────────
+do_uninstall() {
+  info "$(msg uninstalling)"
+
+  if [ -d "$SKILL_DIR" ]; then
+    rm -rf "$SKILL_DIR"
+    ok "$(msg deleted_dir) $SKILL_DIR"
+  else
+    warn "$(msg dir_not_found)"
+  fi
+
+  local count=0
+  for f in "$COMMANDS_DIR"/product-*.md; do
+    [ -f "$f" ] || continue
+    rm -f "$f"
+    count=$((count + 1))
+  done
+
+  if [ "$count" -gt 0 ]; then
+    ok "$count $(msg deleted_cmds)"
+  else
+    warn "$(msg no_cmds)"
+  fi
+
+  printf "\n${GREEN}${BOLD}$(msg uninstall_done)${RESET}\n"
+  exit 0
+}
+
+# ─── Install ──────────────────────────────────────────────────────────────────
+do_install() {
+  printf "\n${BOLD}🎯 $(msg title)${RESET}\n"
+  printf "  $(msg lang_label): ${BOLD}$INSTALL_LANG${RESET}\n\n"
+
+  # Check git
+  if ! command -v git &>/dev/null; then
+    err "$(msg git_not_found)"
+    exit 1
+  fi
+
+  # Determine source: local repo or remote clone
+  local src_dir=""
+  local script_dir=""
+  local commit_hash=""
+
+  if [ -f "${BASH_SOURCE[0]:-}" ]; then
+    script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  fi
+
+  if [ -n "$script_dir" ] && [ -d "$script_dir/i18n" ]; then
+    info "$(msg local_repo)"
+    src_dir="$script_dir"
+    commit_hash=$(git -C "$src_dir" rev-parse --short HEAD 2>/dev/null || echo "")
+    if [ -z "$commit_hash" ] && [ -f "$src_dir/package.json" ]; then
+      commit_hash=$(grep '"version"' "$src_dir/package.json" | head -1 | sed 's/.*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
+    fi
+    commit_hash="${commit_hash:-unknown}"
+  elif [ -n "$script_dir" ] && [ -f "$script_dir/SKILL.md" ]; then
+    # Fallback: legacy layout (no i18n directory)
+    info "$(msg local_repo)"
+    src_dir="$script_dir"
+    commit_hash=$(git -C "$src_dir" rev-parse --short HEAD 2>/dev/null || echo "")
+    if [ -z "$commit_hash" ] && [ -f "$src_dir/package.json" ]; then
+      commit_hash=$(grep '"version"' "$src_dir/package.json" | head -1 | sed 's/.*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
+    fi
+    commit_hash="${commit_hash:-unknown}"
+  else
+    info "$(msg downloading)"
+    git clone --depth 1 "$REPO_URL" "$TMP_DIR" 2>/dev/null
+    src_dir="$TMP_DIR"
+    commit_hash=$(git -C "$src_dir" rev-parse --short HEAD 2>/dev/null || echo "unknown")
+    local commit_date
+    commit_date=$(git -C "$src_dir" log -1 --format='%ci' 2>/dev/null | cut -d' ' -f1 || echo "unknown")
+    ok "$(msg version): $commit_hash ($commit_date)"
+  fi
+
+  # Create directories
+  mkdir -p "$SKILL_DIR" "$COMMANDS_DIR"
+
+  # Get current package version (semver)
+  local pkg_version=""
+  if [ -f "$src_dir/package.json" ]; then
+    pkg_version=$(grep '"version"' "$src_dir/package.json" | head -1 | sed 's/.*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
+  fi
+
+  # Version check: skip if already up to date
+  if [ -f "$SKILL_DIR/.version" ]; then
+    local installed_version
+    installed_version=$(cat "$SKILL_DIR/.version")
+    # Detect legacy format (git hash, not semver) — force update
+    if echo "$installed_version" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+$'; then
+      # Semver format — compare with current package version
+      if [ "$installed_version" = "$pkg_version" ] && [ -n "$pkg_version" ]; then
+        ok "$(msg up_to_date) (v$pkg_version)"
+        printf "\n$(msg installed_at)\n"
+        printf "  Skill      → ${BOLD}%s${RESET}\n" "$SKILL_DIR"
+        printf "  Commands   → ${BOLD}%s${RESET}/product-*.md\n" "$COMMANDS_DIR"
+        printf "\n$(msg get_started)\n"
+        printf "  ${BOLD}claude${RESET} $(msg start_claude)\n"
+        printf "  ${BLUE}$(msg example_cmd)${RESET}\n\n"
+        return 0
+      fi
+    else
+      # Legacy format (git hash or unknown) — always update
+      warn "Detected legacy installation (v1.x). Upgrading to v${pkg_version:-latest}..."
+    fi
+  fi
+
+  # Remove old installation
+  if [ -d "$SKILL_DIR" ]; then
+    info "$(msg old_install)"
+    rm -rf "$SKILL_DIR"
+    mkdir -p "$SKILL_DIR"
+  fi
+
+  # Determine default language source paths
+  local default_lang_dir="$src_dir/i18n/$INSTALL_LANG"
+  local has_i18n=false
+
+  if [ -d "$src_dir/i18n" ]; then
+    has_i18n=true
+  fi
+
+  # Copy Skill files
+  info "$(msg installing_skill)"
+  cp "$src_dir/LICENSE" "$SKILL_DIR/"
+
+  if [ "$has_i18n" = true ]; then
+    # Install ALL languages
+    cp -r "$src_dir/i18n" "$SKILL_DIR/"
+    ok "Installed all 6 languages to $SKILL_DIR/i18n/"
+
+    # Set default language: copy SKILL.md, references/, commands/ from default lang
+    if [ -d "$default_lang_dir" ]; then
+      cp "$default_lang_dir/SKILL.md" "$SKILL_DIR/"
+      cp -r "$default_lang_dir/references" "$SKILL_DIR/"
+      cp -r "$default_lang_dir/commands" "$SKILL_DIR/"
+    fi
+  else
+    # Legacy fallback: no i18n directory
+    cp "$src_dir/SKILL.md" "$SKILL_DIR/"
+    [ -d "$src_dir/references" ] && cp -r "$src_dir/references" "$SKILL_DIR/"
+    [ -d "$src_dir/commands" ] && cp -r "$src_dir/commands" "$SKILL_DIR/"
+  fi
+
+  # Write version marker (semver from package.json for npm comparison)
+  local pkg_version=""
+  if [ -f "$src_dir/package.json" ]; then
+    pkg_version=$(grep '"version"' "$src_dir/package.json" | head -1 | sed 's/.*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
+  fi
+  if [ -n "$pkg_version" ]; then
+    echo "$pkg_version" > "$SKILL_DIR/.version"
+  elif [ "$commit_hash" != "unknown" ]; then
+    echo "$commit_hash" > "$SKILL_DIR/.version"
+  fi
+
+  # Write default language marker
+  echo "$INSTALL_LANG" > "$SKILL_DIR/.lang"
+
+  ok "$(msg skill_installed) $SKILL_DIR"
+
+  # Copy slash commands to global commands dir
+  info "$(msg installing_cmds)"
+  local cmds_src="$SKILL_DIR/commands"
+  local cmd_count=0
+  for f in "$cmds_src"/*.md; do
+    [ -f "$f" ] || continue
+    cp "$f" "$COMMANDS_DIR/"
+    cmd_count=$((cmd_count + 1))
+  done
+  ok "$cmd_count $(msg cmds_installed)"
+
+  # Done
+  printf "\n${GREEN}${BOLD}$(msg install_done)${RESET}\n\n"
+  printf "$(msg installed_at)\n"
+  printf "  Skill      → ${BOLD}%s${RESET}\n" "$SKILL_DIR"
+  printf "  Commands   → ${BOLD}%s${RESET}/product-*.md\n" "$COMMANDS_DIR"
+  printf "\n$(msg get_started)\n"
+  printf "  ${BOLD}claude${RESET} $(msg start_claude)\n"
+  printf "  ${BLUE}$(msg example_cmd)${RESET}\n"
+  printf "\n$(msg update_hint)\n"
+  printf "$(msg uninstall_hint) ${YELLOW}bash install.sh --uninstall${RESET}\n\n"
+}
+
+# ─── Main ─────────────────────────────────────────────────────────────────────
+main() {
+  # Parse --lang argument first
+  local args=()
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --lang)
+        if [ -n "${2:-}" ]; then
+          INSTALL_LANG="$2"
+          shift 2
+        else
+          err "$(msg invalid_lang) $SUPPORTED_LANGS"
+          exit 1
+        fi
+        ;;
+      *)
+        args+=("$1")
+        shift
+        ;;
+    esac
+  done
+
+  # Auto-detect default language if not specified
+  if [ -z "$INSTALL_LANG" ]; then
+    INSTALL_LANG=$(detect_language)
+  fi
+
+  # Validate language (fallback to en if unsupported)
+  local valid=false
+  for lang in $SUPPORTED_LANGS; do
+    if [ "$INSTALL_LANG" = "$lang" ]; then
+      valid=true
+      break
+    fi
+  done
+  if [ "$valid" = false ]; then
+    warn "'$INSTALL_LANG' is not supported. Supported: $SUPPORTED_LANGS"
+    warn "Falling back to English (en)."
+    INSTALL_LANG="en"
+  fi
+
+  # Dispatch command
+  case "${args[0]:-}" in
+    --uninstall|-u)
+      do_uninstall
+      ;;
+    --update)
+      # Update: detect installed language, then re-install from remote
+      if [ -f "$SKILL_DIR/.lang" ]; then
+        INSTALL_LANG=$(cat "$SKILL_DIR/.lang")
+      fi
+      # Force re-download by removing version file
+      rm -f "$SKILL_DIR/.version"
+      do_install
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    "")
+      do_install
+      ;;
+    *)
+      err "$(msg unknown_arg): ${args[0]}"
+      usage
+      exit 1
+      ;;
+  esac
+}
+
+main "$@"

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "product-playbook",
+  "version": "1.0.0",
+  "description": "World-class product planning AI skill for Claude Code — 22 PM frameworks, 6 modes, from idea to dev handoff",
+  "bin": {
+    "product-playbook": "./install.sh"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "product",
+    "pm",
+    "skill",
+    "framework",
+    "product-management",
+    "planning"
+  ],
+  "author": "Charles Chen",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kaminoikari/product-playbook.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kaminoikari/product-playbook/issues"
+  },
+  "homepage": "https://github.com/kaminoikari/product-playbook#readme",
+  "files": [
+    "install.sh",
+    "SKILL.md",
+    "commands/",
+    "references/",
+    "i18n/",
+    "README.zh-TW.md",
+    "README.ja.md",
+    "README.zh-CN.md",
+    "README.es.md",
+    "README.ko.md",
+    "LICENSE"
+  ]
+}

package/references/00-opportunity-check.md

@@ -0,0 +1,44 @@
+# 前置：機會評估（Opportunity Check）
+
+> **注意：各模式應執行哪些步驟，以 SKILL.md 中「各模式步驟序列」為權威定義。以下僅供參考。**
+
+**適用於：完整模式、高完整性、產出對象為老闆/高層**
+**可跳過：快速模式、直接實作模式、產出對象為工程師/設計師**
+
+如果使用者是從頭開始做 0-to-1 產品，先通過這五個問題。任何一題答案是「否」都是需要重新思考的訊號：
+
+```
+| # | 評估問題 | 使用者答案 | 評估 |
+|---|----------|-----------|------|
+| 1 | 這是否在解決一個真實且急迫的用戶痛點？第一批受益的客戶是誰？你如何找到他們？ | | ✅/⚠️ |
+| 2 | 你是否有解決這個問題的獨特優勢？目標客戶是否至少每週會用到？市場夠大嗎？ | | ✅/⚠️ |
+| 3 | 以現有資源，能否在 2-3 年內做出可用的產品？ | | ✅/⚠️ |
+| 4 | 競爭格局如何？你能贏嗎？差異化優勢是什麼？ | | ✅/⚠️ |
+| 5 | 是否有可持續的用戶增長和商業化路徑？ | | ✅/⚠️ |
+```
+
+## DHM 初步檢驗（Gibson Biddle / Netflix）
+
+這個機會是否能做到：
+- **D（Delight）**：讓用戶感到驚喜、超出預期？
+- **H（Hard to copy）**：競爭對手難以輕易複製？
+- **M（Margin-enhancing）**：隨著規模增長，邊際利潤能提升？
+
+如果某些市場訊號尚不明確，尋找方向性訊號：
+- 宏觀趨勢（例：AI 普及帶來的工作流程替代機會）
+- 行為轉移（用戶已在用 workaround，代表需求真實存在）
+- 類比市場（找已驗證的相似場景）
+
+## 團隊熱情確認
+
+確認團隊對這個問題空間真的有熱情。缺乏內在驅動力的團隊在尋找 PMF 的路上必然倒下。
+
+---
+
+## 📎 本階段的檔案整合提示
+
+| 上傳內容 | 整合到 | 整合動作 |
+|---------|-------|---------|
+| 市場報告（PDF） | 五個評估問題（#2 市場規模、#4 競爭格局） | 用報告數據替代假設性回答 |
+| 行業分析 / 趨勢報告 | DHM + 方向性訊號 | 提取宏觀趨勢和行為轉移作為 DHM 佐證 |
+| 競品融資/營收資訊 | 五個評估問題（#4、#5） | 評估競爭強度和市場驗證信號 |

package/references/01-strategy.md

@@ -0,0 +1,90 @@
+# 產品策略層
+
+> **注意：各模式應執行哪些步驟，以 SKILL.md 中「各模式步驟序列」為權威定義。以下僅供參考。**
+
+**適用於：完整模式、高完整性、產出對象為老闆/跨部門對齊**
+**可跳過：快速模式、直接實作模式、低完整性**
+
+## Strategy Blocks（Chandra Janakiraman / Headspace / Meta）
+
+好策略的層級結構，從上到下每一層都是下一層的基礎：
+
+```
+Mission（使命）
+  └→ Vision（願景）— 5-10 年後你希望世界變成什麼樣？
+       └→ Strategy（策略）— 你如何達到那個願景？（關鍵選擇和取捨）
+            └→ Goals / OKRs（目標）— 接下來 6-12 個月的優先事項
+                 └→ Roadmap（路線圖）— 具體要做什麼？
+                      └→ Tasks（任務）— 誰做什麼、何時完成？
+```
+
+## Richard Rumelt 的「好策略內核（Kernel of Good Strategy）」
+
+- **診斷（Diagnosis）**：清楚定義你面臨的挑戰（不是所有問題，而是最關鍵的那個）
+- **指導方針（Guiding Policy）**：你的整體應對方向（不是目標，而是方法）
+- **連貫行動（Coherent Actions）**：相互強化的具體行動，而不是各自獨立的計畫
+
+> 壞策略的特徵：只有宏大目標、沒有診斷；用漂亮的措辭掩蓋思維的空洞；把所有計畫都稱為「策略」。
+
+## Shreyas Doshi 的三層次產品工作
+
+在處理任何產品問題時，先確認你在哪個層次工作：
+
+```
+Level 3：Product Excellence（卓越執行）— 把正確的事情做得非常好
+Level 2：Product Strategy（產品策略）— 做正確的事情
+Level 1：Product Foundation（產品根基）— 有能力做事情的基礎（文化、流程、人才）
+```
+
+> 大多數 PM 花太多時間在 Level 3，卻忽略了 Level 2 的問題。大多數所謂的「執行問題」，追根究底都是「策略問題」。
+
+## Shreyas Doshi 的 LNO 時間分配框架
+
+每週的工作項目，先問：這件事對產品的影響屬於哪一類？
+
+```
+L（Leverage，高槓桿）：策略、願景、文化 → 投入充足時間，精益求精
+N（Neutral，中性）：一般協作、普通溝通 → 做好即可，不必追求完美
+O（Overhead，負擔）：行政、會議、文書 → 盡快完成，不要過度投入
+```
+
+> 把節省下來的 O 時間，投入到被忽視的 L 工作中。
+
+## OKR 撰寫指引
+
+Strategy Blocks 中 Goals/OKRs 是策略往下展開的關鍵層。寫好 OKR 的最小規則：
+
+**Objective（目標）**：定性、有激勵性、可理解。描述一個你想達到的狀態，不是一個待辦事項。
+- ✅ 好的 O：「讓新用戶在第一天就感受到產品核心價值」
+- ❌ 壞的 O：「完成 Onboarding 改版」（這是任務不是目標）
+
+**Key Results（關鍵結果）**：定量、可衡量、有時限。描述你如何知道自己達到了目標。
+- ✅ 好的 KR：「新用戶 D1 核心動作完成率從 20% 提升到 40%」
+- ❌ 壞的 KR：「上線新版 Onboarding 流程」（這是 Output 不是 Outcome）
+
+**常見陷阱：**
+- 把任務清單偽裝成 OKR（「完成 X 功能」不是 KR）
+- OKR 太多（每季 2-3 個 Objective，每個 O 下 3-5 個 KR）
+- KR 之間相互矛盾或不相關
+- 只有滯後指標（Lagging），沒有領先指標（Leading）
+
+**範例：**
+```
+O：讓目標用戶愛上我們的產品（PMF Level 2 → Level 3）
+  KR1：D28 留存率從 12% → 20%
+  KR2：Sean Ellis Score 從 28% → 40%
+  KR3：每月自然推薦新增用戶佔比從 10% → 25%
+```
+
+## 產品核心三問（貫穿整個流程）
+
+這三個問題必須依序釐清，**順序不可對調**：
+
+> **Q1：如何吸引顧客進來？（How to get people in the front door?）**
+> **Q2：如何最快讓他們感受到「哇啊！」？（How to reach the Aha Moment?）**
+> **Q3：如何高頻率地傳遞出產品的核心價值？（How to deliver core value repeatedly?）**
+
+在 Define 階段，具體轉化為：
+- **Who is it for?** — 為誰做的？
+- **Why build it?** — 為什麼要做？
+- **What is it?** — 做什麼？

package/references/02a-persona.md

@@ -0,0 +1,57 @@
+# 階段一：Discovery — Persona 建立
+
+## Continuous Discovery 習慣（Teresa Torres）
+
+建立一個關鍵習慣：**每週至少接觸一位目標用戶**。Discovery 不是一次性儀式，而是持續系統。
+
+> 「Product discovery 應該是持續的習慣，而不是專案開始前的一次性儀式。」— Teresa Torres
+
+## 1.1 建立 Persona Table
+
+Persona 不是用年齡性別來分群，而是用「用途 / 任務 / 動機」來區分不同類型的用戶。
+
+```
+| 欄位 | Persona 1: [暱稱] | Persona 2: [暱稱] | Persona 3: [暱稱] |
+|---|---|---|---|
+| 用途 / 任務 / 動機 | | | |
+| 規模（SIZE） | | | |
+| 問題 / 挑戰 / 驅動力 | | | |
+| 現在做法與理由 | | | |
+| 頻率 | | | |
+| 相關資訊來源 | | | |
+| 採用/執行過程的問題 | | | |
+```
+
+說明切分邏輯；檢查是否 MECE（互斥且完整覆蓋）；指出核心 TA 和次要 TA。
+
+### 📝 Persona 品質自檢清單
+- ✅ 切分是否基於「用途/任務/動機」而非人口統計？
+- ✅ 各 Persona 之間是否 MECE（互斥且完整覆蓋目標市場）？
+- ✅ 是否明確指出核心 TA vs 次要 TA？
+- ✅ 每個 Persona 的「問題/挑戰」是否來自真實觀察或合理推論？
+- ✅ 「現在做法與理由」是否具體到可以識別 Workaround？
+- ❌ 常見問題：按年齡性別分群、Persona 之間差異不明顯、痛點太籠統
+
+## 1.2 建立 Persona 卡片
+
+```
+## [Persona 暱稱]：[一句話描述]
+
+**基本資訊**：年齡 / 性別 / 職業 / 所在地 / 個性特質
+**背景**：[與產品相關的背景描述]
+**目標 / 任務**：[目標1]、[目標2]
+**現行做法與理由**：[目前怎麼做、為什麼這樣做]
+**資訊來源**：[從哪裡獲取相關資訊]
+**阻礙 / 問題 / 挑戰 / 不滿意**：[痛點1]、[痛點2]、[痛點3]
+```
+
+---
+
+## 📎 本階段的檔案整合提示
+
+如果使用者在此階段上傳了檔案，Claude 依據以下規則整合：
+
+| 上傳內容 | 整合到 | 整合動作 |
+|---------|-------|---------|
+| 用戶訪談逐字稿 / 錄音文字 | 1.1 Persona + 1.3 JTBD | 提取：用戶背景 → Persona 欄位；痛點 + 現行做法 → JTBD 深挖五問；情緒反應 → 情感性/社交性 Job |
+| 用戶調研報告（PDF） | 1.1 + 1.2 + 1.3 | 提取量化數據（用戶分群比例）填入 Persona 規模；提取質化洞見填入 JTBD |