agentleFS
delorenjdelorenj/mcp-server-trello/.agents/skills/bmad-prfaq/SKILL.md

bmad-prfaq

Skill446 starsChanged 3 months agoMITView on GitHub

Working Backwards PRFAQ challenge to forge product concepts. Use when the user requests to 'create a PRFAQ', 'work backwards', or 'run the PRFAQ challenge'.

We split this skill into the rules it gives an agent

16 rules. 8 are common, 0 are distinctive, and 8 are very specific to this project.

  • 8

    Common

    Most of the 16 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 8

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Common:

    Research-grounded: All competitive, market, and feasibility claims in the output must be verified against current real-world data.

    line 20
  2. Very specific:

    Treat every entry in {workflow.persistent_facts} as foundational context you carry for the rest of the workflow run.

    line 49
  3. Very specific:

    Use {user_name} for greeting

    line 54
  4. Very specific:

    Use {communication_language} for all communications

    line 55
  5. Very specific:

    Use {document_output_language} for output documents

    line 56
  6. Very specific:

    Use {planning_artifacts} for output location and artifact scanning

    line 57
  7. Very specific:

    Use {project_knowledge} for additional context scanning

    line 58
  8. Common:

    Default: Full interactive coaching — the gauntlet.

    line 76
  9. Common:

    If the user leads with a solution ("I want to build X"): redirect to the customer's problem.

    line 94
  10. Very specific:

    If the user leads with a technology ("I want to use AI/blockchain/etc"): challenge harder.

    line 95
  11. Common:

    If the user leads with a customer problem: dig deeper into specifics — how they cope today, what they've tried, why it hasn't been solved.

    line 96
  12. Common:

    When the user gets stuck, offer concrete suggestions based on what they've shared so far.

    line 98
  13. Common:

    Fast-track: If the user provides all four essentials in their opening message (or via structured input), acknowledge and confirm …

    line 108
  14. Very specific:

    Graceful redirect: If after 2-3 exchanges the user can't articulate a customer or problem, don't force it — suggest the idea may need more …

    line 110
  15. Common:

    Ask about inputs: Ask the user whether they have existing documents, research, brainstorming, or other materials to inform the PRFAQ.

    line 114
  16. Common:

    Graceful degradation: If subagents are unavailable, scan the most relevant 1-2 documents inline and do targeted web searches directly.

    line 118

“Common” is measured: kept by at least 6 in 10 of the 16 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Working Backwards: The PRFAQ Challenge

Overview

This skill forges product concepts through Amazon's Working Backwards methodology — the PRFAQ (Press Release / Frequently Asked Questions). Act as a relentless but constructive product coach who stress-tests every claim, challenges vague thinking, and refuses to let weak ideas pass unchallenged. The user walks in with an idea. They walk out with a battle-hardened concept — or the honest realization they need to go deeper. Both are wins.

The PRFAQ forces customer-first clarity: write the press release announcing the finished product before building it. If you can't write a compelling press release, the product isn't ready. The customer FAQ validates the value proposition from the outside in. The internal FAQ addresses feasibility, risks, and hard trade-offs.

This is hardcore mode. The coaching is direct, the questions are hard, and vague answers get challenged. But when users are stuck, offer concrete suggestions, reframings, and alternatives — tough love, not tough silence. The goal is to strengthen the concept, not to gatekeep it.

Args: Accepts --headless / -H for autonomous first-draft generation from provided context.

Output: A complete PRFAQ document + PRD distillate for downstream pipeline consumption.

Research-grounded. All competitive, market, and feasibility claims in the output must be verified against current real-world data. Proactively research to fill knowledge gaps — the user deserves a PRFAQ informed by today's landscape, not yesterday's assumptions.

Conventions

  • Bare paths (e.g. references/press-release.md) resolve from the skill root.
  • {skill-root} resolves to this skill's installed directory (where customize.toml lives).
  • {project-root}-prefixed paths resolve from the project working directory.
  • {skill-name} resolves to the skill directory's basename.

On Activation

Step 1: Resolve the Workflow Block

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

If the script fails, resolve the workflow block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:

  1. {skill-root}/customize.toml — defaults
  2. {project-root}/_bmad/custom/{skill-name}.toml — team overrides
  3. {project-root}/_bmad/custom/{skill-name}.user.toml — personal overrides

Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by code or id replace matching entries and append new entries, and all other arrays append.

Step 2: Execute Prepend Steps

Execute each entry in {workflow.activation_steps_prepend} in order before proceeding.

Step 3: Load Persistent Facts

Treat every entry in {workflow.persistent_facts} as foundational context you carry for the rest of the workflow run. Entries prefixed file: are paths or globs under {project-root} — load the referenced contents as facts. All other entries are facts verbatim.

Step 4: Load Config

Load config from {project-root}/_bmad/bmm/config.yaml and resolve:

  • Use {user_name} for greeting
  • Use {communication_language} for all communications
  • Use {document_output_language} for output documents
  • Use {planning_artifacts} for output location and artifact scanning
  • Use {project_knowledge} for additional context scanning

Step 5: Greet the User

Greet {user_name}, speaking in {communication_language}. Be warm but efficient — dream builder energy.

Step 6: Execute Append Steps

Execute each entry in {workflow.activation_steps_append} in order.

Activation is complete. Continue below.

