product-playbook 1.2.0 → 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.0",
+      "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.0",
+  "version": "1.2.2",
   "author": {
     "name": "Charles Chen"
   },

package/SKILL.md

@@ -190,7 +190,7 @@ The entire process is NOT meant to be run all at once. After completing each sta
 
 **The following rules are non-negotiable, regardless of whether the user has bypass permission enabled:**
 
-1. **No code during the planning process**: Throughout this Skill's workflow, Claude must NOT use Write / Edit / Bash tools to create or modify any code files (.ts / .js / .py / .html / .css / .json, etc.). The only exceptions are generating HTML reports (`references/06-html-report.md`) and Mermaid diagrams
+1. **No code during the planning process**: Throughout this Skill's workflow, Claude must NOT use Write / Edit / Bash tools to create or modify any code files (.ts / .js / .py / .html / .css / .json, etc.). The only exceptions are generating HTML reports (`references/06-html-report.md`) and Mermaid diagrams. *(As of v1.2.0, the plugin's `PreToolUse` hook also emits an advisory reminder when a source-code write is attempted before the `.product-dev-active` marker exists. The rule above remains authoritative — the hook is a safety net, not a substitute.)*
 2. **Each step must wait for user confirmation before proceeding**: After completing the output for a step, you must ask for user feedback and wait for a response. Do not auto-advance to the next step. Even if the user says "just run everything automatically," pause after each step's output so the user has a chance to review
 3. **No skipping steps**: In any mode, follow the step sequence defined in the mode rules file. Do not skip intermediate steps because you "feel the user just wants the final result"
 4. **Dev handoff package only after the process is complete**: The "start development" or "generate dev handoff package" commands may only be executed after all steps in the current mode are marked ✅. If the user requests development mid-process, respond: "We're currently at S[X]/S[Y]. I recommend completing the remaining steps before moving to development. Would you like to continue, or are you sure you want to proceed to development at the current progress?"
@@ -201,6 +201,8 @@ The entire process is NOT meant to be run all at once. After completing each sta
 
 ### 🔀 Off-topic Prompt Handling
 
+> *As of v1.2.0, the plugin's `UserPromptSubmit` hook auto-detects off-topic prompts and emits an advisory reminder. The rules below remain authoritative — the hook only ensures Claude doesn't forget.*
+
 **When an off-topic prompt is received during the process, Claude must:**
 
 1. **Save progress before answering**: Before answering the unrelated question, update `.product-playbook-progress.md` (per `references/rules-progress.md`), recording the current step and any partial outputs
@@ -238,7 +240,7 @@ The entire process is NOT meant to be run all at once. After completing each sta
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-When the user goes back to a completed step to make changes, read `references/rules-change-propagation.md` for change propagation rules.
+When the user goes back to a completed step to make changes, read `references/rules-change-propagation.md` for change propagation rules. *(As of v1.2.0, the plugin's `UserPromptSubmit` hook detects change-intent keywords and emits a reminder to apply these rules.)*
 
 When the user uploads a file, read `references/rules-file-integration.md` for integration guidelines.
 

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/SKILL.md

@@ -190,7 +190,7 @@ The entire process is NOT meant to be run all at once. After completing each sta
 
 **The following rules are non-negotiable, regardless of whether the user has bypass permission enabled:**
 
-1. **No code during the planning process**: Throughout this Skill's workflow, Claude must NOT use Write / Edit / Bash tools to create or modify any code files (.ts / .js / .py / .html / .css / .json, etc.). The only exceptions are generating HTML reports (`references/06-html-report.md`) and Mermaid diagrams
+1. **No code during the planning process**: Throughout this Skill's workflow, Claude must NOT use Write / Edit / Bash tools to create or modify any code files (.ts / .js / .py / .html / .css / .json, etc.). The only exceptions are generating HTML reports (`references/06-html-report.md`) and Mermaid diagrams. *(As of v1.2.0, the plugin's `PreToolUse` hook also emits an advisory reminder when a source-code write is attempted before the `.product-dev-active` marker exists. The rule above remains authoritative — the hook is a safety net, not a substitute.)*
 2. **Each step must wait for user confirmation before proceeding**: After completing the output for a step, you must ask for user feedback and wait for a response. Do not auto-advance to the next step. Even if the user says "just run everything automatically," pause after each step's output so the user has a chance to review
 3. **No skipping steps**: In any mode, follow the step sequence defined in the mode rules file. Do not skip intermediate steps because you "feel the user just wants the final result"
 4. **Dev handoff package only after the process is complete**: The "start development" or "generate dev handoff package" commands may only be executed after all steps in the current mode are marked ✅. If the user requests development mid-process, respond: "We're currently at S[X]/S[Y]. I recommend completing the remaining steps before moving to development. Would you like to continue, or are you sure you want to proceed to development at the current progress?"
