Skip to content

Commit abfc56b

Browse files
authored
feat: add bmad-prfaq skill as alternative analysis path (#2157)
* feat: add bmad-prfaq skill as alternative to product brief Add Working Backwards PRFAQ challenge skill for stress-testing product concepts through Amazon's PRFAQ methodology. Includes press release drafting, customer FAQ, internal FAQ, and verdict stages with subagent support for artifact scanning and web research. - New bmad-prfaq skill with 5-stage interactive gauntlet and headless mode - Subagents for artifact analysis and web research (graceful degradation) - Research-grounded output directive for current market/competitive data - Always produces distillate for downstream PRD consumption - Fix manifest array syntax in both prfaq and product-brief manifests - Drop number prefixes from reference files - Update docs: getting-started, workflow-map, agents, skills reference - Add analysis-phase explainer doc with comparison table and decision guide - Update workflow-map-diagram.html with prfaq card - Add -H and -A args to CSV for both skills - Add unist-util-visit as devDependency (was imported but undeclared) * fix: harden bmad-prfaq for compaction resilience and context efficiency Add coaching persona re-anchors to all stage prompts so the behavioral directive survives context compaction. Add do-not-read guards at resume detection, headless mode, and input gathering to prevent parent agent context bloat. Add Stage 1 coaching notes capture. Adapt template and press release stage for non-commercial concept types. Cap subagent response token budgets. * fix: add config.user.yaml to file-ref validator allowlist Also update PRFAQ config path to use correct _config/bmm/ prefix.
1 parent fa909a8 commit abfc56b

20 files changed

Lines changed: 623 additions & 10 deletions

File tree

docs/explanation/analysis-phase.md

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
title: "Analysis Phase: From Idea to Foundation"
3+
description: What brainstorming, research, product briefs, and PRFAQs are — and when to use each
4+
sidebar:
5+
order: 1
6+
---
7+
8+
The Analysis phase (Phase 1) helps you think clearly about your product before committing to building it. Every tool in this phase is optional, but skipping analysis entirely means your PRD is built on assumptions instead of insight.
9+
10+
## Why Analysis Before Planning?
11+
12+
A PRD answers "what should we build and why?" If you feed it vague thinking, you get a vague PRD — and every downstream document inherits that vagueness. Architecture built on a weak PRD makes wrong technical bets. Stories derived from weak architecture miss edge cases. The cost compounds.
13+
14+
Analysis tools exist to make your PRD sharp. They attack the problem from different angles — creative exploration, market reality, customer clarity, feasibility — so that by the time you sit down with the PM agent, you know what you're building and for whom.
15+
16+
## The Tools
17+
18+
### Brainstorming
19+
20+
**What it is.** A facilitated creative session using proven ideation techniques. The AI acts as coach, pulling ideas out of you through structured exercises — not generating ideas for you.
21+
22+
**Why it's here.** Raw ideas need space to develop before they get locked into requirements. Brainstorming creates that space. It's especially valuable when you have a problem domain but no clear solution, or when you want to explore multiple directions before committing.
23+
24+
**When to use it.** You have a vague sense of what you want to build but haven't crystallized the concept. Or you have a concept but want to pressure-test it against alternatives.
25+
26+
See [Brainstorming](./brainstorming.md) for a deeper look at how sessions work.
27+
28+
### Research (Market, Domain, Technical)
29+
30+
**What it is.** Three focused research workflows that investigate different dimensions of your idea. Market research examines competitors, trends, and user sentiment. Domain research builds subject-matter expertise and terminology. Technical research evaluates feasibility, architecture options, and implementation approaches.
31+
32+
**Why it's here.** Building on assumptions is the fastest way to build something nobody needs. Research grounds your concept in reality — what competitors already exist, what users actually struggle with, what's technically feasible, and what industry-specific constraints you'll face.
33+
34+
**When to use it.** You're entering an unfamiliar domain, you suspect competitors exist but haven't mapped them, or your concept depends on technical capabilities you haven't validated. Run one, two, or all three — each stands alone.
35+
36+
### Product Brief
37+
38+
**What it is.** A guided discovery session that produces a 1-2 page executive summary of your product concept. The AI acts as a collaborative Business Analyst, helping you articulate the vision, target audience, value proposition, and scope.
39+
40+
**Why it's here.** The product brief is the gentler path into planning. It captures your strategic vision in a structured format that feeds directly into PRD creation. It works best when you already have conviction about your concept — you know the customer, the problem, and roughly what you want to build. The brief organizes and sharpens that thinking.
41+
42+
**When to use it.** Your concept is relatively clear and you want to document it efficiently before creating a PRD. You're confident in the direction and don't need your assumptions aggressively challenged.
43+
44+
### PRFAQ (Working Backwards)
45+
46+
**What it is.** Amazon's Working Backwards methodology adapted as an interactive challenge. You write the press release announcing your finished product before a single line of code exists, then answer the hardest questions customers and stakeholders would ask. The AI acts as a relentless but constructive product coach.
47+
48+
**Why it's here.** The PRFAQ is the rigorous path into planning. It forces customer-first clarity by making you defend every claim. If you can't write a compelling press release, the product isn't ready. If customer FAQ answers reveal gaps, those are gaps you'd discover much later — and more expensively — during implementation. The gauntlet surfaces weak thinking early, when it's cheapest to fix.
49+
50+
**When to use it.** You want your concept stress-tested before committing resources. You're unsure whether users will actually care. You want to validate that you can articulate a clear, defensible value proposition. Or you simply want the discipline of Working Backwards to sharpen your thinking.
51+
52+
## Which Should I Use?
53+
54+
| Situation | Recommended tool |
55+
| --------- | ---------------- |
56+
| "I have a vague idea, not sure where to start" | Brainstorming |
57+
| "I need to understand the market before deciding" | Research |
58+
| "I know what I want to build, just need to document it" | Product Brief |
59+
| "I want to make sure this idea is actually worth building" | PRFAQ |
60+
| "I want to explore, then validate, then document" | Brainstorming → Research → PRFAQ or Brief |
61+
62+
Product Brief and PRFAQ both produce input for the PRD — choose one based on how much challenge you want. The brief is collaborative discovery. The PRFAQ is a gauntlet. Both get you to the same destination; the PRFAQ tests whether your concept deserves to get there.
63+
64+
:::tip[Not Sure?]
65+
Run `bmad-help` and describe your situation. It will recommend the right starting point based on what you've already done and what you're trying to accomplish.
66+
:::
67+
68+
## What Happens After Analysis?
69+
70+
Analysis outputs feed directly into Phase 2 (Planning). The PRD workflow accepts product briefs, PRFAQ documents, research findings, and brainstorming reports as input — it synthesizes whatever you've produced into structured requirements. The more analysis you do, the sharper your PRD.

docs/reference/agents.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ This page lists the default BMM (Agile suite) agents that install with BMad Meth
1717

1818
| Agent | Skill ID | Triggers | Primary workflows |
1919
| --------------------------- | -------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------- |
20-
| Analyst (Mary) | `bmad-analyst` | `BP`, `RS`, `CB`, `DP` | Brainstorm Project, Research, Create Brief, Document Project |
20+
| Analyst (Mary) | `bmad-analyst` | `BP`, `RS`, `CB`, `WB`, `DP` | Brainstorm Project, Research, Create Brief, PRFAQ Challenge, Document Project |
2121
| Product Manager (John) | `bmad-pm` | `CP`, `VP`, `EP`, `CE`, `IR`, `CC` | Create/Validate/Edit PRD, Create Epics and Stories, Implementation Readiness, Correct Course |
2222
| Architect (Winston) | `bmad-architect` | `CA`, `IR` | Create Architecture, Implementation Readiness |
2323
| Scrum Master (Bob) | `bmad-sm` | `SP`, `CS`, `ER`, `CC` | Sprint Planning, Create Story, Epic Retrospective, Correct Course |

docs/reference/commands.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -92,6 +92,8 @@ Workflow skills run a structured, multi-step process without loading an agent pe
9292

9393
| Example skill | Purpose |
9494
| --- | --- |
95+
| `bmad-product-brief` | Create a product brief — guided discovery when your concept is clear |
96+
| `bmad-prfaq` | Working Backwards PRFAQ challenge to stress-test your product concept |
9597
| `bmad-create-prd` | Create a Product Requirements Document |
9698
| `bmad-create-architecture` | Design system architecture |
9799
| `bmad-create-epics-and-stories` | Create epics and stories |

docs/reference/workflow-map.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,13 +21,14 @@ Final important note: Every workflow below can be run directly with your tool of
2121

2222
## Phase 1: Analysis (Optional)
2323

24-
Explore the problem space and validate ideas before committing to planning.
24+
Explore the problem space and validate ideas before committing to planning. [**Learn what each tool does and when to use it**](../explanation/analysis-phase.md).
2525

2626
| Workflow | Purpose | Produces |
2727
| ------------------------------- | -------------------------------------------------------------------------- | ------------------------- |
2828
| `bmad-brainstorming` | Brainstorm Project Ideas with guided facilitation of a brainstorming coach | `brainstorming-report.md` |
2929
| `bmad-domain-research`, `bmad-market-research`, `bmad-technical-research` | Validate market, technical, or domain assumptions | Research findings |
30-
| `bmad-create-product-brief` | Capture strategic vision | `product-brief.md` |
30+
| `bmad-product-brief` | Capture strategic vision — best when your concept is clear | `product-brief.md` |
31+
| `bmad-prfaq` | Working Backwards — stress-test and forge your product concept | `prfaq-{project}.md` |
3132

3233
## Phase 2: Planning
3334

docs/tutorials/getting-started.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ BMad helps you build software through guided workflows with specialized AI agent
6868

6969
| Phase | Name | What Happens |
7070
| ----- | -------------- | --------------------------------------------------- |
71-
| 1 | Analysis | Brainstorming, research, product brief *(optional)* |
71+
| 1 | Analysis | Brainstorming, research, product brief or PRFAQ *(optional)* |
7272
| 2 | Planning | Create requirements (PRD or spec) |
7373
| 3 | Solutioning | Design architecture *(BMad Method/Enterprise only)* |
7474
| 4 | Implementation | Build epic by epic, story by story |
@@ -133,10 +133,11 @@ Create it manually at `_bmad-output/project-context.md` or generate it after arc
133133

134134
### Phase 1: Analysis (Optional)
135135

136-
All workflows in this phase are optional:
136+
All workflows in this phase are optional. [**Not sure which to use?**](../explanation/analysis-phase.md)
137137
- **brainstorming** (`bmad-brainstorming`) — Guided ideation
138138
- **research** (`bmad-market-research` / `bmad-domain-research` / `bmad-technical-research`) — Market, domain, and technical research
139-
- **create-product-brief** (`bmad-create-product-brief`) — Recommended foundation document
139+
- **product-brief** (`bmad-product-brief`) — Recommended foundation document when your concept is clear
140+
- **prfaq** (`bmad-prfaq`) — Working Backwards challenge to stress-test and forge your product concept
140141

141142
### Phase 2: Planning (Required)
142143

package.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,7 @@
9797
"prettier": "^3.7.4",
9898
"prettier-plugin-packagejson": "^2.5.19",
9999
"sharp": "^0.33.5",
100+
"unist-util-visit": "^5.1.0",
100101
"yaml-eslint-parser": "^1.2.3",
101102
"yaml-lint": "^1.7.0"
102103
},

src/bmm-skills/1-analysis/bmad-agent-analyst/SKILL.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,7 @@ When you are in this persona and the user calls a skill, this persona must carry
3636
| DR | Industry domain deep dive, subject matter expertise and terminology | bmad-domain-research |
3737
| TR | Technical feasibility, architecture options and implementation approaches | bmad-technical-research |
3838
| CB | Create or update product briefs through guided or autonomous discovery | bmad-product-brief-preview |
39+
| WB | Working Backwards PRFAQ challenge — forge and stress-test product concepts | bmad-prfaq |
3940
| DP | Analyze an existing project to produce documentation for human and LLM consumption | bmad-document-project |
4041

4142
## On Activation

0 commit comments

Comments
 (0)