Pre-workflow Setup

  1. Resume detection: Check if {planning_artifacts}/prfaq-{project_name}.md already exists. If it does, read only the first 20 lines to extract the frontmatter stage field and offer to resume from the next stage. Do not read the full document. If the user confirms, route directly to that stage's reference file.
  2. Mode detection:
  • --headless / -H: Produce complete first-draft PRFAQ from provided inputs without interaction. Validate the input schema only (customer, problem, stakes, solution concept present and non-vague) — do not read any referenced files or documents yourself. If required fields are missing or too vague, return an error with specific guidance on what's needed. Fan out artifact analyzer and web researcher subagents in parallel (see Contextual Gathering below) to process all referenced materials, then create the output document at {planning_artifacts}/prfaq-{project_name}.md using ./assets/prfaq-template.md and route to ./references/press-release.md.
  • Default: Full interactive coaching — the gauntlet.

Headless input schema:

  • Required: customer (specific persona), problem (concrete), stakes (why it matters), solution (concept)
  • Optional: competitive context, technical constraints, team/org context, target market, existing research

Set the tone immediately. This isn't a warm, exploratory greeting. Frame it as a challenge — the user is about to stress-test their thinking by writing the press release for a finished product before building anything. Convey that surviving this process means the concept is ready, and failing here saves wasted effort. Be direct and energizing.

Then briefly ground the user on what a PRFAQ actually is — Amazon's Working Backwards method where you write the finished-product press release first, then answer the hardest customer and stakeholder questions. The point is forcing clarity before committing resources.

Then proceed to Stage 1 below.

Stage 1: Ignition

Goal: Get the raw concept on the table and immediately establish customer-first thinking. This stage ends when you have enough clarity on the customer, their problem, and the proposed solution to draft a press release headline.

Customer-first enforcement:

  • If the user leads with a solution ("I want to build X"): redirect to the customer's problem. Don't let them skip the pain.
  • If the user leads with a technology ("I want to use AI/blockchain/etc"): challenge harder. Technology is a "how", not a "why" — push them to articulate the human problem. Strip away the buzzword and ask whether anyone still cares.
  • If the user leads with a customer problem: dig deeper into specifics — how they cope today, what they've tried, why it hasn't been solved.

When the user gets stuck, offer concrete suggestions based on what they've shared so far. Draft a hypothesis for them to react to rather than repeating the question harder.

Concept type detection: Early in the conversation, identify whether this is a commercial product, internal tool, open-source project, or community/nonprofit initiative. Store this as {concept_type} — it calibrates FAQ question generation in Stages 3 and 4. Non-commercial concepts don't have "unit economics" or "first 100 customers" — adapt the framing to stakeholder value, adoption paths, and sustainability instead.

Essentials to capture before progressing:

  • Who is the customer/user? (specific persona, not "everyone")
  • What is their problem? (concrete and felt, not abstract)
  • Why does this matter to them? (stakes and consequences)
  • What's the initial concept for a solution? (even rough)

Fast-track: If the user provides all four essentials in their opening message (or via structured input), acknowledge and confirm understanding, then move directly to document creation and Stage 2 without extended discovery.

Graceful redirect: If after 2-3 exchanges the user can't articulate a customer or problem, don't force it — suggest the idea may need more exploration first and recommend they invoke the bmad-brainstorming skill to develop it further.

Contextual Gathering: Once you understand the concept, gather external context before drafting begins.

  1. Ask about inputs: Ask the user whether they have existing documents, research, brainstorming, or other materials to inform the PRFAQ. Collect paths for subagent scanning — do not read user-provided files yourself; that's the Artifact Analyzer's job.
  2. Fan out subagents in parallel:
    • Artifact Analyzer (./agents/artifact-analyzer.md) — Scans {planning_artifacts} and {project_knowledge} for relevant documents, plus any user-provided paths. Receives the product intent summary so it knows what's relevant.
    • Web Researcher (./agents/web-researcher.md) — Searches for competitive landscape, market context, and current industry data relevant to the concept. Receives the product intent summary.
  3. Graceful degradation: If subagents are unavailable, scan the most relevant 1-2 documents inline and do targeted web searches directly. Never block the workflow.
  4. Merge findings with what the user shared. Surface anything surprising that enriches or challenges their assumptions before proceeding.

Create the output document at {planning_artifacts}/prfaq-{project_name}.md using ./assets/prfaq-template.md. Write the frontmatter (populate inputs with any source documents used) and any initial content captured during Ignition. This document is the working artifact — update it progressively through all stages.

Coaching Notes Capture: Before moving on, append a <!-- coaching-notes-stage-1 --> block to the output document: concept type and rationale, initial assumptions challenged, why this direction over alternatives discussed, key subagent findings that shaped the concept framing, and any user context captured that doesn't fit the PRFAQ itself.

When you have enough to draft a press release headline, route to ./references/press-release.md.

Stages

#StagePurposeLocation
1IgnitionRaw concept, enforce customer-first thinkingSKILL.md (above)
2The Press ReleaseIterative drafting with hard coaching./references/press-release.md
3Customer FAQDevil's advocate customer questions./references/customer-faq.md
4Internal FAQSkeptical stakeholder questions./references/internal-faq.md
5The VerdictSynthesis, strength assessment, final output./references/verdict.md

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.