@@ -201,6 +201,8 @@ The entire process is NOT meant to be run all at once. After completing each sta
 
 ### 🔀 Off-topic Prompt Handling
 
+> *As of v1.2.0, the plugin's `UserPromptSubmit` hook auto-detects off-topic prompts and emits an advisory reminder. The rules below remain authoritative — the hook only ensures Claude doesn't forget.*
+
 **When an off-topic prompt is received during the process, Claude must:**
 
 1. **Save progress before answering**: Before answering the unrelated question, update `.product-playbook-progress.md` (per `references/rules-progress.md`), recording the current step and any partial outputs
@@ -238,7 +240,7 @@ The entire process is NOT meant to be run all at once. After completing each sta
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-When the user goes back to a completed step to make changes, read `references/rules-change-propagation.md` for change propagation rules.
+When the user goes back to a completed step to make changes, read `references/rules-change-propagation.md` for change propagation rules. *(As of v1.2.0, the plugin's `UserPromptSubmit` hook detects change-intent keywords and emits a reminder to apply these rules.)*
 
 When the user uploads a file, read `references/rules-file-integration.md` for integration guidelines.
 

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

@@ -10,12 +10,15 @@ 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. 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
+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)
+6. Generate docs/ARCHITECTURE.md (directory structure + DB Schema + API Endpoints)
+7. Generate docs/PRD.md + docs/PRODUCT-SPEC.md
+8. Generate scripts/setup.sh (one-click initialization)
+9. Display Claude Code transition guide
 
 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 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/SKILL.md

@@ -190,7 +190,7 @@ Todo el proceso NO está pensado para ejecutarse de una sola vez. Después de co
 
 **Las siguientes reglas son innegociables, independientemente de si el usuario tiene permisos de bypass habilitados:**
 
-1. **No código durante el proceso de planificación**: A lo largo del flujo de este Skill, Claude NO DEBE usar las herramientas Write / Edit / Bash para crear o modificar archivos de código (.ts / .js / .py / .html / .css / .json, etc.). Las únicas excepciones son generar reportes HTML (`references/06-html-report.md`) y diagramas Mermaid
+1. **No código durante el proceso de planificación**: A lo largo del flujo de este Skill, Claude NO DEBE usar las herramientas Write / Edit / Bash para crear o modificar archivos de código (.ts / .js / .py / .html / .css / .json, etc.). Las únicas excepciones son generar reportes HTML (`references/06-html-report.md`) y diagramas Mermaid. *(A partir de v1.2.0, el hook `PreToolUse` del plugin también emite un recordatorio cuando se intenta escribir código fuente antes de que exista el marcador `.product-dev-active`. La regla anterior sigue siendo autoritativa — el hook es una red de seguridad, no un sustituto.)*
 2. **Cada paso debe esperar confirmación del usuario antes de continuar**: Después de completar el output de un paso, debes pedir feedback al usuario y esperar respuesta. No avances automáticamente al siguiente paso. Incluso si el usuario dice "solo ejecuta todo automáticamente," pausa después del output de cada paso para que el usuario tenga oportunidad de revisar
 3. **No omitir pasos**: En cualquier modo, sigue la secuencia de pasos definida en el archivo de reglas del modo. No omitas pasos intermedios porque "sientes que el usuario solo quiere el resultado final"
 4. **Paquete de handoff de desarrollo solo después de completar el proceso**: Los comandos "iniciar desarrollo" o "generar paquete de handoff de desarrollo" solo pueden ejecutarse después de que todos los pasos del modo actual estén marcados ✅. Si el usuario solicita desarrollo a mitad del proceso, responde: "Actualmente estamos en S[X]/S[Y]. Recomiendo completar los pasos restantes antes de pasar a desarrollo. ¿Quieres continuar, o estás seguro de que quieres proceder a desarrollo con el progreso actual?"
