bmad-product-brief

Create, update, and validate product briefs through conversational coaching and structured workflows.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill bmad-product-brief-watchthelight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-product-brief
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/bmad-product-brief
Command: npx skills add https://github.com/watchthelight/shatterfish --skill bmad-product-brief-watchthelight

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Turning a rough product idea into a clear, honest, right-sized product brief is hard: assumptions go unexamined, key context stays in the founder's head, and drafts either pad or miss what downstream teams need. This Skill coaches users through creating, updating, or validating a brief so the output reflects their own thinking. ## Core Features & Use Cases - Three intent modes: Create a new brief from conversation, Update an existing brief against a change signal, or Validate a brief with cited, honest critique. - Coached discovery: Brain-dump friendly elicitation with web-research subagents, pushback on thin assumptions, and a choice between a fast path (assumption-tagged draft) or a coaching path (section-by-section). - Persistent workspace: Writes brief.md, addendum.md, and an append-only .memlog.md audit trail to a run folder, supporting stop-and-resume across sessions and headless (non-interactive) execution with JSON status output. - Use Case: A product manager with a pitch tomorrow invokes the skill, brain-dumps the idea, picks the fast path, and receives a polished 1-2 page brief with flagged assumptions plus an addendum of parked detail. ## Quick Start Ask the assistant to help you create a product brief for your product idea and answer its discovery questions.

Frequently Asked Questions about bmad-product-brief

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a product brief with AI assistance?

Invoke the skill and describe your product idea in a brain dump. The facilitator asks discovery questions, offers a fast path or coaching path, then drafts a brief.md with a template structure you review and refine together.

How do I update an existing product brief when requirements change?

Use the Update intent: the skill reads the existing brief, addendum, and memlog, runs discovery against the change signal, surfaces conflicts with prior decisions, and logs every change before applying it.

Can the product brief skill run without interactive conversation?

Yes, headless mode completes the detected intent using provided inputs and workspace contents without prompting. It returns a JSON status block listing intent and artifact paths, or halts with a blocked status if intent is ambiguous.

What files does the product brief workflow produce?

It produces brief.md with YAML frontmatter, an optional addendum.md for depth that does not fit the brief, and a .memlog.md append-only audit trail, all inside a run folder under the configured brief output path.

When should I not use a coached product brief workflow?

Skip it when you need deep market sizing or exhaustive competitive teardowns; the skill itself suggests a dedicated deep-research workflow for that. It is also unnecessary for trivial internal notes that need no validation or audit trail.