src/bmm-skills/1-analysis/bmad-product-brief/prompts/draft-and-review.md
Language: Use {communication_language} for all output.
Output Language: Use {document_output_language} for documents.
Output Location: {planning_artifacts}
Paths: Bare paths (e.g. agents/foo.md) resolve from the skill root.
Goal: Produce the executive product brief and run it through multiple review lenses to catch blind spots before the user sees the final version.
Use the template at {workflow.brief_template} as a guide — adapt structure to fit the product's story.
Writing principles:
{document_output_language}Create the output document at: {planning_artifacts}/product-brief-{project_name}.md
Include YAML frontmatter:
---
title: "Product Brief: {project_name}"
status: "draft"
created: "{timestamp}"
updated: "{timestamp}"
inputs: [list of input files used]
---
Before showing the draft to the user, run it through multiple review lenses in parallel.
Launch in parallel:
Skeptic Reviewer (agents/skeptic-reviewer.md) — "What's missing? What assumptions are untested? What could go wrong? Where is the brief vague or hand-wavy?"
Opportunity Reviewer (agents/opportunity-reviewer.md) — "What adjacent value propositions are being missed? What market angles or partnerships could strengthen this? What's underemphasized?"
Contextual Reviewer — You (the main agent) pick the most useful third lens based on THIS specific product. Choose the lens that addresses the SINGLE BIGGEST RISK that the skeptic and opportunity reviewers won't naturally catch. Examples:
If subagents are unavailable:
After all reviews complete:
Headless mode: Skip to prompts/finalize.md — no user interaction. Save the improved draft directly.
Yolo and Guided modes:
Present the draft brief to the user. Then share the reviewer insights:
"Here's your product brief draft. Before we finalize, my review panel surfaced some things worth considering:
[Grouped reviewer findings — only the substantive ones that need user input]
What do you think? Any changes you'd like to make?"
Present reviewer findings with brief rationale, then offer: "Want me to dig into any of these, or are you ready to make your revisions?"
Iterate as long as the user wants to refine. Use the "anything else, or are we happy with this?" soft gate.
This stage is complete when: (a) the draft has been reviewed by all three lenses and improvements integrated, AND either (autonomous) save and route directly, or (guided/yolo) the user is satisfied. Route to prompts/finalize.md.