EntityOfConcern, Description Episteme, and Specification-Use Discipline
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.
Status: Stable
Definitional pattern - normative, notation-agnostic
One-sentence summary. For any
EntityOfConcernin FPF, keep the entity under concern distinct from theDescriptionepisteme that describes it in a bounded context and viewpoint, and admit...Specwording only for a Description episteme whose specification use is made checkable by explicit conditions. Specification is not a third peer ontology class beside the entity and its Description episteme.
Status. Definitional pattern. Builds on: A.7 Strict Distinction (Clarity Lattice); E.10.D1 D.CTX (Context is U.BoundedContext); C.2.1 U.EpistemeSlotRelation; C.2.3 Unified Formality Characteristic (F); F.15 conformance and regression harness discipline. Coordinates with. F.4 Role Description; F.5 Naming Discipline; F.12 Service Acceptance Binding; F.9 Alignment & Bridge across Contexts; F.9.1 Bridge Stance Overlay; F.10 Status Families Mapping. Non-goals. This pattern does not define editors, work-process descriptions, registries, storage formats, or publication carriers. It gives the boundary discipline that other FPF patterns use when they name an entity, its Description episteme, and any specification-use admission.
Use this pattern when FPF-governed wording names something under concern and also names a description, view, specification, publication, file, card, diagram, dashboard, work record, evidence item, assurance result, gate result, or decision around it.
Keywords
- EntityOfConcern
- Description episteme
- specification use
- DescriptionContext
- testable
- verifiable.
Relations
Content
Problem frame
Use this pattern when FPF-governed wording names something under concern and also names a description, view, specification, publication, file, card, diagram, dashboard, work record, evidence item, assurance result, gate result, or decision around it.
The first useful move is to ask five questions:
- What is the
EntityOfConcern? - Which Description episteme describes it, if describing is live?
- Which
DescriptionContext = <EntityOfConcernRef, BoundedContextRef, ViewpointRef>bounds that description? - Is specification use admitted by explicit checkability, acceptance, validation, formality, or harness conditions, or is this only a Description episteme?
- Which neighboring FPF pattern carries any publication, carrier, evidence, assurance, gate, decision, commitment, promise, work, view, bridge, retargeting, or state-family claim?
Not this pattern when the question under repair is already an evidence path named by value, assurance claim, gate decision, commitment, work occurrence, bridge, representation transition, source relation, or state-family field. Use the neighboring pattern governing that claim for that claim and use E.10.D2 only to keep the EntityOfConcern, Description episteme, and specification-use boundary readable.
FPF frequently has to say that some item is being described: a role, method, system, work occurrence, promise content, characteristic, architecture, episteme, view, or another FPF entity. The old short memory of "entity, description words, and rules" remains useful, but it becomes harmful when it is taught as three peer kinds.
The working distinction is sharper:
- the EntityOfConcern is the item under concern;
- the Description episteme is the claim-bearing episteme that describes that item under one bounded context and viewpoint;
- specification use is an admitted use or refinement of a Description episteme, not a separate peer class;
- publication faces, publication forms, carriers, renderings, work occurrences, gate decisions, evidence relations, and assurance claims remain outside this boundary unless a neighboring pattern makes one of them the EntityOfConcern.
This matters whenever wording such as RoleDescription, ArchitectureDescription, MethodSpec, ServiceSpec, "the diagram is the architecture", "the card authorizes work", or "the file is the method" could make readers confuse the item under concern with a description, a publication, a carrier, a work occurrence, or a granted use.
What goes wrong if E.10.D2 is missed: specification-looking words become authority, a publication becomes the thing described, a file becomes the method, an approval state over an episteme becomes a runtime state, or two descriptions with the same label are treated as the same EntityOfConcern across contexts.
What E.10.D2 buys in practice: the practitioner can name the item under concern, keep the Description episteme inspectable, admit specification use only when checkability exists, and apply the governing FPF pattern for every other claim being made.
Problem
- Entity-description collapse. A text treats the
EntityOfConcernas if it were identical to the Description episteme, the diagram, the card, the file, or the work record. - Specification inflation. A text calls any detailed write-up a
...Specalthough no checkability, acceptance condition, or harness relation is present. - Publication or carrier substitution. A publication face, document, dashboard, schema file, or generated view is treated as the described entity or as the authority for work.
- Context and viewpoint loss. A Description episteme is read as global even though FPF descriptions are bounded by
DescriptionContext = <EntityOfConcernRef, BoundedContextRef, ViewpointRef>. - Status and state leakage. Epistemic or deontic statuses over epistemes are used as if they were role states, system states, or runtime facts about the EntityOfConcern.
Forces
Solution
For any sentence that names an entity and also names description, specification, view, publication, carrier, evidence, evaluation, or work:
- Name the EntityOfConcern. State what item is under concern: for example
U.Role,U.Method,U.System,U.Work,U.PromiseContent,U.Characteristic,U.ArchitectureOf@Context, orU.Episteme. - Name the Description episteme when describing is live. A
...Descriptionis aU.Epistemethat describes the EntityOfConcern underDescriptionContext = <EntityOfConcernRef, BoundedContextRef, ViewpointRef>. - Admit specification use only by conditions. A
...Specis a Description episteme admitted for specification use when checkability conditions are present. The conditions must name formal checkability or declared formality, checkable invariants or acceptance criteria, a validation or acceptance harness, and the same DescriptionContext. - Keep publication and carrier relations separate. A card, document, dashboard, diagram, file, rendering, API description, or interface declaration may publish, encode, render, or expose a Description episteme; it is not thereby the EntityOfConcern and it does not by itself create permission, evidence, gate, assurance, decision, commitment, or work.
- Apply the neighboring pattern when another claim becomes live. Evidence is governed by
A.10orG.6; assurance byB.3; status-family, standard-use, and requirement-use distinctions byF.10; publication and view mechanics byE.17,E.17.0,E.17.2, or their direct subpatterns; commitments and promises byF.18and related patterns; work, work plans, and work-facing role assignments byA.15,A.15.1,A.2, orA.2.1; retargeting byA.6.4.
When source wording says that a description, source, standard, requirement, evidence item, publication, dashboard, or view "has a role" or "plays a role", recover the typed relation first. It is normally evidence-use, status-use, source-use, publication-use, standard-use, requirement-use, assurance-use, gate-use, or work-relevance wording. Do not create a U.Role, U.RoleAssignment, or role-state value unless the current claim is about a system or acting holon holding a work-facing role in a bounded work context.
Ordinary minimum:
write one line that names the EntityOfConcern, the Description episteme or not live, the DescriptionContext or missing-context blocker, the specification-use admission value, and the neighboring FPF pattern governing that claim for any live non-description claim.
Stop at the boundary line when it makes the next admissible move clear. Open heavier episteme, publication, source, bridge, evidence, assurance, gate, decision, work, or state-family records only when those claims are being made.
Core field discipline
EntityOfConcern
EntityOfConcern means the item under concern in the current claim. It is not a universal "object" bucket and not an authoring target. It may be a system-side entity, an episteme, a relation, a characteristic, a work occurrence, a pattern, or another FPF kind named by value.
When the EntityOfConcern is itself an episteme, the same distinction still holds. The episteme under concern is not automatically identical to a Description episteme about that episteme, and a publication of that episteme is still a publication relation.
Description episteme
A Description episteme is a U.Episteme whose subjectRef is interpreted through:
It may carry labels, glosses, characterizations, state-machine diagrams, structural views, criteria, diagrams, examples, or other claim-bearing content about the EntityOfConcern. Those parts remain episteme content. They do not become parts of the EntityOfConcern unless a separate FPF pattern establishes that relation.
Specification-use admission
Use a ...Spec name only when the Description episteme is admitted for specification use under all applicable conditions:
- Checkability. The claimed invariants or acceptance conditions are checkable.
- Declared formality or equivalent discipline. The text states the formal mode, notation discipline, measurement criterion, comparator, or other named checkability condition that makes checking possible.
- Harness or validation relation. The text names the acceptance harness, conformance or regression check, validation method, measurement procedure, source-currentness/provenance record, or neighboring FPF relation that will check the specification use.
- Same DescriptionContext. The specification-use episteme preserves or explicitly updates
EntityOfConcernRef,BoundedContextRef, andViewpointRef.
If any condition is absent, use ...Description and state the live criteria informatively or as candidates without claiming specification use.
Publication, carrier, and work boundary
U.Carrier encodes an episteme. A publication face, publication form, or publication unit makes an episteme available. A rendering, UI rendering, or front-end view displays it. A work occurrence uses it or acts under it. None of those relations changes the EntityOfConcern or upgrades a Description episteme to specification use by itself.
Naming discipline
Default suffix. Use ...Description for a Description episteme unless specification-use admission is explicit.
Reserved suffix. Use ...Spec only for a Description episteme admitted for specification use. Do not use Spec as a synonym for "detailed", "important", "official-looking", "formal-looking", or "stored in a schema".
Entity names. Use the bare FPF kind named by value for the EntityOfConcern: Role, Method, System, Architecture, Characteristic, PromiseContent, Work, Episteme, or another kind named by value. Do not append Description, Spec, Card, View, or Carrier unless the episteme, view, publication, or carrier is the actual EntityOfConcern.
DescriptionContext names. Use EntityOfConcernRef, BoundedContextRef, and ViewpointRef for Description episteme addressing. Do not revive DescribedEntityRef, EntityOfInterest, or peer-layer I-D-S wording.
Invariants
D2-1 (Entity-description distinction). The EntityOfConcern and the Description episteme about it are distinct even when the EntityOfConcern is itself an episteme.
D2-2 (Specification is admitted use). Specification is not a peer class beside EntityOfConcern and Description episteme. A ...Spec is a Description episteme admitted for specification use.
D2-3 (DescriptionContext). A Description episteme names or recovers DescriptionContext = <EntityOfConcernRef, BoundedContextRef, ViewpointRef>.
D2-4 (Publication and carrier separation). Publication faces, publication forms, publication units, carriers, renderings, files, dashboards, UI renderings, and front-end views do not become the EntityOfConcern and do not grant specification use by appearance.
D2-5 (Work separation). A plan, checklist, or specification-use Description episteme does not execute work. Work occurrences and work results remain under work and P2W patterns.
D2-6 (Status-state separation). Epistemic and deontic statuses over epistemes are not role states, system states, or runtime facts unless the exact state pattern grants that interpretation.
D2-7 (No label-only cross-context sameness). Identical labels in two bounded contexts or viewpoints do not establish sameness. Use F.9 bridges, A.6.3 views, or A.6.4 retargeting as appropriate.
D2-8 (ReferencePlane reservation). Do not call this distinction a plane. Use ReferencePlane only where CHR or another governing pattern defines that field.
D2-9 (No episteme role shortcut). A description, source, standard, requirement, evidence item, publication, dashboard, or view does not hold a U.Role merely because source wording says it has a role. Recover the typed use relation and governing pattern; open U.RoleAssignment only for work-facing roles held by systems or acting holons.
Reasoning primitives
Description link.
TDesc is the Description episteme about EntityOfConcern T in bounded context C under viewpoint Vp.
Specification-use admission.
Only under those conditions may the episteme be named TSpec.
Characterization relation.
The role is characterized through the Description episteme. The structures are not silently parts of the role.
Evaluation relation.
Evaluation produces an attestation in a window. It does not mutate the EntityOfConcern.
Archetypal Grounding
System case. A service interface document describes a system interface. The system interface is the EntityOfConcern; the document is a Description episteme or publication relation; a deployment gate, assurance claim, or work authorization requires its own governing pattern.
Episteme case. A DRR, pattern, safety case, or source set can itself be the EntityOfConcern. A review note, dashboard, or PDF about it is then a Description episteme, publication relation, or carrier about that episteme, not the episteme's authority, evidence, or work result by appearance.
Bias-Annotation
The main bias is entity-description collapse: readers let a description, publication, carrier, source, standard, evidence item, dashboard, or view become the item under concern or a work-facing role holder. The corrective move is not lexical replacement; it is to recover the EntityOfConcern, DescriptionContext, specification-use admission, and any neighboring governed claim separately.
Anti-patterns and repairs
Worked examples
Role
U.Role :: ChangeAuthority is the EntityOfConcern. ChangeAuthorityRoleDescription@ITIL4 is a Description episteme with DescriptionContext = <EntityOfConcernRef(ChangeAuthority), BoundedContextRef(ITIL4), ViewpointRef(RoleViewpoint)>.
The Description episteme may characterize the role by credential level, mandate window, separation-of-duty criteria, and a role-state relation. The role does not contain the relation description or the checklist. If testable invariants and an acceptance harness are declared, a ChangeAuthorityRoleSpec@ITIL4 may be admitted for specification use.
Method
U.Method :: BacklogRefinement is the EntityOfConcern. A team note, practice card, or pseudo-code sketch is a BacklogRefinementMethodDescription@EssenceContext when it describes the method. It becomes BacklogRefinementMethodSpec@EssenceContext only when checkable method constraints and an acceptance or validation harness are present.
Calendar sessions, chat threads, and tickets are work occurrences or work records. They may use the method description, but they are not the method and not the Description episteme.
Architecture
ArchitectureOf@Context(Holon) is the EntityOfConcern. An architecture description, structural view, graph, ADR, or dashboard is a Description episteme, view, publication, or carrier about that architecture. The diagram does not become the architecture, and an ADR does not by itself create permission or assurance.
If a structural view uses a mathematical lens, C.29 carries the declared mathematical-lens use question. If an architecture description is used to guide work, A.15.4 and P2W-related patterns carry the work-relevance relation.
Episteme as EntityOfConcern
A safety case, DRR, pattern, or source set can itself be the EntityOfConcern. A review note describing that DRR is then a Description episteme about an episteme. A published PDF of the DRR is a carrier or publication relation. This prevents the common slide from "talking about a description" into "talking only about descriptions of descriptions".
Boundary-line replay slice
A project note says: "The architecture dashboard approves the deployment role." Applying E.10.D2 does not replace that phrase with one better noun. It recovers the typed FPF values and relations:
The practical delta is immediate: do not treat the dashboard as permission to deploy or as a role assignment. First name the exact evidence, assurance, gate, work, or publication relation being claimed; if none is present, keep only the description-publication use.
Consequences
Rationale
Specification is treated as admitted use of a Description episteme because this preserves the two-way distinction between the EntityOfConcern and the episteme that describes it. Making specification a third peer class would recreate the old I-D-S ontology and make publication appearance, formality, or approval labels look like authority. E.10.D2 therefore keeps the first move small: recover the EntityOfConcern, recover the Description episteme and context, admit ...Spec only under checkability conditions, and apply the neighboring governing pattern for any other claim.
SoTA-Echoing and source-use
| Source or practice line | FPF use | Boundary |
| --- | --- | --- |
| ISO/IEC/IEEE 42010-style architecture-description practice separates described architecture, stakeholder concern, viewpoint, view, model kind, correspondence, and architecture-description publication. | Adapt the separation as pressure for DescriptionContext, viewpoint, view, and correspondence discipline beyond architecture-only cases. | Does not make every Description episteme an architecture description and does not grant evidence, assurance, gate, decision, or work authority. |
| ISO/IEC/IEEE 29148:2018-style requirements engineering practice treats requirements and specifications as products tied to quality criteria, verification, validation, conformance, and life-cycle use. | Use ...Spec only when the Description episteme has explicit checkability, formality, criteria, comparator, harness, or neighboring-pattern gate. | A detailed or official-looking document is not specification use by name alone. |
| FPF episteme, publication, view, carrier, and source-use machinery (C.2.1, E.17, E.17.0, A.6.3, C.2.P) supplies the ontology named by value. | Reuse existing episteme slots, DescriptionContext, views, publication faces, publication forms, publication units, carrier separation, source relation, bridge, and retargeting pattern applications. | E.10.D2 does not mint a rival description ontology and does not replace source, evidence, bridge, work, or state-family patterns. |
| Andrey Rodin-style near-sameness and postulate-theory concerns motivate explicit same-EntityOfConcern and bridge checks across descriptions. | Same label, similar description, or shared formal substrate is not enough; use F.9, A.6.3, A.6.4, or same-EntityOfConcern recovery by value. | E.10.D2 names the boundary; it does not decide all cross-context sameness or mathematical-substrate adequacy. |
Currentness and reopen condition: reopen this source-use section when ISO/IEC/IEEE 42010, ISO/IEC/IEEE 29148, the FPF episteme/publication ontology, or the accepted same-EntityOfConcern and bridge discipline changes enough that DescriptionContext, specification-use admission, publication separation, or same-EoC recovery would be stated differently.
Relations
Builds on:
- A.7 - Strict Distinction (Clarity Lattice). Supplies the general distinction between an EntityOfConcern and the epistemes, publications, carriers, work, decisions, evidence, and assurance claims around it.
- C.2.1 - U.EpistemeSlotRelation. Supplies
DescriptionContext,subjectRef, and episteme slot discipline. - C.2.3 - Unified Formality Characteristic. Supplies formality levels used by specification-use admission.
- F.15 - conformance and regression harness discipline. Supplies check and regression-check harness discipline.
Coordinates with:
- A.6.2, A.6.3, and A.6.4. Description epistemes can be transformed, viewed, or retargeted only under their episteme-morphism laws.
- E.17 and E.17.0. Publication, view, face, form, unit, and carrier relations remain separate from the EntityOfConcern and Description episteme.
- F.9. Cross-context relation or near-sameness requires a bridge, not label reuse.
- F.4, F.5, F.8, and F.10. Role, service, naming, acceptance, and evaluation patterns consume this boundary when they name descriptions and specifications.
Current repair moves
Use these repairs when live FPF prose violates this pattern:
-
Replace old
DescribedEntity*,EntityOfInterest,EoI, andEoIClasswording withEntityOfConcern,EntityOfConcernRef,EntityOfConcernClass, or the local FPF kind named by value. Retain old spellings only as source-side trigger wording. -
Replace peer-layer I-D-S wording with EntityOfConcern, Description episteme, and specification-use admission wording.
-
Replace "contains role characteristic space, role-state relation, or checklist" with "is characterized through the Description episteme by role characteristic space, role-state relation, or checklist".
-
Replace carrier identity with "carrier encodes" or "publication exposes" wording.
-
Replace generic "object under description" talk with the EntityOfConcern named by value and its
DescriptionContext. -
Replace
...Specnames that lack specification-use admission with...Description. -
For permission, evidence, assurance, gate, decision, promise, commitment, work, publication, view, bridge, or retargeting claims, apply the neighboring pattern governing that exact claim instead of keeping the claim as local semio guard prose.
-
Replace "role of this description, source, standard, evidence, or publication" wording with the exact typed relation: evidence-use, status-use, source-use, publication-use, standard-use, requirement-use, assurance-use, gate-use, or work-relevance relation. Use
U.RoleAssignmentonly for work-facing roles held by systems or acting holons.
Conformance checklist
Phrasebook
Didactic memory
Use the short memory entity, description, and admitted specification use:
- Entity. What item is under concern?
- Description. Which episteme describes it, in which bounded context and viewpoint?
- Admitted specification use. What makes a
...Speccheckable here? - Publication and carrier. What only exposes, renders, stores, or transports the episteme?
- Neighboring claims. Which evidence, assurance, gate, decision, commitment, work, bridge, view, or retargeting pattern carries any additional claim being made?
E.10.D2:End
Last Updated: 2026-06-17 — this section last modified in upstream FPF commit 205de763 (github.com/ailev/FPF)