@@ -201,6 +201,8 @@ Todo el proceso NO está pensado para ejecutarse de una sola vez. Después de co
 
 ### 🔀 Manejo de Prompts Fuera de Tema
 
+> *A partir de v1.2.0, el hook `UserPromptSubmit` del plugin auto-detecta prompts fuera de tema y emite un recordatorio. Las reglas a continuación siguen siendo autoritativas — el hook solo asegura que Claude no las olvide.*
+
 **Cuando se recibe un prompt fuera de tema durante el proceso, Claude debe:**
 
 1. **Guardar progreso antes de responder**: Antes de responder la pregunta no relacionada, actualiza `.product-playbook-progress.md` (según `references/rules-progress.md`), registrando el paso actual y cualquier output parcial
@@ -238,7 +240,7 @@ Todo el proceso NO está pensado para ejecutarse de una sola vez. Después de co
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-Cuando el usuario regresa a un paso completado para hacer cambios, lee `references/rules-change-propagation.md` para reglas de propagación de cambios.
+Cuando el usuario regresa a un paso completado para hacer cambios, lee `references/rules-change-propagation.md` para reglas de propagación de cambios. *(A partir de v1.2.0, el hook `UserPromptSubmit` del plugin detecta palabras clave de intención de cambio y recuerda aplicar estas reglas.)*
 
 Cuando el usuario sube un archivo, lee `references/rules-file-integration.md` para guías de integración.
 

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

@@ -10,12 +10,15 @@ 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. Genera CLAUDE.md (memoria de proyecto de Claude Code)
-3. Genera TASKS.md (desglose de funcionalidades + releases por fases + criterios de aceptación)
-4. Genera TICKETS.md (lista de tickets)
-5. Genera docs/ARCHITECTURE.md (estructura de directorios + DB Schema + API Endpoints)
-6. Genera docs/PRD.md + docs/PRODUCT-SPEC.md
-7. Genera scripts/setup.sh (script de inicialización en un solo comando)
-8. Muestra la guía de transición a Claude Code
+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)
+6. Genera docs/ARCHITECTURE.md (estructura de directorios + DB Schema + API Endpoints)
+7. Genera docs/PRD.md + docs/PRODUCT-SPEC.md
+8. Genera scripts/setup.sh (script de inicialización en un solo comando)
+9. Muestra la guía de transición a Claude Code
 
 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 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/SKILL.md

@@ -190,7 +190,7 @@ description: |
 
 **以下のルールは、ユーザーがバイパス許可を有効にしていても、交渉不可です：**
 
-1. **企画プロセス中はコード禁止**：このスキルのワークフロー全体を通じて、ClaudeはWrite / Edit / Bashツールを使用してコードファイル（.ts / .js / .py / .html / .css / .jsonなど）を作成または変更してはなりません。例外はHTMLレポートの生成（`references/06-html-report.md`）とMermaidダイアグラムのみです
+1. **企画プロセス中はコード禁止**：このスキルのワークフロー全体を通じて、ClaudeはWrite / Edit / Bashツールを使用してコードファイル（.ts / .js / .py / .html / .css / .jsonなど）を作成または変更してはなりません。例外はHTMLレポートの生成（`references/06-html-report.md`）とMermaidダイアグラムのみです。*（v1.2.0 以降、プラグインの `PreToolUse` hook が `.product-dev-active` マーカー不在時のソースコード書き込みを検出し、ソフトリマインダーを送出します。上記ルールが正本であり、hook はセーフティネットに過ぎません。）*
 2. **各ステップはユーザー確認を待ってから進む**：ステップの出力完了後、ユーザーフィードバックを求め、返答を待ってください。次のステップに自動的に進まないでください。ユーザーが「すべて自動で実行して」と言っても、各ステップの出力後に一時停止し、ユーザーがレビューできるようにしてください
 3. **ステップをスキップしない**：どのモードでも、モードルールファイルで定義されたステップ順序に従ってください。「ユーザーは最終結果だけが欲しいだろう」と判断して中間ステップをスキップしないでください
 4. **開発ハンドオフパッケージはプロセス完了後のみ**：「開発を始める」「開発ハンドオフパッケージを生成」コマンドは、現在のモードのすべてのステップが✅になった後にのみ実行できます。ユーザーがプロセス途中で開発をリクエストした場合は、次のように回答してください：「現在S[X]/S[Y]の段階です。残りのステップを完了してから開発に移ることをお勧めします。続行しますか、それとも現在の進捗で開発に進みますか？」
