FPF.Reference:2 - FPF As A Project, Not Only A Pattern List
Preface node
heading:fpf-reference-2-fpf-as-a-project-not-only-a-pattern-list:1165
What this page is
This is generated FPF reference text from the specification preface or supporting sections. It helps interpret FPF; it is not FPF Reference product documentation.
Methodology
Use it to understand how the specification wants to be read, then return to a route, pattern, or work packet for active work. Cite generated IDs only when the wording changes the task decision.
Content
The FPF development project aims to improve how difficult reasoning is written, checked, taught and used by humans and AI agents. The Core Specification is the normative center of that project, but it is not the whole project.
The Core Specification gives the pattern language: the named concepts, distinctions, pattern bodies, conformance checks, and relations that make FPF usable across domains. It says what the reasoning objects are and how exact claims are constituted and checked. When a project needs to know whether a diagram is architecture, whether a dashboard is evidence, whether a model output may be used for a decision, or whether a term is hiding several kinds, the Core pattern bodies provide the relevant action- or judgement-guiding content and the definitions or constraints the claim needs. A separate U.MethodDescription, admitted Method, or exact ClaimGraph locator is recovered only when that distinction is current. Evidence use depends on the relation between an exact episteme and a target claim (A.2.4) and on the direct grounds for its intended use. Use A.10 when the source-to-use account is implicit or must remain replayable; publication alone does not establish the evidence-use relation. Actor, ownership, and external-authority claims need their own direct basis.
Domain principle frameworks explain the methods and evidence practices of their fields and identify the FPF content and editions on which they rely. A local practice framework supplies guidance for a bounded local setting and may also rely on a domain framework. A local guide that applies existing guidance as it stands needs no new framework boundary. E.4 explains when a separate framework or adjacent product is useful and how its dependencies differ from its publication.
Other publications can teach, demonstrate or support this content: companion explanations, worked cases, tooling guides and research notes have different purposes. A companion may teach a method more slowly, and a tool may implement a publication form; the method, its explanation and the implementation retain their own identities. A useful explanation can be brought back into the supplying pattern when ordinary framework use needs it.
An architectural reference explains the named whole: its working subject, contributions, boundaries and connections, why they are arranged this way, and the consequences for use. This First Principles Framework Architectural Reference belongs to the Core edition it explains. A DPF carries the corresponding account of its own pattern language; a DPF Suite explains a composite discipline through its constituent DPFs. A Suite Architectural Reference connects their contributions and explains the grounds, alternatives and limits of that composition. Using a result from another field does not make that entire field a constituent. E.4:4.2, C.20 and E.11.DSG supply those distinctions.
The FPF Library Architectural Reference explains the larger arrangement of Core, DPFs and Suites, including relations across Suite boundaries. One common account does not establish that all described disciplines are parts of one super-discipline. An architectural reference may be embedded in one framework file or published separately at a multifile assembly's scope; its function does not depend on its position or carrier. E.11.PFP:4.7 requires enough shared explanation, source-based reasons, alternatives and worked detail to understand and adapt the whole without internal design records. Complete Method explanations remain in their patterns. The architectural reference is available when that larger question matters; it is not an obligatory stage before using a known sufficient pattern result.
One file or website can expose several such publications. Their shared carrier provides access; each framework, Reference or companion keeps the content, edition and change conditions established for it. Core meanings remain defined in Core. Authors can revise domain and local methods while preserving those dependencies. The Core can therefore remain tool-agnostic while companions, tools and domain explanations change for their intended uses.
Last Updated: 2026-11-22 — upstream FPF commit 7a93d8f8 (github.com/ailev/FPF)