product-playbook 1.2.1 → 1.2.2

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
     {
       "name": "product-playbook",
       "description": "MUST use when user wants to plan or strategize a product/feature. 22 PM frameworks, 6 modes, multi-language, from idea to dev handoff",
-      "version": "1.2.1",
+      "version": "1.2.2",
       "source": "./."
     }
   ]

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "product-playbook",
   "description": "MUST use when user wants to plan or strategize a product/feature. 22 PM frameworks, 6 modes, multi-language, from idea to dev handoff",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "author": {
     "name": "Charles Chen"
   },

package/commands/product-dev.md

@@ -10,7 +10,7 @@ Then read the following reference files in order:
 
 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. Create the `.product-dev-active` marker file at the project root (empty file). This signals the plugin's PreToolUse hook that the project has officially entered the dev-handoff phase, so subsequent source-code writes are no longer gated.
+2. Create the `.product-dev-active` marker file at the project root (empty file), and add `.product-dev-active` to the project's `.gitignore` (create the file if absent, or append the entry if missing — do not duplicate). This signals the plugin's PreToolUse hook that the project has officially entered the dev-handoff phase, so subsequent source-code writes are no longer gated.
 3. Generate CLAUDE.md (Claude Code project memory)
 4. Generate TASKS.md (feature breakdown + phased releases + acceptance criteria)
 5. Generate TICKETS.md (ticket list)
@@ -21,4 +21,4 @@ Based on the product planning content completed in the current conversation, gen
 
 If no product planning content exists in the conversation, prompt the user to run a product planning flow first.
 
-Note: `.product-dev-active` is a session-local marker (gitignored by the plugin). Delete it if the project ever returns to planning-only mode.
+Note: `.product-dev-active` is a session-local marker and must not be committed — step 2 ensures it's listed in the project's own `.gitignore`. Delete the marker if the project ever returns to planning-only mode.

package/i18n/en/commands/product-dev.md

@@ -10,7 +10,7 @@ Then read the following reference files in order:
 
 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. Create the `.product-dev-active` marker file at the project root (empty file). This signals the plugin's PreToolUse hook that the project has officially entered the dev-handoff phase, so subsequent source-code writes are no longer gated.
+2. Create the `.product-dev-active` marker file at the project root (empty file), and add `.product-dev-active` to the project's `.gitignore` (create the file if absent, or append the entry if missing — do not duplicate). This signals the plugin's PreToolUse hook that the project has officially entered the dev-handoff phase, so subsequent source-code writes are no longer gated.
 3. Generate CLAUDE.md (Claude Code project memory)
 4. Generate TASKS.md (feature breakdown + phased releases + acceptance criteria)
 5. Generate TICKETS.md (ticket list)
@@ -21,4 +21,4 @@ Based on the product planning content completed in the current conversation, gen
 
 If no product planning content exists in the conversation, prompt the user to run a product planning flow first.
 
-Note: `.product-dev-active` is a session-local marker (gitignored by the plugin). Delete it if the project ever returns to planning-only mode.
+Note: `.product-dev-active` is a session-local marker and must not be committed — step 2 ensures it's listed in the project's own `.gitignore`. Delete the marker if the project ever returns to planning-only mode.

package/i18n/en/references/07b-tasks-tickets.md

@@ -17,7 +17,7 @@ Core principles for feature breakdown:
 - [ ] **T0.1** Initialize project (`scripts/setup.sh` or manual)
   - Acceptance:
     - [ ] `npm run dev` / `python manage.py runserver` or equivalent command starts successfully
-    - [ ] `.gitignore` created, includes `.env`, `.env.local`, `node_modules/`, `.product-playbook-progress.md`, and other sensitive files
+    - [ ] `.gitignore` created, includes `.env`, `.env.local`, `node_modules/`, `.product-playbook-progress.md`, `.product-dev-active`, and other sensitive files
     - [ ] `.env.example` created (key names only, no actual values)
 - [ ] **T0.2** Set up linter + formatter
   - Acceptance: lint passes with no errors

package/i18n/en/references/07c-architecture-setup.md

@@ -90,6 +90,8 @@
 
 # Product planning progress (may contain sensitive business information)
 .product-playbook-progress.md
+# Product-playbook dev-handoff marker (session-local; do not commit)
+.product-dev-active
 
 # IDE and OS
 .idea/

