Skip to content
Skills Library
Management & product · Writing

write-brd

/write-brd

Write a practical Business Requirements Document (BRD) from a product idea, feature concept, customer request, business problem, or rough product opportunity. Use when the user asks to write, draft, generate, refine, or save a BRD/business requirements document/product business case in Markdown, especially when the output should be saved under the current project's markdown directory and include diagrams using Mermaid, SVG, or ASCII.

Repository
blog ↗
Licence
LGPL
Last repository change
21.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 21.10.2026, without references to retired models or APIs.

Licence

LGPL, otwarta.

What it does and when to use it

Write a practical Business Requirements Document (BRD) from a product idea, feature concept, customer request, business problem, or rough product opportunity. Use when the user asks to write, draft, generate, refine, or save a BRD/business requirements document/product business case in Markdown, especially when the output should be saved under the current project's markdown directory and include diagrams using Mermaid, SVG, or ASCII.

Original author description

Write a practical Business Requirements Document (BRD) from a product idea, feature concept, customer request, business problem, or rough product opportunity. Use when the user asks to write, draft, generate, refine, or save a BRD/business requirements document/product business case in Markdown, especially when the output should be saved under the current project's markdown directory and include diagrams using Mermaid, SVG, or ASCII.

How it works

  1. Purpose
  2. Default Output
  3. Workflow
  4. Evidence Rules
  5. Writing Style
  6. Minimum BRD Sections
Original SKILL.md headings · 123 lines, 826 words
SKILL.md preview
---
name: write-brd
description: "Write a practical Business Requirements Document (BRD) from a product idea, feature concept, customer request, business problem, or rough product opportunity. Use when the user asks to write, draft, generate, refine, or save a BRD/business requirements document/product business case in Markdown, especially when the output should be saved under the current project's markdown directory and include diagrams using Mermaid, SVG, or ASCII."
---

# Write BRD

## Purpose

Turn a rough product idea into a decision-ready BRD Markdown file saved in the current project's `markdown/` directory. The BRD should help stakeholders decide whether to invest, what user problem is real, what scope is in or out, and how success will be verified after launch.

This skill writes BRDs, not PRDs. Keep implementation detail high enough for feasibility and handoff, but do not expand into screen-by-screen product specs unless the user asks.

## Default Output

- Save one Markdown file to `markdown/<topic>-BRD-<YYYYMMDD>.md`.
- Use a Chinese topic name when the user writes in Chinese; otherwise use kebab-case English.
- Include at least one useful diagram inside the BRD.
- Use Mermaid by default. Use ASCII for tiny flows. Use SVG only when layout or richer visual explanation is needed.
- If using SVG, save it as a separate file in the same `markdown/` directory, named `figure-1-<topic>-BRD-<YYYYMMDD>.svg`, then reference it from the Markdown with `![描述](figure-1-<topic>-BRD-<YYYYMMDD>.svg)`.

## Workflow

### 1. Clarify the idea just enough

If the user's idea is too thin to write a credible BRD, ask at most 3 questions. Prefer assumptions over long interrogation.

Ask only for missing information that changes the BRD materially:
- Target user or customer
- Business goal or pain point
- Product context or company type
- Constraints such as time, budget, compliance, existing systems

If the user gives no detail beyond an idea, proceed with explicit assumptions and mark low-confidence sections.

### 2. Reframe the idea as a business decision

Before writing sections, convert the idea into this chain:

```text
business loss/opportunity -> target user -> current workaround -> proposed capability -> success metric -> delivery boundary -> stop/continue rule
```

Reject pure feature-first framing. Do not start the BRD from "we need feature X" unless you immediately explain why the business should fund it.

### 3. Build the BRD from three lenses

Use these lenses in every BRD:

1. **Investment lens**: What loss, revenue, cost, risk, or strategic option justifies the work?
2. **User evidence lens**: Who has the problem, in what scenario, what do they do today, and what behavior should change?
3. **Delivery lens**: What is in scope, what is out, what depends on other teams or systems, and how will completion be verified?

### 4. Use the BRD template

Read `assets/brd-template.md` when drafting the document. Adapt headings to the user's context, but keep the core decision logic intact.

