Domain-Concept Bridge
About this pattern
This is a generated FPF pattern page projected from the published FPF source. It is canonical FPF content for this ID; it is not a FPF Reference product feature page.
How to use this pattern
Read the ID, status, type, and normativity first. Use the content for exact wording, the relations for adjacent concepts, and citations to keep active work grounded without pasting the whole specification.
FPF keeps a small set of admitted U-kinds, ontics, slot relations, mechanisms, characteristics, methods, work values, epistemes, and publication-use relations. Working domains use their own words. A thermodynamicist says "system", "macrostate", "control volume", and "free energy"; a safety engineer says "hazard", "mitigation", and "assurance case"; a software team says "service", "endpoint", and "release".
Keywords
- domain vocabulary
- concept bridge
- local sense
- bounded context
- bridge scope
- role assignment boundary.
Relations
Content
Problem Frame
FPF keeps a small set of admitted U-kinds, ontics, slot relations, mechanisms, characteristics, methods, work values, epistemes, and publication-use relations. Working domains use their own words. A thermodynamicist says "system", "macrostate", "control volume", and "free energy"; a safety engineer says "hazard", "mitigation", and "assurance case"; a software team says "service", "endpoint", and "release".
Those words are useful. The problem starts when one local word is silently treated as a new root kind, a role assignment, a characteristic, a method, a work occurrence, an evidence relation, or a publication claim without saying which FPF value the claim uses.
Problem
How can FPF let project teams keep domain vocabulary while preserving the current FPF ontology? A dictionary-style alias is too weak because it only says that two labels are being associated. It does not say whether the claim concerns an entity, a kind, a slot filler, a characteristic coordinate, a role assignment, a method, a mechanism, a work plan, a performed work occurrence, an episteme, a publication-use relation, or an evidence-use relation.
Forces
Solution
Use a Domain-Concept Bridge. Start with the local word in its U.BoundedContext, then recover the FPF value that the project is actually using.
- Establish the bounded context and local sense: use
F.1to identify the domain family and authoritative sources,F.2to harvest terms with provenance, andF.3to cluster the local sense or SenseCell with counter-examples. - Ask what the local word is doing in the current claim: naming an entity, admitted U-kind, ontic slot filler, relation, characteristic coordinate, method, mechanism, work plan, performed work, role assignment, episteme, publication-use relation, evidence-use relation, or other governed value.
- If the claim needs durable kindhood, use admission under
E.24.UKandC.3and supply the ontic and slot relation that make the kind reviewable. - If the claim is only local vocabulary, keep it as a LocalSense or SenseCell and bridge it with scope and loss notes.
- Use role vocabulary for system or holon role assignments in bounded work-facing contexts. Express meaning, status, evidence use, publication use, and domain interpretation through their own FPF values and relations.
The bridge record is therefore not an alias. It is a small typed settlement saying which FPF value the claim uses, what local wording points to it, where the bridge is admissible, and when the stronger source or direct governing pattern must be reopened.
Practical difference from an alias:
- An alias says "
Lis another name forV." - A Domain-Concept Bridge says: in bounded context
K, local wordingLis being used for FPF value or relationVin the current claim; the bridge carries the constraints, units, role assignments, loss notes, and return conditions that make that use reviewable. - If a component is called "sensor", the bridge can point to a system, a functional element, a measurement capability, a signal publication, or a role assignment. The claim decides which value is being used; the word "sensor" alone does not.
Archetypal Grounding
A thermodynamics team models a heat engine.
- "Thermodynamic system" names the engine as the entity under thermodynamic concern in the current bounded context. The bridge points to the same system or holon already used elsewhere, plus the thermodynamic boundary and state variables that matter here. It is not automatically a role.
- "Macrostate" names a state description or characteristic bundle over pressure, volume, temperature, and particle amount. The bridge records the reference scheme and units.
- "Control volume" may name a boundary or region relation. The bridge must say which entity is bounded and which exchanges cross the boundary.
- "Free-energy objective" may name an objective claim, characteristic, or selection criterion. The bridge must say which FPF value the decision uses.
- If the engine control system is assigned the role of heat-source controller in a work context, that is a separate
U.RoleAssignment(holderRef, roleRef, boundedContextRef)claim.
Current physical-system claims in this example use A.1 for system identity, A.14 and A.22 for composition and boundary relations, A.3.4 for state and dynamics, B.1.6 for work-resource aggregation, and C.16 for measured characteristics. Planned C.1 (Sys-CAL) may later consolidate that guidance; it is not a current governor.
What this achieves:
- Domain constraints become reviewable without turning every domain word into a root kind.
- Verification can use the governing pattern for the recovered value: boundary discipline for a control volume, characteristic-space discipline for state variables, role-assignment discipline for controller work, and publication-use or evidence-use discipline for reports and dashboards.
- The heat engine remains the same system or holon when a power-plant architecture, finance model, safety case, and thermodynamics model all discuss it. Bridges record which local meanings travel across those contexts and which losses block substitution.
The same local word can be reused in an architecture view, a requirements document, and a simulation model only after the bridge states whether those uses point to the same entity, the same characteristic, the same role assignment, or merely related descriptions.
Conformance Checklist
- CC-B5.3.1 (Recover the FPF value used by the claim): A bridge row names the current FPF value or slot relation before naming the preferred wording.
- CC-B5.3.2 (No kindhood by spelling): A local term, dotted name, table row, or diagram label does not become a U-kind unless admission under
E.24.UKandC.3supplies the ontic and the needed slot relation. - CC-B5.3.3 (Role boundary): Role language is used for system or holon role assignments in bounded work and method contexts; other uses are expressed through their own FPF values or relations.
- CC-B5.3.4 (Scope and loss): A bridge records context, scope, loss, and return conditions; it does not claim lossless sameness by name alone.
- CC-B5.3.5 (Description boundary): If the local word appears in a requirement, diagram, dashboard, report, or publication, the bridge keeps the described entity distinct from the description and publication form.
Common Anti-Patterns and How to Avoid Them
Consequences
Rationale
The bridge implements open-ended parsimony: FPF can talk with many domains without turning every useful domain word into a kernel kind. It keeps role vocabulary inside role-assignment ontology; domain vocabulary is mediated through local senses, bridge rows, admitted U-kinds, ontics, slot relations, and the FPF values governed by direct patterns.
Relations
- Builds on:
A.2,A.2.1,A.6.5,C.3,E.24.UK,F.1,F.2,F.3,F.5,F.8,F.18. - Coordinates with:
A.7,C.2.1,E.17,A.13,A.15,B.3.3,F.7,F.9, and domain-specific CHR, LOG, and CAL patterns. - Used when: a project term must be carried across bounded contexts, documents, diagrams, models, evidence records, or pattern applications without losing its governed FPF value.
B.5.3:End
Last Updated: 2026-08-04 — upstream FPF commit 8b727cba (github.com/ailev/FPF)