package/i18n/es/commands/product-dev.md

@@ -10,7 +10,7 @@ Luego lee los siguientes archivos de referencia en orden:
 
 Basándote en el contenido de planificación de producto completado en la conversación actual, genera el paquete completo de handoff de desarrollo:
 1. Confirma el stack tecnológico (si no fue especificado por el usuario, recomienda uno basado en las características del producto)
-2. Crea el archivo marcador `.product-dev-active` en la raíz del proyecto (archivo vacío). Esto le indica al hook PreToolUse del plugin que el proyecto ha entrado oficialmente en la fase de handoff de desarrollo, por lo que las siguientes escrituras de código fuente ya no serán filtradas por el hook.
+2. Crea el archivo marcador `.product-dev-active` en la raíz del proyecto (archivo vacío) y añade `.product-dev-active` al `.gitignore` del proyecto (crea el archivo si no existe, o añade la entrada si falta — sin duplicar). Esto le indica al hook PreToolUse del plugin que el proyecto ha entrado oficialmente en la fase de handoff de desarrollo, por lo que las siguientes escrituras de código fuente ya no serán filtradas por el hook.
 3. Genera CLAUDE.md (memoria de proyecto de Claude Code)
 4. Genera TASKS.md (desglose de funcionalidades + releases por fases + criterios de aceptación)
 5. Genera TICKETS.md (lista de tickets)
@@ -21,4 +21,4 @@ Basándote en el contenido de planificación de producto completado en la conver
 
 Si no existe contenido de planificación de producto en la conversación, solicita al usuario que ejecute un flujo de planificación de producto primero.
 
-Nota: `.product-dev-active` es un marcador session-local (excluido por el .gitignore del plugin). Elimínalo si el proyecto vuelve al modo de solo planificación.
+Nota: `.product-dev-active` es un marcador session-local y no debe ser commiteado — el paso 2 asegura que esté listado en el `.gitignore` del propio proyecto. Elimina el marcador si el proyecto vuelve al modo de solo planificación.

package/i18n/es/references/07b-tasks-tickets.md

@@ -17,7 +17,7 @@ Principios fundamentales para desglose de funcionalidades:
 - [ ] **T0.1** Inicializar proyecto (`scripts/setup.sh` o manual)
   - Aceptación:
     - [ ] `npm run dev` / `python manage.py runserver` o comando equivalente inicia exitosamente
-    - [ ] `.gitignore` creado, incluye `.env`, `.env.local`, `node_modules/`, `.product-playbook-progress.md`, y otros archivos sensibles
+    - [ ] `.gitignore` creado, incluye `.env`, `.env.local`, `node_modules/`, `.product-playbook-progress.md`, `.product-dev-active`, y otros archivos sensibles
     - [ ] `.env.example` creado (solo nombres de claves, sin valores reales)
 - [ ] **T0.2** Configurar linter + formatter
   - Aceptación: lint pasa sin errores

package/i18n/es/references/07c-architecture-setup.md

@@ -90,6 +90,8 @@
 
 # Progreso de planificación de producto (puede contener información de negocio sensible)
 .product-playbook-progress.md
+# Marcador de handoff de desarrollo de Product-playbook (session-local; no commitear)
+.product-dev-active
 
 # IDE y OS
 .idea/

package/i18n/ja/commands/product-dev.md

@@ -10,7 +10,7 @@ product-playbook skill を起動してください。
 
 現在の会話で完成したプロダクト企画内容に基づいて、完全な開発ハンドオフパッケージを生成します：
 1. 技術スタックの確認（ユーザーが指定していない場合、プロダクト特性に基づいて推奨）
-2. プロジェクトルートに `.product-dev-active` マーカーファイル（空ファイル）を作成します。これによりプラグインの PreToolUse hook へ「プロジェクトが正式に開発ハンドオフフェーズへ移行した」と伝え、以降のソースコード書き込みは hook によるリマインドの対象外となります。
+2. プロジェクトルートに `.product-dev-active` マーカーファイル（空ファイル）を作成し、`.product-dev-active` をプロジェクトの `.gitignore` に追記します（`.gitignore` が無ければ新規作成、有ればエントリを追記。重複追加はしない）。これによりプラグインの PreToolUse hook へ「プロジェクトが正式に開発ハンドオフフェーズへ移行した」と伝え、以降のソースコード書き込みは hook によるリマインドの対象外となります。
 3. CLAUDE.md を生成（Claude Codeプロジェクトメモリ）
 4. TASKS.md を生成（機能分解 + フェーズリリース + 受入基準）
 5. TICKETS.md を生成（チケットリスト）
