Skill Tracer
Skills › BMAD Method › bmad-prfaq › verdict.md

verdict.md

81 lines · skills/bmad-prfaq/references/verdict.md at bd70c64

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1**Output Location:** `{doc_workspace}`
2**Coaching stance:** Be direct and honest — the verdict exists to surface truth, not to soften it. But frame every finding constructively.
3
4# Stage 5: The Verdict
5
6**Goal:** Step back from the details and give the user an honest assessment of where their concept stands. Finalize the PRFAQ document and produce the downstream distillate.
7

Output Location: {doc_workspace} Coaching stance: Be direct and honest — the verdict exists to surface truth, not to soften it. But frame every finding constructively.

Stage 5: The Verdict

Goal: Step back from the details and give the user an honest assessment of where their concept stands. Finalize the PRFAQ document and produce the downstream distillate.

Raw lines 1 to 7
8## The Assessment
9
10Review the entire PRFAQ — press release, customer FAQ, internal FAQ — and deliver a candid verdict:
12**Concept Strength:** Rate the overall concept readiness. Not a score — a narrative assessment. Where is the thinking sharp and where is it still soft? What survived the gauntlet and what barely held together?
14**Three categories of findings:**
16- **Forged in steel** — aspects of the concept that are clear, compelling, and defensible. The press release sections that would actually make a customer stop. The FAQ answers that are honest and convincing.
17- **Needs more heat** — areas that are promising but underdeveloped. The user has a direction but hasn't gone deep enough. These need more work before they're ready for a PRD.
18- **Cracks in the foundation** — genuine risks, unresolved contradictions, or gaps that could undermine the whole concept. Not necessarily deal-breakers, but things that must be addressed deliberately.
20**Present the verdict directly.** Don't soften it. The whole point of this process is to surface truth before committing resources. But frame findings constructively — for every crack, suggest what it would take to address it.

The Assessment

Review the entire PRFAQ — press release, customer FAQ, internal FAQ — and deliver a candid verdict:

Concept Strength: Rate the overall concept readiness. Not a score — a narrative assessment. Where is the thinking sharp and where is it still soft? What survived the gauntlet and what barely held together?

Three categories of findings:

  • Forged in steel — aspects of the concept that are clear, compelling, and defensible. The press release sections that would actually make a customer stop. The FAQ answers that are honest and convincing.
  • Needs more heat — areas that are promising but underdeveloped. The user has a direction but hasn't gone deep enough. These need more work before they're ready for a PRD.
  • Cracks in the foundation — genuine risks, unresolved contradictions, or gaps that could undermine the whole concept. Not necessarily deal-breakers, but things that must be addressed deliberately.

Present the verdict directly. Don't soften it. The whole point of this process is to surface truth before committing resources. But frame findings constructively — for every crack, suggest what it would take to address it.

Raw lines 8 to 21
22## Finalize the Document
241. **Polish the PRFAQ** — ensure the press release reads as a cohesive narrative, FAQs flow logically, formatting is consistent
252. **Append The Verdict section** to the output document with the assessment
263. Update frontmatter: `status: "complete"`, `stage: 5`, `updated` timestamp

Finalize the Document

  1. Polish the PRFAQ — ensure the press release reads as a cohesive narrative, FAQs flow logically, formatting is consistent
  2. Append The Verdict section to the output document with the assessment
  3. Update frontmatter: status: "complete", stage: 5, updated timestamp
Raw lines 22 to 27
28## Produce the Distillate
30Throughout the process, you captured context beyond what fits in the PRFAQ. Source material for the distillate includes the `<!-- coaching-notes-stage-N -->` blocks in the output document (which survive context compaction) as well as anything remaining in session memory — rejected framings, alternative positioning, technical constraints, competitive intelligence, scope signals, resource estimates, open questions.
32**Always produce the distillate** at `{doc_workspace}/prfaq-{slug}-distillate.md`:
34```yaml
35---
36title: "PRFAQ Distillate: {project_name}"
37type: llm-distillate
38source: "prfaq-{slug}.md"
39created: "{timestamp}"
40purpose: "Token-efficient context for the initiative's requirements or a PRD"
41---
42```
44**Distillate content:** Dense bullet points grouped by theme. Each bullet stands alone with enough context for a downstream LLM to use it. Include:
45- Rejected framings and why they were dropped
46- Requirements signals captured during coaching
47- Technical context, constraints, and platform preferences
48- Competitive intelligence from discussion
49- Open questions and unknowns flagged during internal FAQ
50- Scope signals — what's in, out, and maybe for MVP
51- Resource and timeline estimates discussed
52- The Verdict findings (especially "needs more heat" and "cracks") as actionable items

