bmad-product-brief

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

Updated May 22, 2026
One-click install
npx skills add https://github.com/Asygnuz-S-A-S/one-star --skill bmad-product-brief-asygnuz-s-a-s
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-product-brief
Source: https://github.com/Asygnuz-S-A-S/one-star/tree/main/.claude/skills/bmad-product-brief
Command: npx skills add https://github.com/Asygnuz-S-A-S/one-star --skill bmad-product-brief-asygnuz-s-a-s

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, refining, or pressure-testing a brief so the output 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 cited, honest critique. - Discovery coaching: Conversational brain-dump facilitation with web-research subagents, plus Fast path (assumption-tagged draft) or Coaching path (section-by-section) working modes. - Persistent workspace: Writes brief.md, addendum.md, and a .decision-log.md audit trail into a run folder, with resume support across sessions and optional external handoffs (Confluence, Slack) at finalize. - 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 [ASSUMPTION] tags to 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 an AI assistant?▼

Invoke the Skill and describe your product idea in a brain dump. It runs a Discovery phase to surface goals, users, and differentiators, then drafts a brief.md with a template structure you review and refine iteratively.

How do I validate an existing product brief?▼

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

Can I update a product brief after requirements change?▼

Yes. The Update mode reconciles the existing brief with a change signal, surfaces conflicts with prior decisions recorded in .decision-log.md, and logs any overrides before applying changes.

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

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 creates a run folder containing brief.md with YAML frontmatter, an optional addendum.md for depth that belongs downstream, and a .decision-log.md audit trail of every decision and override.