@@ -21,4 +21,4 @@ product-playbook skill を起動してください。
 
 会話にプロダクト企画内容がない場合は、まずプロダクト企画フローを実行するよう促してください。
 
-注：`.product-dev-active` は session-local なマーカーです（プラグインの .gitignore で除外済み）。プロジェクトが純粋な企画モードへ戻る場合はこのファイルを削除してください。
+注：`.product-dev-active` は session-local なマーカーで、commit してはいけません — ステップ 2 でプロジェクト自身の `.gitignore` に登録済みです。プロジェクトが純粋な企画モードへ戻る場合はこのマーカーファイルを削除してください。

package/i18n/ja/references/07b-tasks-tickets.md

@@ -17,7 +17,7 @@
 - [ ] **T0.1** プロジェクト初期化（`scripts/setup.sh`またはマニュアル）
   - 受入基準：
     - [ ] `npm run dev` / `python manage.py runserver`または同等のコマンドが正常に起動
-    - [ ] `.gitignore`が作成され、`.env`、`.env.local`、`node_modules/`、`.product-playbook-progress.md`、その他の機密ファイルを含む
+    - [ ] `.gitignore`が作成され、`.env`、`.env.local`、`node_modules/`、`.product-playbook-progress.md`、`.product-dev-active`、その他の機密ファイルを含む
     - [ ] `.env.example`が作成（キー名のみ、実際の値なし）
 - [ ] **T0.2** Linter + Formatterの設定
   - 受入基準：lintがエラーなしでパス

package/i18n/ja/references/07c-architecture-setup.md

@@ -90,6 +90,8 @@
 
 # プロダクト企画進捗（機密ビジネス情報を含む可能性あり）
 .product-playbook-progress.md
+# Product-playbook 開発ハンドオフマーカー（session-local；commit 禁止）
+.product-dev-active
 
 # IDEとOS
 .idea/

package/i18n/ko/commands/product-dev.md

@@ -10,7 +10,7 @@ product-playbook skill을 실행합니다.
 
 현재 대화에서 완료된 제품 기획 내용을 기반으로 전체 개발 핸드오프 패키지를 생성하세요:
 1. 기술 스택 확인 (사용자가 지정하지 않은 경우 제품 특성에 맞는 추천)
-2. 프로젝트 루트에 `.product-dev-active` 마커 파일(빈 파일)을 생성합니다. 이 파일은 플러그인의 PreToolUse hook에 "프로젝트가 정식으로 개발 핸드오프 단계에 진입했음"을 알리며, 이후 소스 코드 쓰기에 대한 hook 리마인더가 비활성화됩니다.
+2. 프로젝트 루트에 `.product-dev-active` 마커 파일(빈 파일)을 생성하고, `.product-dev-active`를 프로젝트의 `.gitignore`에 추가합니다 (`.gitignore`가 없으면 새로 생성, 있으면 항목을 append; 중복 추가 금지). 이 파일은 플러그인의 PreToolUse hook에 "프로젝트가 정식으로 개발 핸드오프 단계에 진입했음"을 알리며, 이후 소스 코드 쓰기에 대한 hook 리마인더가 비활성화됩니다.
 3. CLAUDE.md 생성 (Claude Code 프로젝트 메모리)
 4. TASKS.md 생성 (기능 분해 + 단계별 릴리스 + 인수 기준)
 5. TICKETS.md 생성 (티켓 목록)
@@ -21,4 +21,4 @@ product-playbook skill을 실행합니다.
 
 대화에 제품 기획 내용이 없는 경우, 제품 기획 플로우를 먼저 실행하도록 안내하세요.
 
-참고: `.product-dev-active`는 session-local 마커입니다 (플러그인의 .gitignore로 제외됨). 프로젝트가 다시 순수 기획 모드로 돌아갈 경우 이 파일을 삭제하면 됩니다.
+참고: `.product-dev-active`는 session-local 마커이며 commit해서는 안 됩니다 — 단계 2에서 프로젝트 자체의 `.gitignore`에 등록되었습니다. 프로젝트가 다시 순수 기획 모드로 돌아갈 경우 이 마커 파일을 삭제하면 됩니다.