Produce the Distillate

Throughout the process, you captured context beyond what fits in the PRFAQ. Source material for the distillate includes the <!-- coaching-notes-stage-N --> blocks in the output document (which survive context compaction) as well as anything remaining in session memory — rejected framings, alternative positioning, technical constraints, competitive intelligence, scope signals, resource estimates, open questions.

Always produce the distillate at {doc_workspace}/prfaq-{slug}-distillate.md:

---
title: "PRFAQ Distillate: {project_name}"
type: llm-distillate
source: "prfaq-{slug}.md"
created: "{timestamp}"
purpose: "Token-efficient context for the initiative's requirements or a PRD"
---

Distillate content: Dense bullet points grouped by theme. Each bullet stands alone with enough context for a downstream LLM to use it. Include:

  • Rejected framings and why they were dropped
  • Requirements signals captured during coaching
  • Technical context, constraints, and platform preferences
  • Competitive intelligence from discussion
  • Open questions and unknowns flagged during internal FAQ
  • Scope signals — what's in, out, and maybe for MVP
  • Resource and timeline estimates discussed
  • The Verdict findings (especially "needs more heat" and "cracks") as actionable items
Raw lines 28 to 53
54## Present Completion
56"Your PRFAQ for {project_name} has survived the gauntlet.
58**PRFAQ:** `{doc_workspace}/prfaq-{slug}.md`
59**Detail Pack:** `{doc_workspace}/prfaq-{slug}-distillate.md`
61**Recommended next step:** ask Sofia the Product Owner (`bmad-agent-po`) to write the initiative's requirements from the PRFAQ and detail pack, or update them if the initiative file exists; go through `bmad-prd` first only when the requirements still need drawing out."
63**Headless mode output:**
64```json
66 "status": "complete",
67 "prfaq": "{doc_workspace}/prfaq-{slug}.md",
68 "distillate": "{doc_workspace}/prfaq-{slug}-distillate.md",
69 "verdict": "forged|needs-heat|cracked",
70 "key_risks": ["top unresolved items"],
71 "open_questions": ["unresolved items from FAQs"]
73```

Present Completion

"Your PRFAQ for {project_name} has survived the gauntlet.

PRFAQ: {doc_workspace}/prfaq-{slug}.md Detail Pack: {doc_workspace}/prfaq-{slug}-distillate.md

Recommended next step: ask Sofia the Product Owner (bmad-agent-po) to write the initiative's requirements from the PRFAQ and detail pack, or update them if the initiative file exists; go through bmad-prd first only when the requirements still need drawing out."

Headless mode output:

{
  "status": "complete",
  "prfaq": "{doc_workspace}/prfaq-{slug}.md",
  "distillate": "{doc_workspace}/prfaq-{slug}-distillate.md",
  "verdict": "forged|needs-heat|cracked",
  "key_risks": ["top unresolved items"],
  "open_questions": ["unresolved items from FAQs"]
}
Raw lines 54 to 74
Names a skill bmad-agent-po :61
Names a skill bmad-prd :61
75## Stage Complete
77This is the terminal stage. If the user wants to revise, loop back to the relevant stage. Otherwise, the workflow is done.
79Run: `uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow.on_complete`
81If the resolved `workflow.on_complete` is non-empty, follow it as the final terminal instruction before exiting.

Stage Complete

This is the terminal stage. If the user wants to revise, loop back to the relevant stage. Otherwise, the workflow is done.

Run: uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow.on_complete

If the resolved workflow.on_complete is non-empty, follow it as the final terminal instruction before exiting.

Raw lines 75 to 81
Runs code scripts/resolve_customization.py :79