@@ -201,6 +201,8 @@ description: |
 
 ### 🔀 脱線プロンプトの処理
 
+> *v1.2.0 以降、プラグインの `UserPromptSubmit` hook が脱線プロンプトを自動検出し、ソフトリマインダーを送出します。以下のルールが正本であり、hook は Claude が忘れないためのものです。*
+
 **プロセス中に脱線プロンプトを受け取った場合、Claudeは以下を実行する必要があります：**
 
 1. **回答前に進捗を保存**：無関係な質問に回答する前に、`.product-playbook-progress.md`を更新（`references/rules-progress.md`に従い）、現在のステップと部分的な出力を記録
@@ -238,7 +240,7 @@ description: |
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-ユーザーが完了済みステップに戻って変更する場合は、`references/rules-change-propagation.md`で変更伝播ルールを確認してください。
+ユーザーが完了済みステップに戻って変更する場合は、`references/rules-change-propagation.md`で変更伝播ルールを確認してください。*（v1.2.0 以降、プラグインの `UserPromptSubmit` hook が変更意図キーワードを検出し、本ルールの適用をリマインドします。）*
 
 ユーザーがファイルをアップロードした場合は、`references/rules-file-integration.md`で統合ガイドラインを確認してください。
 

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

@@ -10,12 +10,15 @@ product-playbook skill を起動してください。
 
 現在の会話で完成したプロダクト企画内容に基づいて、完全な開発ハンドオフパッケージを生成します：
 1. 技術スタックの確認（ユーザーが指定していない場合、プロダクト特性に基づいて推奨）
-2. CLAUDE.md を生成（Claude Codeプロジェクトメモリ）
-3. TASKS.md を生成（機能分解 + フェーズリリース + 受入基準）
-4. TICKETS.md を生成（チケットリスト）
-5. docs/ARCHITECTURE.md を生成（ディレクトリ構造 + DBスキーマ + APIエンドポイント）
-6. docs/PRD.md + docs/PRODUCT-SPEC.md を生成
-7. scripts/setup.sh を生成（ワンクリック初期化）
-8. Claude Codeトランジションガイドを表示
+2. プロジェクトルートに `.product-dev-active` マーカーファイル（空ファイル）を作成し、`.product-dev-active` をプロジェクトの `.gitignore` に追記します（`.gitignore` が無ければ新規作成、有ればエントリを追記。重複追加はしない）。これによりプラグインの PreToolUse hook へ「プロジェクトが正式に開発ハンドオフフェーズへ移行した」と伝え、以降のソースコード書き込みは hook によるリマインドの対象外となります。
+3. CLAUDE.md を生成（Claude Codeプロジェクトメモリ）
+4. TASKS.md を生成（機能分解 + フェーズリリース + 受入基準）
+5. TICKETS.md を生成（チケットリスト）
+6. docs/ARCHITECTURE.md を生成（ディレクトリ構造 + DBスキーマ + APIエンドポイント）
+7. docs/PRD.md + docs/PRODUCT-SPEC.md を生成
+8. scripts/setup.sh を生成（ワンクリック初期化）
+9. Claude Codeトランジションガイドを表示
 
 会話にプロダクト企画内容がない場合は、まずプロダクト企画フローを実行するよう促してください。