package/i18n/ko/references/07b-tasks-tickets.md

@@ -17,7 +17,7 @@
 - [ ] **T0.1** 프로젝트 초기화 (`scripts/setup.sh` 또는 수동)
   - 인수:
     - [ ] `npm run dev` / `python manage.py runserver` 또는 동등 명령이 성공적으로 시작됨
-    - [ ] `.gitignore` 생성됨, `.env`, `.env.local`, `node_modules/`, `.product-playbook-progress.md` 등 민감 파일 포함
+    - [ ] `.gitignore` 생성됨, `.env`, `.env.local`, `node_modules/`, `.product-playbook-progress.md`, `.product-dev-active` 등 민감 파일 포함
     - [ ] `.env.example` 생성됨 (키 이름만, 실제 값 없음)
 - [ ] **T0.2** 린터 + 포매터 설정
   - 인수: lint가 에러 없이 통과

package/i18n/ko/references/07c-architecture-setup.md

@@ -90,6 +90,8 @@
 
 # 제품 기획 진행 상황 (민감한 비즈니스 정보 포함 가능)
 .product-playbook-progress.md
+# Product-playbook 개발 핸드오프 마커 (session-local; commit 금지)
+.product-dev-active
 
 # IDE 및 OS
 .idea/

package/i18n/zh-CN/commands/product-dev.md

@@ -10,7 +10,7 @@ description: 产出开发交接包 — 生成 CLAUDE.md + TASKS.md + TICKETS.md
 
 根据目前对话中已完成的产品规划内容，产出完整的开发交接包：
 1. 确认技术栈（如使用者未指定，根据产品特性推荐）
-2. 在专案根目录建立 `.product-dev-active` 标记文件（空文件即可）。此文件向 plugin 的 PreToolUse hook 宣告专案已正式进入开发交接阶段，后续写入源代码不再被 hook 拦截提醒。
+2. 在专案根目录建立 `.product-dev-active` 标记文件（空文件即可），并将 `.product-dev-active` 写入专案的 `.gitignore`（文件不存在就新建，已存在就 append；不要重复加）。此文件向 plugin 的 PreToolUse hook 宣告专案已正式进入开发交接阶段，后续写入源代码不再被 hook 拦截提醒。
 3. 产出 CLAUDE.md（Claude Code 专案记忆）
 4. 产出 TASKS.md（功能拆解 + Phase 分期 + 验收标准）
 5. 产出 TICKETS.md（开票清单）
@@ -21,4 +21,4 @@ description: 产出开发交接包 — 生成 CLAUDE.md + TASKS.md + TICKETS.md
 
 如果对话中尚无产品规划内容，提示使用者先执行产品规划流程。
 
-注：`.product-dev-active` 为 session-local 标记（已由 plugin 的 .gitignore 排除）。若专案未来回到纯规划模式，删除此文件即可。
+注：`.product-dev-active` 为 session-local 标记，不应被 commit — 步骤 2 已确保它列入专案自身的 `.gitignore`。若专案未来回到纯规划模式，删除此标记文件即可。

package/i18n/zh-CN/references/07b-tasks-tickets.md

@@ -17,7 +17,7 @@
 - [ ] **T0.1** 初始化专案（`scripts/setup.sh` 或手动）
   - 验收：
     - [ ] `npm run dev` / `python manage.py runserver` 等指令可启动
-    - [ ] `.gitignore` 已建立，包含 `.env`、`.env.local`、`node_modules/`、`.product-playbook-progress.md` 等敏感文件
+    - [ ] `.gitignore` 已建立，包含 `.env`、`.env.local`、`node_modules/`、`.product-playbook-progress.md`、`.product-dev-active` 等敏感文件
     - [ ] `.env.example` 已建立（只有 key 名称，没有实际值）
 - [ ] **T0.2** 设定 linter + formatter
   - 验收：lint 通过无错误

package/i18n/zh-CN/references/07c-architecture-setup.md

@@ -90,6 +90,8 @@
 
 # 产品规划进度（可能包含敏感商业资讯）
 .product-playbook-progress.md
+# Product-playbook 开发交接标记（session-local，请勿 commit）
+.product-dev-active
 
 # IDE 与作业系统
 .idea/

