bmad-product-brief

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

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

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 discovery, drafting, and validation so the brief 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. - Guided discovery: Conversational brain-dump facilitation with web-research subagents, fast-path and coaching-path working modes, and pushback on thin assumptions. - Persistent workspace: Writes brief.md, addendum.md, and an append-only .memlog.md audit trail via memlog scripts, with resume support across sessions and headless JSON-status operation. - Use Case: A founder preparing an investor pitch invokes the skill, dumps their idea and prior notes, answers coaching questions, and receives a polished 1-2 page brief plus an addendum capturing rejected alternatives and sizing data. ## 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 with create intent and it guides you through a discovery conversation, capturing your idea, stakes, and source material before drafting. It writes brief.md with YAML frontmatter into a run folder and logs every decision to a memlog for auditability.

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

Use update mode: the skill reads the existing brief, addendum, and memlog, then reconciles the change signal against prior decisions before editing. It surfaces conflicts with earlier decisions and logs overrides rather than silently patching.

Can I validate a product brief for weaknesses?

Yes, validate mode critiques the brief against its own stated purpose, citing specific lines and caveating what cannot be evaluated. Findings return inline and the skill always offers to roll them into an update.

Does the product brief skill work in headless or non-interactive mode?

Yes, headless mode completes the detected intent without prompting, inferring from provided materials and the existing workspace. If intent stays ambiguous it halts with a blocked JSON status and a reason field instead of asking questions.

What files does the product brief workflow produce?

It produces brief.md as the main artifact, an optional addendum.md for depth that belongs downstream, and a .memlog.md append-only audit trail. All files live in a run folder under the configured brief output path.

When should I not use a conversational brief workflow?

Skip it when you only need a quick one-page summary with no discovery or audit trail, since the coaching process invests time in surfacing assumptions. Deep market sizing or exhaustive competitive teardowns are also out of scope and routed to a dedicated research skill.