For extra guidance on evidence, diagrams, validation, and wording, read `references/brd-writing-guide.md`.

### 5. Add diagrams that explain decisions

Every BRD must include at least one diagram that supports reasoning, not decoration. Good diagram choices:

- Business value chain: problem -> opportunity -> scope -> metric -> decision
- User workflow: current process -> pain point -> proposed process
- Scope boundary: in scope / out of scope / future phase
- Delivery dependency map
- Post-launch validation loop

Use Mermaid unless SVG is clearly better. If using SVG, create a standalone SVG file and reference it in Markdown.

### 6. Write success and stop conditions

Every BRD must include:

- Baseline metric or "baseline unknown; must be measured before build"
- Target metric and time window
- Data source or owner
- Launch success criteria
- Stop, shrink, or pivot condition

Do not let "launch completed" stand in for "business value achieved".

### 7. Save and verify

After writing the Markdown file:

- Confirm it exists under the current project's `markdown/` directory.
- Confirm at least one diagram exists in the Markdown.
- If any SVG is referenced, confirm the SVG file exists beside the Markdown file.
- Check that the BRD contains in-scope, out-of-scope, success metrics, risks, dependencies, and post-launch validation.
- Tell the user the saved file path and any assumptions made.

## Evidence Rules

- If current market data, competitor claims, regulations, pricing, or product facts matter, browse or otherwise verify with reliable sources before writing.
- If evidence cannot be verified, label it as an assumption instead of presenting it as fact.
- Prefer concrete observations over vague claims: "5 interviewed users spent 2-4 hours weekly reconciling data" is better than "users strongly need efficiency".
- Do not invent customer quotes, user counts, revenue, conversion rates, or benchmark data.

## Writing Style

- Write in clear, decision-oriented business language.
- Keep the BRD practical and readable; avoid inflated product management jargon.
- Use tables for structured scope, metrics, risks, dependencies, and milestones.
- Use concise paragraphs for context and rationale.
- Separate "known facts", "assumptions", and "open questions".

## Minimum BRD Sections

If adapting the template, keep these sections at minimum:

1. Title and one-line decision
2. Executive summary
3. Background and business problem
4. Target users and evidence
5. Objectives and success metrics
6. Proposed solution and alternatives
7. Scope: in, out, later
8. Requirements at BRD level
9. Dependencies and constraints
10. Risks and mitigations
11. Milestones and ownership
12. Post-launch validation
13. Open questions

Files in this package (4)
  • SKILL.md 6 KB
  • agents/openai.yaml 1 KB
  • assets/brd-template.md 4 KB
  • references/brd-writing-guide.md 5 KB

Versions

RepositoryScoreLicence
This page · digoal/blog100LGPL
digoal/blog100LGPL

Database snapshot: 13.11.2026 · package version 32d4b434b18e (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100write-prd
    Write a practical Product Requirements Document (PRD) from a product idea, feature concept, customer request, business problem, or rough product opportunity. Use when the user asks to write, draft, create, generate, or save a PRD, product requirements document, product spec,…
  • 100brd-writer
    Write a Business Requirements Document. Use when the user says "write a BRD", "business requirements", "document the business need", "vision and scope document", "business case for this feature", "what does the business need", "strategic requirements", "document why we need…
  • 90brd
    Generates a comprehensive Business Requirement Document (BRD) from a business plan using parallel agent teams. This skill should be used when the user asks to "generate BRD", "create business requirements document", "run Stage 1", "generate business requirements", "create BRD…
  • 90write-mrd
    Generate a market requirements document (MRD) from a product idea and save it as Markdown under the current project's markdown/ directory. Use when the user asks to write, draft, create, produce, or refine an MRD, market requirements document, product opportunity document,…
  • 100capturing-business-requirements
    Captures what a business explorer knows as structured documents: business requirements (BRD with rules, constraints, assumptions), user stories with acceptance criteria, Mermaid workflow diagrams, and prototype observation notes. Use when the user says "capture requirements",…
  • 10003-brd-generation
    Use when a Business Requirements Document is needed to bridge strategy and detailed requirements; use prd-generation for product scope and user value, or initialize-srs for formal system specification.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.