package/i18n/zh-TW/commands/product-dev.md

@@ -10,7 +10,7 @@ description: 產出開發交接包 — 生成 CLAUDE.md + TASKS.md + TICKETS.md
 
 根據目前對話中已完成的產品規劃內容，產出完整的開發交接包：
 1. 確認技術棧（如使用者未指定，根據產品特性推薦）
-2. 在專案根目錄建立 `.product-dev-active` 標記檔（空檔即可）。此檔向 plugin 的 PreToolUse hook 宣告專案已正式進入開發交接階段，後續寫入原始碼不再被 hook 攔截提醒。
+2. 在專案根目錄建立 `.product-dev-active` 標記檔（空檔即可），並將 `.product-dev-active` 寫入專案的 `.gitignore`（檔案不存在就新建，已存在就 append；不要重複加）。此檔向 plugin 的 PreToolUse hook 宣告專案已正式進入開發交接階段，後續寫入原始碼不再被 hook 攔截提醒。
 3. 產出 CLAUDE.md（Claude Code 專案記憶）
 4. 產出 TASKS.md（功能拆解 + Phase 分期 + 驗收標準）
 5. 產出 TICKETS.md（開票清單）
@@ -21,4 +21,4 @@ description: 產出開發交接包 — 生成 CLAUDE.md + TASKS.md + TICKETS.md
 
 如果對話中尚無產品規劃內容，提示使用者先執行產品規劃流程。
 
-註：`.product-dev-active` 為 session-local 標記（已由 plugin 的 .gitignore 排除）。若專案未來回到純規劃模式，刪除此檔即可。
+註：`.product-dev-active` 為 session-local 標記，不應被 commit — 步驟 2 已確保它列入專案自身的 `.gitignore`。若專案未來回到純規劃模式，刪除此標記檔即可。

package/i18n/zh-TW/references/07b-tasks-tickets.md

@@ -17,7 +17,7 @@
 - [ ] **T0.1** 初始化專案（`scripts/setup.sh` 或手動）
   - 驗收：
     - [ ] `npm run dev` / `python manage.py runserver` 等指令可啟動
-    - [ ] `.gitignore` 已建立，包含 `.env`、`.env.local`、`node_modules/`、`.product-playbook-progress.md` 等敏感檔案
+    - [ ] `.gitignore` 已建立，包含 `.env`、`.env.local`、`node_modules/`、`.product-playbook-progress.md`、`.product-dev-active` 等敏感檔案
     - [ ] `.env.example` 已建立（只有 key 名稱，沒有實際值）
 - [ ] **T0.2** 設定 linter + formatter
   - 驗收：lint 通過無錯誤

package/i18n/zh-TW/references/07c-architecture-setup.md

@@ -90,6 +90,8 @@
 
 # 產品規劃進度（可能包含敏感商業資訊）
 .product-playbook-progress.md
+# Product-playbook 開發交接標記（session-local，請勿 commit）
+.product-dev-active
 
 # IDE 與作業系統
 .idea/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "product-playbook",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "MUST use when user wants to plan or strategize a product/feature. 22 PM frameworks, 6 modes, from idea to dev handoff",
   "bin": {
     "product-playbook": "./install.sh"

package/references/07b-tasks-tickets.md

@@ -17,7 +17,7 @@
 - [ ] **T0.1** 初始化專案（`scripts/setup.sh` 或手動）
   - 驗收：
     - [ ] `npm run dev` / `python manage.py runserver` 等指令可啟動
-    - [ ] `.gitignore` 已建立，包含 `.env`、`.env.local`、`node_modules/`、`.product-playbook-progress.md` 等敏感檔案
+    - [ ] `.gitignore` 已建立，包含 `.env`、`.env.local`、`node_modules/`、`.product-playbook-progress.md`、`.product-dev-active` 等敏感檔案
     - [ ] `.env.example` 已建立（只有 key 名稱，沒有實際值）
 - [ ] **T0.2** 設定 linter + formatter
   - 驗收：lint 通過無錯誤

package/references/07c-architecture-setup.md

@@ -90,6 +90,8 @@
 
 # 產品規劃進度（可能包含敏感商業資訊）
 .product-playbook-progress.md
+# Product-playbook 開發交接標記（session-local，請勿 commit）
+.product-dev-active
 
 # IDE 與作業系統
 .idea/