+
+注：`.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/SKILL.md

@@ -190,7 +190,7 @@ description: |
 
 **다음 규칙은 사용자가 바이패스 권한을 활성화했더라도 변경할 수 없습니다:**
 
-1. **기획 과정에서 코드 금지**: 이 스킬의 워크플로우 전체에서 Claude는 Write / Edit / Bash 도구를 사용하여 코드 파일(.ts / .js / .py / .html / .css / .json 등)을 생성하거나 수정해서는 안 됩니다. 유일한 예외는 HTML 보고서 생성(`references/06-html-report.md`)과 Mermaid 다이어그램입니다
+1. **기획 과정에서 코드 금지**: 이 스킬의 워크플로우 전체에서 Claude는 Write / Edit / Bash 도구를 사용하여 코드 파일(.ts / .js / .py / .html / .css / .json 등)을 생성하거나 수정해서는 안 됩니다. 유일한 예외는 HTML 보고서 생성(`references/06-html-report.md`)과 Mermaid 다이어그램입니다. *(v1.2.0부터 플러그인의 `PreToolUse` hook이 `.product-dev-active` 마커가 없을 때 소스 코드 쓰기를 감지하고 소프트 리마인더를 발송합니다. 위 규칙이 권위 있으며 hook은 안전망일 뿐 대체재가 아닙니다.)*
 2. **각 단계는 사용자 확인을 기다려야 합니다**: 단계의 산출물을 완료한 후 사용자 피드백을 요청하고 응답을 기다려야 합니다. 다음 단계로 자동 진행하지 마세요. 사용자가 "모두 자동으로 실행해 주세요"라고 말하더라도, 각 단계의 산출물 후 일시 정지하여 사용자가 검토할 기회를 제공하세요
 3. **단계 건너뛰기 금지**: 모든 모드에서 모드 규칙 파일에 정의된 단계 시퀀스를 따르세요. "사용자가 최종 결과만 원할 것 같아서" 중간 단계를 건너뛰지 마세요
 4. **개발 핸드오프 패키지는 프로세스 완료 후에만**: "개발 시작" 또는 "개발 핸드오프 패키지 생성" 명령은 현재 모드의 모든 단계가 ✅ 표시된 후에만 실행할 수 있습니다. 사용자가 프로세스 중간에 개발을 요청하면: "현재 S[X]/S[Y] 단계입니다. 나머지 단계를 완료한 후 개발로 넘어가는 것을 권장합니다. 계속하시겠습니까, 아니면 현재 진행 상황에서 개발을 진행하시겠습니까?"
@@ -201,6 +201,8 @@ description: |
 
 ### 🔀 주제 이탈 프롬프트 처리
 
+> *v1.2.0부터 플러그인의 `UserPromptSubmit` hook이 주제 이탈 프롬프트를 자동 감지하고 소프트 리마인더를 발송합니다. 아래 규칙이 권위 있으며 hook은 Claude가 잊지 않도록 보장할 뿐입니다.*
+
 **프로세스 중 주제 이탈 프롬프트를 받으면 Claude는 다음을 수행해야 합니다:**
 
 1. **답변 전 진행 상황 저장**: 관련 없는 질문에 답변하기 전에 `.product-playbook-progress.md`를 업데이트(`references/rules-progress.md` 따름)하여 현재 단계와 부분 산출물을 기록
@@ -238,7 +240,7 @@ description: |
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-사용자가 완료된 단계로 돌아가서 변경할 때, `references/rules-change-propagation.md`를 읽어 변경 전파 규칙을 확인하세요.
+사용자가 완료된 단계로 돌아가서 변경할 때, `references/rules-change-propagation.md`를 읽어 변경 전파 규칙을 확인하세요. *(v1.2.0부터 플러그인의 `UserPromptSubmit` hook이 변경 의도 키워드를 감지하여 이 규칙을 적용하도록 리마인드합니다.)*
 
 사용자가 파일을 업로드할 때, `references/rules-file-integration.md`를 읽어 통합 가이드라인을 확인하세요.
 

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

@@ -10,12 +10,15 @@ product-playbook skill을 실행합니다.
 
 현재 대화에서 완료된 제품 기획 내용을 기반으로 전체 개발 핸드오프 패키지를 생성하세요:
 1. 기술 스택 확인 (사용자가 지정하지 않은 경우 제품 특성에 맞는 추천)
-2. CLAUDE.md 생성 (Claude Code 프로젝트 메모리)
-3. TASKS.md 생성 (기능 분해 + 단계별 릴리스 + 인수 기준)
-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 전환 가이드 표시
+2. 프로젝트 루트에 `.product-dev-active` 마커 파일(빈 파일)을 생성하고, `.product-dev-active`를 프로젝트의 `.gitignore`에 추가합니다 (`.gitignore`가 없으면 새로 생성, 있으면 항목을 append; 중복 추가 금지). 이 파일은 플러그인의 PreToolUse hook에 "프로젝트가 정식으로 개발 핸드오프 단계에 진입했음"을 알리며, 이후 소스 코드 쓰기에 대한 hook 리마인더가 비활성화됩니다.
+3. CLAUDE.md 생성 (Claude Code 프로젝트 메모리)
+4. TASKS.md 생성 (기능 분해 + 단계별 릴리스 + 인수 기준)
+5. TICKETS.md 생성 (티켓 목록)
+6. docs/ARCHITECTURE.md 생성 (디렉토리 구조 + DB Schema + API Endpoints)
+7. docs/PRD.md + docs/PRODUCT-SPEC.md 생성
+8. scripts/setup.sh 생성 (원클릭 초기화)
+9. Claude Code 전환 가이드 표시
 
 대화에 제품 기획 내용이 없는 경우, 제품 기획 플로우를 먼저 실행하도록 안내하세요.
+
+참고: `.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/SKILL.md

