product-playbook 1.0.3 → 1.0.4

package/.claude-plugin/marketplace.json

@@ -0,0 +1,14 @@
+{
+  "name": "product-playbook",
+  "owner": {
+    "name": "Charles Chen"
+  },
+  "plugins": [
+    {
+      "name": "product-playbook",
+      "description": "World-class product planning AI skill — 22 PM frameworks, 6 modes, multi-language, from idea to dev handoff",
+      "version": "1.0.4",
+      "source": "./."
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "product-playbook",
   "description": "World-class product planning AI skill — 22 PM frameworks, 6 modes, multi-language, from idea to dev handoff",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "author": {
     "name": "Charles Chen"
   },

package/README.es.md

@@ -54,18 +54,18 @@ Quiero construir un producto
 3. Sube toda la carpeta `product-playbook/`
 4. Di "Quiero construir un producto" en una conversación para activar el skill
 
-### Opción 2: Claude Code Plugin (Recomendado)
+### Opción 2: Claude Code Plugin
 
 En Claude Code, ejecuta:
 
 ```
-/install marketplace kaminoikari/product-playbook
-/install product-playbook
+/plugin marketplace add kaminoikari/product-playbook
+/plugin install product-playbook@kaminoikari-product-playbook
 ```
 
-> El primer comando agrega el marketplace (solo una vez). El segundo instala el plugin.
+> El primer comando añade el marketplace (solo una vez). El segundo instala el plugin.
 
-### Opción 3: Skill de Claude Code
+### Opción 3: Skill de Claude Code (Recomendado)
 
 > 💡 Para actualizar: simplemente vuelve a ejecutar el comando de instalación para sobrescribir con la última versión.
 

package/README.ja.md

@@ -54,18 +54,18 @@ The Product Playbookは、ゼロから一まで体系的にプロダクト企画
 3. `product-playbook/`フォルダ全体をアップロード
 4. 会話で「プロダクトを作りたい」と言ってスキルをトリガー
 
-### 方法2：Claude Code Plugin（推奨）
+### 方法2：Claude Code Plugin
 
 Claude Code で以下を実行：
 
 ```
-/install marketplace kaminoikari/product-playbook
-/install product-playbook
+/plugin marketplace add kaminoikari/product-playbook
+/plugin install product-playbook@kaminoikari-product-playbook
 ```
 
-> 最初のコマンドでマーケットプレイスを追加（初回のみ）、2番目でプラグインをインストールします。
+> 最初のコマンドで marketplace を追加（初回のみ）、2番目で plugin をインストールします。
 
-### オプション3：Claude Codeスキル
+### オプション3：Claude Codeスキル（推奨）
 
 > 💡 更新するには：インストールコマンドを再実行するだけで最新バージョンに上書きされます。
 

package/README.ko.md

@@ -54,18 +54,18 @@ The Product Playbook은 제로부터 원까지 제품 기획 전 과정을 체
 3. `product-playbook/` 전체 폴더 업로드
 4. 대화에서 "제품을 만들고 싶어요"라고 말하면 스킬이 트리거됩니다
 
-### 옵션 2: Claude Code Plugin (권장)
+### 옵션 2: Claude Code Plugin
 
 Claude Code에서 실행:
 
 ```
-/install marketplace kaminoikari/product-playbook
-/install product-playbook
+/plugin marketplace add kaminoikari/product-playbook
+/plugin install product-playbook@kaminoikari-product-playbook
 ```
 
-> 첫 번째 명령어로 마켓플레이스를 추가하고(최초 1회), 두 번째로 플러그인을 설치합니다.
+> 첫 번째 명령어로 marketplace를 추가하고(최초 1회), 두 번째로 plugin을 설치합니다.
 
-### 옵션 3: Claude Code 스킬
+### 옵션 3: Claude Code 스킬 (권장)
 
 > 💡 업데이트하려면: 설치 명령을 다시 실행하면 최신 버전으로 덮어쓰기됩니다.
 

package/README.md

@@ -54,18 +54,18 @@ I want to build a product
 3. Upload the entire `product-playbook/` folder
 4. Say "I want to build a product" in a conversation to trigger the skill
 
-### Option 2: Claude Code Plugin (Recommended)
+### Option 2: Claude Code Plugin
 
 In Claude Code, run:
 
 ```
-/install marketplace kaminoikari/product-playbook
-/install product-playbook
+/plugin marketplace add kaminoikari/product-playbook
+/plugin install product-playbook@kaminoikari-product-playbook
 ```
 
 > The first command adds the marketplace (one-time setup). The second installs the plugin.
 
-### Option 3: Claude Code Skill
+### Option 3: Claude Code Skill (Recommended)
 
 > 💡 To update: simply re-run the install command to overwrite with the latest version.
 

package/README.zh-CN.md

@@ -54,18 +54,18 @@ The Product Playbook 是一个 **Claude AI Skill**，能够系统性地引导你
 3. 上传整个 `product-playbook/` 数据夹
 4. 在对话中说「我想做一个产品」即可触发
 
-### 方法二：Claude Code Plugin（推荐）
+### 方法二：Claude Code Plugin
 
 在 Claude Code 中执行：
 
 ```
-/install marketplace kaminoikari/product-playbook
-/install product-playbook
+/plugin marketplace add kaminoikari/product-playbook
+/plugin install product-playbook@kaminoikari-product-playbook
 ```
 
 > 第一行命令添加 marketplace（只需执行一次），第二行安装 plugin。
 
-### 方法三：Claude Code Skill
+### 方法三：Claude Code Skill（推荐）
 
 > 💡 更新方式：重新执行安装指令即可覆盖更新。
 

package/README.zh-TW.md

@@ -54,18 +54,18 @@ The Product Playbook 是一個 **Claude AI Skill**，能夠系統性地引導你
 3. 上傳整個 `product-playbook/` 資料夾
 4. 在對話中說「我想做一個產品」即可觸發
 
-### 方法二：Claude Code Plugin（推薦）
+### 方法二：Claude Code Plugin
 
 在 Claude Code 中執行：
 
 ```
-/install marketplace kaminoikari/product-playbook
-/install product-playbook
+/plugin marketplace add kaminoikari/product-playbook
+/plugin install product-playbook@kaminoikari-product-playbook
 ```
 
 > 第一行指令新增 marketplace（只需執行一次），第二行安裝 plugin。
 
-### 方法三：Claude Code Skill
+### 方法三：Claude Code Skill（推薦）
 
 > 💡 更新方式：重新執行安裝指令即可覆蓋更新。
 

package/commands/product-build.md

@@ -1,13 +1,13 @@
 ---
-description: 直接實作模式 — 問題已知，跳過 Discovery，直接進入解法設計與 MVP 規劃
-argument-hint: <問題描述>
+description: Build Mode — Problem is known, skip Discovery, go straight to solution design and MVP planning
+argument-hint: <problem description>
 ---
 
-觸發 product-playbook skill。
-然後讀取 references/rules-build.md 取得步驟序列。
-執行各步驟時，依 rules-build.md 中的 Reference 載入指示讀取對應的 reference 檔。
+Invoke the product-playbook skill.
+Then read references/rules-build.md for the step sequence.
+When executing each step, load the corresponding reference files as indicated in rules-build.md.
 
-執行模式：⚡ 直接實作模式
-問題描述：$ARGUMENTS
+Execution mode: ⚡ Build Mode
+Problem description: $ARGUMENTS
 
-依照 rules-build.md 的步驟序列（S1 → S7）執行。提醒使用者跳過用戶研究的風險。每步驟顯示進度指示器。
+Follow the step sequence in rules-build.md (S1 → S7). Remind the user of the risks of skipping user research. Display a progress indicator at each step.

package/commands/product-dev.md

@@ -1,21 +1,21 @@
 ---
-description: 產出開發交接包 — 生成 CLAUDE.md + TASKS.md + TICKETS.md + ARCHITECTURE.md + setup.sh，可直接在 Claude Code 中開始開發
+description: Generate Dev Handoff Package — Produces CLAUDE.md + TASKS.md + TICKETS.md + ARCHITECTURE.md + setup.sh, ready to start development in Claude Code
 ---
 
-觸發 product-playbook skill。
-然後依序讀取以下 reference 檔：
-1. `references/07a-handoff-core.md`（CLAUDE.md 模板 + 技術棧確認）
-2. `references/07b-tasks-tickets.md`（TASKS.md + TICKETS.md 模板）
-3. `references/07c-architecture-setup.md`（ARCHITECTURE.md + setup.sh + 使用者引導）
+Invoke the product-playbook skill.
+Then read the following reference files in order:
+1. `references/07a-handoff-core.md` (CLAUDE.md template + tech stack confirmation)
+2. `references/07b-tasks-tickets.md` (TASKS.md + TICKETS.md templates)
+3. `references/07c-architecture-setup.md` (ARCHITECTURE.md + setup.sh + user guidance)
 
-根據目前對話中已完成的產品規劃內容，產出完整的開發交接包：
-1. 確認技術棧（如使用者未指定，根據產品特性推薦）
-2. 產出 CLAUDE.md（Claude Code 專案記憶）
-3. 產出 TASKS.md（功能拆解 + Phase 分期 + 驗收標準）
-4. 產出 TICKETS.md（開票清單）
-5. 產出 docs/ARCHITECTURE.md（目錄結構 + DB Schema + API Endpoints）
-6. 產出 docs/PRD.md + docs/PRODUCT-SPEC.md
-7. 產出 scripts/setup.sh（一鍵初始化）
-8. 顯示 Claude Code 銜接引導
+Based on the product planning content completed in the current conversation, generate the full dev handoff package:
+1. Confirm the tech stack (if not specified by the user, recommend one based on product characteristics)
+2. Generate CLAUDE.md (Claude Code project memory)
+3. Generate TASKS.md (feature breakdown + phased releases + acceptance criteria)
+4. Generate TICKETS.md (ticket list)
+5. Generate docs/ARCHITECTURE.md (directory structure + DB Schema + API Endpoints)
+6. Generate docs/PRD.md + docs/PRODUCT-SPEC.md
+7. Generate scripts/setup.sh (one-click initialization)
+8. Display Claude Code transition guide
 
-如果對話中尚無產品規劃內容，提示使用者先執行產品規劃流程。
+If no product planning content exists in the conversation, prompt the user to run a product planning flow first.

package/commands/product-feature.md

@@ -1,13 +1,13 @@
 ---
-description: 功能擴充模式 — 在既有產品上新增單一功能，4 步精簡流程
-argument-hint: <功能描述>
+description: Feature Extension Mode — Add a single feature to an existing product in 4 streamlined steps
+argument-hint: <feature description>
 ---
 
-觸發 product-playbook skill。
-然後讀取 references/rules-build.md，直接跳到「🔧 Feature Extension Quick Path」段落。
-執行各步驟時，依該段落中的 Reference 載入指示讀取對應的 reference 檔。
+Invoke the product-playbook skill.
+Then read references/rules-build.md and jump directly to the "🔧 Feature Extension Quick Path" section.
+When executing each step, load the corresponding reference files as indicated.
 
-執行模式：🔧 功能擴充模式
-功能描述：$ARGUMENTS
+Execution mode: 🔧 Feature Extension Mode
+Feature description: $ARGUMENTS
 
-依照 Feature Extension 步驟序列（S1 → S4）執行。先依 rules-context.md 載入產品上下文。每步驟顯示進度指示器。
+Follow the Feature Extension step sequence (S1 → S4). Load product context first per rules-context.md. Display a progress indicator at each step.

package/commands/product-full.md

@@ -1,13 +1,13 @@
 ---
-description: 完整模式產品規劃 — 20 步完整跑過所有框架，產出可交付企劃文件
-argument-hint: <產品描述>
+description: Full Mode Product Planning — Run through all 20 steps across every framework, producing deliverable planning documents
+argument-hint: <product description>
 ---
 
-觸發 product-playbook skill。
-然後讀取 references/rules-full.md 取得步驟序列。
-執行各步驟時，依 rules-full.md 中的 Reference 載入指示讀取對應的 reference 檔。
+Invoke the product-playbook skill.
+Then read references/rules-full.md for the step sequence.
+When executing each step, load the corresponding reference files as indicated in rules-full.md.
 
-執行模式：📦 完整模式
-產品描述：$ARGUMENTS
+Execution mode: Full Mode
+Product description: $ARGUMENTS
 
-依照 rules-full.md 的步驟序列（S1 → S20）執行。先確認產品類型（B2B/B2C）和產出對象，然後開始第一步。每步驟顯示進度指示器。
+Follow the step sequence in rules-full.md (S1 → S20). First confirm the product type (B2B/B2C) and target audience, then begin the first step. Display a progress indicator at each step.

package/commands/product-prd.md

@@ -1,14 +1,14 @@
 ---
-description: 產出 PRD 工程師交付包 — 整合 PR-FAQ + MVP + User Story + Pre-mortem，含流程圖、DB Schema、UI Wireframe
+description: Generate PRD Engineering Package — Integrates PR-FAQ + MVP + User Story + Pre-mortem, including flowcharts, DB Schema, and UI Wireframes
 ---
 
-觸發 product-playbook skill。
-然後讀取 references/04b-solutions.md（含 PRD 模板 + 流程圖/DB Schema/UI Wireframe 規格）。
+Invoke the product-playbook skill.
+Then read references/04b-solutions.md (contains PRD template + flowchart/DB Schema/UI Wireframe specs).
 
-根據目前對話中已完成的產品規劃內容，產出完整的 PRD 工程師交付包：
-1. PRD 文件（背景目標 + 功能範圍 + User Story + 功能規格 + 技術考量 + 風險 + 里程碑）
-2. 流程圖（Mermaid flowchart）
-3. DB Schema（Mermaid erDiagram）
-4. UI Wireframe（HTML 低保真線框圖）
+Based on the product planning content completed in the current conversation, generate the full PRD engineering package:
+1. PRD document (background & goals + feature scope + User Stories + feature specs + technical considerations + risks + milestones)
+2. Flowchart (Mermaid flowchart)
+3. DB Schema (Mermaid erDiagram)
+4. UI Wireframe (HTML low-fidelity wireframe)
 
-如果對話中尚無產品規劃內容，提示使用者先執行產品規劃流程。
+If no product planning content exists in the conversation, prompt the user to run a product planning flow first.

package/commands/product-quick.md

@@ -1,13 +1,13 @@
 ---
-description: 快速模式產品規劃 — 30 分鐘內跑完 JTBD → PR-FAQ → North Star，產出一頁式方向摘要
-argument-hint: <產品描述>
+description: Quick Mode Product Planning — Run through JTBD → PR-FAQ → North Star in under 30 minutes, producing a one-page direction summary
+argument-hint: <product description>
 ---
 
-觸發 product-playbook skill。
-然後讀取 references/rules-quick.md 取得步驟序列。
-執行各步驟時，依 rules-quick.md 中的 Reference 載入指示讀取對應的 reference 檔。
+Invoke the product-playbook skill.
+Then read references/rules-quick.md for the step sequence.
+When executing each step, load the corresponding reference files as indicated in rules-quick.md.
 
-執行模式：🚀 快速模式
-產品描述：$ARGUMENTS
+Execution mode: Quick Mode
+Product description: $ARGUMENTS
 
-直接開始，不需要再確認模式。依照 rules-quick.md 的步驟序列（S1 → S2 → S3）執行，每步驟顯示進度指示器。
+Start immediately without confirming the mode. Follow the step sequence in rules-quick.md (S1 → S2 → S3), displaying a progress indicator at each step.

package/commands/product-report.md

@@ -1,12 +1,12 @@
 ---
-description: 產出 HTML 企劃報告 — 將所有產品規劃內容整合為單一可離線閱讀的 HTML 報告
+description: Generate HTML Planning Report — Compile all product planning content into a single offline-readable HTML report
 ---
 
-觸發 product-playbook skill 及讀取 references/06-html-report.md。
+Invoke the product-playbook skill. Then read references/06-html-report.md.
 
-根據目前對話中已完成的產品規劃內容，依照 06-html-report.md 的設計規範產出完整的 HTML 企劃報告：
-- 單一 HTML 檔案（CSS + JS 內嵌，Google Fonts CDN 載入 Noto Sans TC）
-- 依已完成的階段動態呈現，未完成的階段直接跳過
-- 包含 Sticky 目錄導航、卡片式排版、互動效果
+Based on the product planning content completed in the current conversation, generate a full HTML planning report following the design specs in 06-html-report.md:
+- Single HTML file (CSS + JS inline, Google Fonts CDN loading Noto Sans TC)
+- Dynamically render completed stages; skip any stages not yet completed
+- Include sticky table-of-contents navigation, card-based layout, and interactive effects
 
-如果對話中尚無產品規劃內容，提示使用者先執行產品規劃流程。
+If no product planning content exists in the conversation, prompt the user to run a product planning flow first.

package/commands/product-revision.md

@@ -1,13 +1,13 @@
 ---
-description: 改版模式產品規劃 — 針對既有產品改版優化，有用戶數據和功能基礎
-argument-hint: <產品名稱與改版目標>
+description: Revision Mode Product Planning — Optimize and iterate on an existing product, leveraging user data and feature foundations
+argument-hint: <product name and revision goals>
 ---
 
-觸發 product-playbook skill。
-然後讀取 references/rules-revision.md 取得步驟序列。
-執行各步驟時，依 rules-revision.md 中的 Reference 載入指示讀取對應的 reference 檔。
+Invoke the product-playbook skill.
+Then read references/rules-revision.md for the step sequence.
+When executing each step, load the corresponding reference files as indicated in rules-revision.md.
 
-執行模式：🔄 改版模式
-產品描述：$ARGUMENTS
+Execution mode: Revision Mode
+Product description: $ARGUMENTS
 
-依照 rules-revision.md 的步驟序列（S1 → S12）執行。S1 會主動詢問既有產品數據（DAU/MAU、留存率、主要用戶反饋等）。每步驟顯示進度指示器。
+Follow the step sequence in rules-revision.md (S1 → S12). S1 will proactively ask about existing product metrics (DAU/MAU, retention rate, key user feedback, etc.). Display a progress indicator at each step.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "product-playbook",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "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"