bmad-product-brief

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

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-product-brief-hexalith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-product-brief
Source: https://github.com/Hexalith/Hexalith.Parties/tree/main/.agents/skills/bmad-product-brief
Command: npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-product-brief-hexalith

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 drift out of sync with decisions. This Skill coaches users through creating, updating, or validating a product brief so the result reflects their own thinking. ## 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. - Conversational discovery with coaching: Brain-dump friendly discovery, web-research subagents for landscape grounding, and a choice between a Fast path (batched questions with [ASSUMPTION] tags) and a Coaching path (section-by-section pushback). - Persistent workspace with audit trail: Briefs land in a run folder with YAML frontmatter, an append-only .memlog.md decision log, and an addendum.md for depth that belongs downstream. - Headless and resumable operation: Supports non-interactive runs with JSON status output and resume of prior in-progress drafts. - 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 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. It runs a discovery conversation, offers a Fast path with tagged assumptions or a Coaching path with section-by-section pushback, then writes brief.md into a dated run folder.

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 editing.

Can the product brief workflow run headless without interaction?

Yes. In headless mode it completes the detected intent without prompting, using provided inputs and workspace contents, and returns a JSON status block with artifact paths. Ambiguous intent halts with a blocked status.

What files does the product brief workflow produce?

It produces brief.md with YAML frontmatter, an append-only .memlog.md decision and audit log, and optionally addendum.md for depth that belongs in downstream documents like PRDs. All land in a run folder under the configured brief output path.

When should I validate a product brief instead of updating it?

Use Validate when you want an honest critique against the brief's own purpose without changing it. It cites specific lines, caveats what cannot be evaluated, and always offers to roll findings into an Update.