@@ -190,7 +190,7 @@ description: |
 
 **以下规则不可违反，无论使用者是否开启 bypass permission：**
 
-1. **禁止在规划流程中写代码**：整个 Skill 流程期间，Claude 不得使用 Write / Edit / Bash 工具建立或修改任何代码文件（.ts / .js / .py / .html / .css / .json 等）。唯一例外是产出 HTML 报告（references/06-html-report.md）和 Mermaid 图表
+1. **禁止在规划流程中写代码**：整个 Skill 流程期间，Claude 不得使用 Write / Edit / Bash 工具建立或修改任何代码文件（.ts / .js / .py / .html / .css / .json 等）。唯一例外是产出 HTML 报告（references/06-html-report.md）和 Mermaid 图表。*（自 v1.2.0 起，plugin 的 `PreToolUse` hook 会在尚未建立 `.product-dev-active` 标记时，检测源代码写入并发出软提醒。上述规则仍为权威 — hook 只是安全网，不取代规则。）*
 2. **每一步必须等待使用者确认才能进入下一步**：完成当前步骤的产出后，必须询问使用者回馈并等待回复，不得自动进入下一步。即使使用者说「全部自动跑完」，也要在每个步骤产出后暂停，至少显示产出让使用者有机会检视
 3. **不得跳步**：在任何模式中，必须依照模式规则档定义的顺序逐步执行。不得因为「感觉使用者想要的是最终结果」而跳过中间步骤
 4. **开发交接包只在流程结束后产出**：「进入开发」「产出开发交接包」指令只有在当前模式的所有步骤都标记为 ✅ 后才可执行。若使用者在流程中途要求进入开发，回复：「目前还在 S[X]/S[Y]，建议先完成剩余步骤再进入开发。你想继续完成，还是确定要在当前进度直接进入开发？」
@@ -201,6 +201,8 @@ description: |
 
 ### 🔀 流程中断处理（Off-topic Prompt）
 
+> *自 v1.2.0 起，plugin 的 `UserPromptSubmit` hook 会自动检测离题消息并发出软提醒。下方规则仍为权威 — hook 只确保 Claude 不会忘记。*
+
 **当流程进行中收到与产品规划无关的 prompt 时，Claude 必须：**
 
 1. **先存档再回答**：回答无关问题之前，先更新 `.product-playbook-progress.md`（依 `references/rules-progress.md`），记录当前步骤和已产出的部分内容
@@ -238,7 +240,7 @@ description: |
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-使用者回到已完成步骤进行修改时，读取 `references/rules-change-propagation.md` 取得变更传播规则。
+使用者回到已完成步骤进行修改时，读取 `references/rules-change-propagation.md` 取得变更传播规则。*（自 v1.2.0 起，plugin 的 `UserPromptSubmit` hook 会检测变更意图关键字并提醒套用此规则。）*
 
 使用者上传文件时，读取 `references/rules-file-integration.md` 取得整合指引。
 

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

@@ -10,12 +10,15 @@ description: 产出开发交接包 — 生成 CLAUDE.md + TASKS.md + TICKETS.md
 
 根据目前对话中已完成的产品规划内容，产出完整的开发交接包：
 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 衔接引导
