Skip to main content

The BRD Sections

A Logic Context BRD is organized into up to 11 sections, each written by a dedicated specialist agent. Sections can be enabled, disabled, renamed, and reordered per project, and at least one must remain enabled. This page describes what each section covers, how requirements are identified and traced, and the special treatment business processes receive.

The 11 sections

SectionWritten byWhat it documents
Business ProcessesBusinessProcessesAgentEach process as a business definition, plus process-mining insights (personas, paths, decision points, bottlenecks)
Logic FlowsWorkflowsAgentSystem workflows: what each flow does, its inputs, outputs, and behavior
Logic BlocksBusinessRulesAgentBusiness rules: validations, validation sets, formulas, decision tables, and decision trees
SchedulesSchedulesAgentScheduled jobs: what runs, when, and why
Events DefinitionsEventsAgentThe events the system defines and their properties
Event HandlersEventHandlersAgentHow events are wired to the flows that respond to them
ConfigurationsConfigurationsAgentConfiguration values and what they control
Localized ResourcesLocalizationAgentLocalized strings and the languages they cover
Service ConnectionsIntegrationsAgentExternal integrations and the services they reach
RecipesRecipesAgentLogic recipes: the entity hooks that run business logic on data changes
Data ModelDataModelAgentThe entities and fields the project uses

Each Flowon artifact type maps to a familiar business-documentation concept, so the reader sees requirements, not platform internals. Field names, codes, and configuration keys are translated into plain language in the prose, while the underlying identifiers remain available through traceability.

Process-mining insights

The Business Processes section goes beyond a static description. For every process, Logic Context derives and documents:

  • Personas: the roles and actors involved in the process.
  • Happy path: the intended, shortest successful route through the process.
  • Critical path: the longest or slowest route.
  • Decision points: where the process branches and on what conditions.
  • Automation coverage: how much of the process runs automatically.
  • Bottleneck risks: the stages most likely to slow the process down.

These insights are what turn a process description into something a stakeholder can reason about and improve.

Traceability

Every generated requirement carries a traceability block that links it back to the exact Flowon artifact it was derived from, including the original artifact name. This is what makes the document auditable: a reviewer can follow any requirement in the BRD straight to the configuration that produced it. The document reads in business language, but nothing in it is disconnected from the real system.

The artifact ID scheme

Every documented artifact receives a stable identifier, so requirements can be referenced precisely across the document and in review. The default prefixes are:

FamilyPrefixFamilyPrefix
Business processesBPSchedulesSJ
Logic flowsWFEventsEV
ValidationsBREvent handlersEH
Validation setsVSConfigurationsCF
FormulasCALocalized resourcesLR
Decision tablesDTIntegrationsIN
Decision treesDXData model entitiesDE

Each prefix is overridable per project (letters, digits, and hyphens, up to 8 characters), so the document can follow your own numbering conventions. The synthesis step also computes cross-section dependency references, so the document reads as one connected whole rather than eleven disconnected lists.