bmad-product-brief

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

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/tuanpa-nhg-eng/nhg-ipms --skill bmad-product-brief-tuanpa-nhg-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-product-brief
Source: https://github.com/tuanpa-nhg-eng/nhg-ipms/tree/main/.claude/skills/bmad-product-brief
Command: npx skills add https://github.com/tuanpa-nhg-eng/nhg-ipms --skill bmad-product-brief-tuanpa-nhg-eng

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, context gets lost between sessions, and drafts drift from prior decisions. This Skill acts as a product analyst coach that draws the picture out of you, pressure-tests thin answers, and produces a brief ready for downstream planning. ## Core Features & Use Cases - Three intent modes: Create a new brief from scratch, Update an existing brief against a change signal, or Validate a brief with honest, line-cited critique. - Guided discovery: Conversational brain-dump facilitation with web-research subagents, plus a choice between a Fast path (batched questions, [ASSUMPTION] tags) and a Coaching path (section-by-section pushback). - Persistent workspace: Each run writes brief.md, an addendum.md for out-of-scope depth, and an append-only .memlog.md audit trail, so work resumes cleanly across sessions. - Use Case: A founder with a pitch tomorrow invokes the skill, brain-dumps the idea, picks the Fast path, and receives a polished 1-2 page brief with assumptions flagged for review. ## 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 frontmatter in a dedicated workspace folder you can review and iterate on.

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

Use the Update intent: the skill reads the existing brief, addendum, and memlog, runs discovery against the change signal, and surfaces conflicts with prior decisions before editing. Fundamental changes trigger an offer to Create a fresh brief instead.

Can I validate a product brief before sharing it with stakeholders?

Yes. The Validate intent reads the brief, addendum, and decision log, then returns an honest critique citing specific lines, with caveats for what cannot be evaluated. It always offers to roll findings into an update.

Does the product brief workflow support headless or non-interactive runs?

Yes. In headless mode the skill completes the detected intent without prompting, using provided inputs and workspace contents. If intent is ambiguous it halts with a blocked JSON status and reason field instead of asking questions.

What happens to research and details that do not fit in the brief?

Content that is valuable but too detailed for the 1-2 page brief goes into addendum.md, such as rejected alternatives, personas, or sizing data. Decisions and overrides are logged separately in the append-only .memlog.md audit trail.