+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（开票清单）
+6. 产出 docs/ARCHITECTURE.md（目录结构 + DB Schema + API Endpoints）
+7. 产出 docs/PRD.md + docs/PRODUCT-SPEC.md
+8. 产出 scripts/setup.sh（一键初始化）
+9. 显示 Claude Code 衔接引导
 
 如果对话中尚无产品规划内容，提示使用者先执行产品规划流程。
+
+注：`.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/SKILL.md

@@ -190,7 +190,7 @@ description: |
 
 **以下規則不可違反，無論使用者是否開啟 bypass permission：**
 
-1. **禁止在規劃流程中寫程式碼**：整個 Skill 流程期間，Claude 不得使用 Write / Edit / Bash 工具建立或修改任何程式碼檔案（.ts / .js / .py / .html / .css / .json 等）。唯一例外是產出 HTML 報告（references/06-html-report.md）和 Mermaid 圖表
+1. **禁止在規劃流程中寫程式碼**：整個 Skill 流程期間，Claude 不得使用 Write / Edit / Bash 工具建立或修改任何程式碼檔案（.ts / .js / .py / .html / .css / .json 等）。唯一例外是產出 HTML 報告（references/06-html-report.md）和 Mermaid 圖表。*（自 v1.2.0 起，plugin 的 `PreToolUse` hook 會在尚未建立 `.product-dev-active` 標記時，偵測原始碼寫入並發出軟提醒。上述規則仍為權威 — hook 只是安全網，不取代規則。）*
 2. **每一步必須等待使用者確認才能進入下一步**：完成當前步驟的產出後，必須詢問使用者回饋並等待回覆，不得自動進入下一步。即使使用者說「全部自動跑完」，也要在每個步驟產出後暫停，至少顯示產出讓使用者有機會檢視
 3. **不得跳步**：在任何模式中，必須依照模式規則檔定義的順序逐步執行。不得因為「感覺使用者想要的是最終結果」而跳過中間步驟
 4. **開發交接包只在流程結束後產出**：「進入開發」「產出開發交接包」指令只有在當前模式的所有步驟都標記為 ✅ 後才可執行。若使用者在流程中途要求進入開發，回覆：「目前還在 S[X]/S[Y]，建議先完成剩餘步驟再進入開發。你想繼續完成，還是確定要在當前進度直接進入開發？」
@@ -201,6 +201,8 @@ description: |
 
 ### 🔀 流程中斷處理（Off-topic Prompt）
 
+> *自 v1.2.0 起，plugin 的 `UserPromptSubmit` hook 會自動偵測離題訊息並發出軟提醒。下方規則仍為權威 — hook 只確保 Claude 不會忘記。*
+
 **當流程進行中收到與產品規劃無關的 prompt 時，Claude 必須：**
 
 1. **先存檔再回答**：回答無關問題之前，先更新 `.product-playbook-progress.md`（依 `references/rules-progress.md`），記錄當前步驟和已產出的部分內容
@@ -238,7 +240,7 @@ description: |
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-使用者回到已完成步驟進行修改時，讀取 `references/rules-change-propagation.md` 取得變更傳播規則。
+使用者回到已完成步驟進行修改時，讀取 `references/rules-change-propagation.md` 取得變更傳播規則。*（自 v1.2.0 起，plugin 的 `UserPromptSubmit` hook 會偵測變更意圖關鍵字並提醒套用此規則。）*
 
 使用者上傳檔案時，讀取 `references/rules-file-integration.md` 取得整合指引。
 

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

@@ -10,12 +10,15 @@ description: 產出開發交接包 — 生成 CLAUDE.md + TASKS.md + TICKETS.md
 
 根據目前對話中已完成的產品規劃內容，產出完整的開發交接包：
 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 銜接引導
+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（開票清單）
+6. 產出 docs/ARCHITECTURE.md（目錄結構 + DB Schema + API Endpoints）
+7. 產出 docs/PRD.md + docs/PRODUCT-SPEC.md
+8. 產出 scripts/setup.sh（一鍵初始化）
+9. 顯示 Claude Code 銜接引導
 
 如果對話中尚無產品規劃內容，提示使用者先執行產品規劃流程。
+
+註：`.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.0",
+  "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/