Skip to content

Reference

Document Templates

Use this page to find a shipped template to copy, or to see how a template does something you want. Modules ship them, each in the doc-templates/ folder beside its bmod.toml in your skills folder: bmod-method, bmad-founder-agent-advisor or bmod-cis.

To change one for your team, extend it instead of copying it, so its updates keep arriving; Customize a Document for Your Team shows how. To start a different document from one, copy it into _bmad/custom/facilitate-templates/ with a new template: id and edit the copy. Write a Document Template covers the file format.

TemplateModuleUse it for
decision-recordBMad MethodRecording a choice, the alternatives and what it costs
postmortemBMad MethodLearning from something that went wrong, without blame
security-reviewBMad MethodChecking a system against the OWASP Top 10 or STRIDE
proposalFounderAsking for money, time or approval
pitch-deckFounderA talk or pitch with slides
accelerator-applicationFounderAn application to an accelerator, in the program’s own questions
board-packFounderThe pre-read sent before a board meeting
cofounder-agreementFounderCo-founders agreeing roles, decisions, equity and leaving before a lawyer drafts
customer-interview-scriptFounderA customer interview guide built on past behaviour
first-hireFounderDeciding whether to hire now, and the scorecard, cost and test for the role
fundraising-planFounderPlanning a raise: amount, milestones, instrument, investors and stop date
ideal-customerFounderThe first narrow group of customers to win and how to reach them
investor-updateFounderThe monthly or quarterly update to investors and advisors
launch-planFounderTaking a product to market
lean-canvasFounderThe whole business model on one page, with its riskiest assumption
ninety-day-planFounderTwo or three goals for the next ninety days, with metrics and owners
positioningFounderPositioning and the one-liner
pricingFounderHow the product is priced and how the price is tested
startup-diagnosticFounderHard questions on whether an idea has real demand, ending in one dated assignment
validation-experimentFounderTesting whether people will pay or act, with the pass mark set first
characterCreative Intelligence Suite 0.4.0 and laterA fictional character for a story, game or campaign, on a one-page sheet

The BMad Method also ships the planning templates for John, the Product Manager (bmad-agent-pm), and Mary, the Business Analyst (bmad-agent-analyst). The templates live in the method module’s doc-templates/ folder, and each names the agents that offer it in agents. Mary writes the documents that decide whether and why to go ahead; John writes the ones that define what gets built and how it ships. The list says who offers each by default; either writes any of them when you ask. Both agents hand every create, update, and validate to bmad-facilitate, so each document works the same way. Write a PRD shows the coaching and fast paths, stakes, and assumption tags they share.

DocumentWhoLevelFits
Opportunity assessmentMaryInitiativeWhether a problem is worth pursuing, before any solution
Experiment cardMary or JohnAnyA measured test of one hypothesis, its thresholds set before it runs
Prototype planJohnAnyA quick build to test an idea, some options, or a look and feel
PRFAQMaryBefore an initiativeWhether a concept survives scrutiny, working back from its press release
BriefMaryBefore an initiativeWhy to build a product, or pitching it, in a page or two
Business caseMaryInitiativeA funding decision: cost, expected return, go or no-go
Strategy narrativeMaryProgramA written argument for leadership to decide a strategy or annual plan
PRD, light PRDJohnAnyRequirements a team builds from; the light one for a very simple project
Shape Up pitchJohnInitiative or epicA shaped, time-boxed proposal for teams that bet fixed cycles
Program charterMary or JohnProgramOne mandate, benefits, scope, and governance across several initiatives
Requirements specificationJohnInitiativeTraceable, verifiable requirements for regulated or contracted work
Business requirements documentMaryInitiativeWhat the business requires and signs for, when a separate party builds, a sponsor signs, or a regulator or contract expects it
Spec for a coding agentJohnOne featureA feature outside the ticket tree, with tests and acceptance
Launch planJohnInitiativeCoordinating a built feature’s release across teams

The first seven come before you commit, in Clarify; the rest plan and ship the work. The brief, the PRFAQ, the experiment card, the opportunity assessment, and the pitch are walked one section at a time, in order. A brief from Mary feeds the PRD, but neither requires the other. A business case or strategy narrative stays in prose and ends with a ## For requirements list of ids, so Sofia can write the initiative from it without a PRD.

To do thisLook atHow it works
Press the user on a thin answerpostmortem, Contributing factorsThe section comment says when to push and what to ask
Make the user pick from a listdecision-record, StatusThe section comment names the allowed values
Make the user pick from a sourcesecurity-review, Scope and systemThe section comment points at the method catalog
Drive questions from a catalogsecurity-review, methods-security.csvThe methods frontmatter names a CSV of key questions
Walk the sections in order, each with its own voiceprfaq in bmod-method/doc-templates/paced: true in the frontmatter, and each section comment is the brief for that part
Change how a path runssecurity-review, stanceThe comment says what the fast path does for this document
Use the shared planning rulesAny shipped templateguidance: guidance-planning adds stakes levels, ids and testable requirements
Review against its own rubricproposal, rubric-proposal.mdThe rubric frontmatter names the file
Set the order and what is requiredAny shipped templatefacilitation_order lists the sections by id, ? on those not required
Include a section only when it appliesproposal, Alternativesalternatives? in the order and an include when: section comment
Draw a diagrampostmortem, TimelineA diagram: kind in the section comment
Add a table of contentsproposalA bare ## Table of Contents heading after the title
Render as slidespitch-deckview: slides in the frontmatter
Always make the viewpitch-deckhtml_view: always in the frontmatter, because the slides are the deliverable
Render the same layout every timeprfaq in bmod-method/doc-templates/, prfaq-view.html; also brief and pitchview names an HTML file whose slots a script fills at close
Have a page written for each documentcharacter, character-sheet.htmlview names a starter, and a view comment gives the brief
Have a page written from a brief aloneFounder’s templates, such as pitch-deckA view comment with no view file says where to be creative
Propose rather than only askcharacter, stanceThe comment invites proposals; one the user accepts is theirs
Write several filespostmortem, companionsThe comment says when to write the customer notice and what it holds

No shipped template adds to another. Extend a template shows how.