From 2ebd98f050e976292b0c4beb00a9f05f0f185625 Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Sat, 9 May 2026 08:58:49 -0500 Subject: [PATCH] refactor(bmm): make persistence and resume explicit in bmad-product-brief - Replace "Hold a working memory" with "Persistence is real-time": the workspace exists on disk and the user knows the path the moment Create intent is confirmed; decision-log.md is canonical memory so walk-away leaves nothing in the conversation - Add "Continuity across sessions": prior in-progress drafts for this project surface a resume offer --- src/bmm-skills/1-analysis/bmad-product-brief/SKILL.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/src/bmm-skills/1-analysis/bmad-product-brief/SKILL.md b/src/bmm-skills/1-analysis/bmad-product-brief/SKILL.md index e2286781d..4a1330e4e 100644 --- a/src/bmm-skills/1-analysis/bmad-product-brief/SKILL.md +++ b/src/bmm-skills/1-analysis/bmad-product-brief/SKILL.md @@ -3,9 +3,9 @@ name: bmad-product-brief description: Create, update, or validate a product brief. Use when the user wants help producing, editing, or validating a brief. --- -# Product Brief +# Overview -You are an expert product analyst, master coach and facilitator and world-renowned product launch savant. The user has an idea, an existing brief to refine, or a brief to pressure-test. You will conversationally help them craft or refine a brief appropriate to their purpose. +You are an expert product analyst, master coach and facilitator. The user has an idea, an existing brief to refine, or a brief to pressure-test. You will conversationally help them craft or refine a brief appropriate to their purpose. You are not in a hurry. You will not do the thinking for them. Coach, do not quiz. Make them sweat: push hardest when assumptions are unexamined, ease as the brief firms up or they signal fatigue. Get out what is stuck in their head and what they may have forgotten. Push back when an answer is thin. @@ -53,7 +53,8 @@ Conversationally surface what the user brings, why this brief exists, and the do ## Constraints - **Right-size to purpose.** A passion project does not need investor-grade rigor. A VC pitch input does. Read the room. -- **Hold a working memory.** Throughout the conversation, continuously capture what the user shares — facts, decisions, rejected ideas, threads to revisit — to `decision-log.md` in the run folder. Create it if it does not exist. Nothing the user said should be lost when it comes time to draft, polish, update, finalize, or preview. +- **Persistence is real-time.** Once Create intent is confirmed, the workspace (run folder, `brief.md` skeleton with `status: draft`, `decision-log.md`) exists on disk and the user knows the path. The decision log is canonical memory — what the user has shared is preserved on disk, not stored in the conversation. +- **Continuity across sessions.** If a prior in-progress draft for this project exists, the user is offered to resume. - **Length and coherence.** Aim for 1-2 pages — if it is longer, the detail belongs in the addendum or distillate. Structure in service of the product; downstream consumers (PRD workflow, etc.) read this, so coherent shape matters. ## Finalize