First Principles Framework (FPF) Readme
The Library’s document identities and current carriers (Library.Reference:11.1) identify complete publications by DocID and full title. For a citation that must work beyond its present hyperlink, keep the full PatternID or SectionRef and enough context to identify the document. Add a document qualifier only if the document would otherwise be unclear.
First Principles Framework (FPF) is a standards-style pattern language for making reasoning in difficult engineering, research, management, and mixed human and AI work explicit, reviewable, and improvable.
FPF is useful when meanings, claims, options, evidence, architecture, work decisions, publication forms, and improvement criteria need to stay coherent across people, teams, tools, time, or AI agents.
Start here
Before selecting framework guidance, read and apply Using FPF Library. This instruction applies to project work, framework development, review and coordination. It explains how to find and read relevant content in the publications available to you, including when an interface cannot retrieve a large file.
When an AI agent assists you, put this requirement and the instruction’s location in your project’s AGENTS.md or equivalent instructions. If a reading test explicitly limits the reader to an isolated excerpt, use only the materials supplied for that test.
Use FPF as a reference model and pattern language, not as a linear textbook. Start from a working question or a worthwhile occasion to examine ordinary work. Bring in internal FPF terms only after they help you keep the work precise.
You can ask an assisting agent to explain an answer or give feedback in ordinary language, without FPF terminology. For example: “Explain this and comment on my proposal without FPF jargon; use the language of my work.” The patterns can guide the reasoning while the answer uses familiar words.
This Readme shows engineers, researchers, managers, reviewers and AI-assisted project workers how FPF can help with a project question. The Architectural Reference and pattern bodies explain how the patterns and their contributions fit together, which source publications they draw on and how those sources have been used over time.
When a claim matters to the work, use the Architectural Reference and Table of Contents to find the pattern. Read the definition, constraint, test, method, evidence rule or assurance rule that bears on the claim.
Begin with the project object at stake and the current question about it. In FPF, a holon is an object whose actual construction supports treatment as a whole with parts and as a possible part of a larger whole. Examples, when they meet the conditions in A.1, include a machine, product, organization-as-system, body of knowledge, publication system, work occurrence, discipline, AI-agent arrangement, method, or local framework.
When claim-bearing role leaves its object or relation unclear, use E.10.ROLE to recover it. If claim-bearing function wording remains unresolved, apply A.6.F and the subject pattern it selects. Proceed directly with a clear ordinary or governed claim. Ask which structure, claim, decision, evidence, description, Work, or improvement relation matters for the current question.
Practical entries
Bring a working question, or use an ordinary occasion to discover what is worth asking. USING-FPF.md explains how to find an individual method or a connected application. The entries below illustrate the range. Search the Table of Contents or ask an assisting agent to compare plausible candidates. If unfamiliar wording or limited access hides what you need, F.1:4.4 explains how to locate passages you can inspect and describe any remaining gap. Stop the lookup when a known source suffices.
The ordinary examples start with one pattern and give any conditions for a later use. You can stop at the first useful result without a mantra. The Practical-Use Cards recall connected reasoning explained in the Methods.
A mantra can also reveal a consequential gap before you notice a difficulty. B.5.PI explains how to select one, apply its connections to a case and obtain a question or justified continuation. You can use this inquiry outside a project. A.1.STM applies it to systemic project reasoning and also traces an already noticed difficulty back to the use that gives it significance.
To find which costly or unavailable work deserves improvement, use C.39.WI. Follow one consequential result, compare real alternatives and their complete burden, and distinguish a missing way from an explanation, access, provision or execution problem. The first result can be a warranted improvement undertaking, a retained possibility or a reasoned decision to continue current practice. An already understood, worthwhile and authorized remedy can be performed directly.
When a correct local result leaves the original request unresolved, use C.39.QR. Recover what the recipient needs, identify how the partial work relates to it, and justify the returned conclusion. Then obtain the missing contribution or settle the qualified result. When the requested contribution is an explanation of a whole subject, C.39.WA develops its organizing grounds and connections and shows how they guide choices about parts. Examples make these operations concrete; varied cases reveal differences within the stated range.
LIVE-WORK-STEERING — Choose the next action while Work is changing
- Situation: Ongoing Work has an applicable domain Method, but a current fact can change what should happen next.
- Question: What should the deciding System choose now, who will perform it, and when must they stop or look again?
- First useful result or blocker: One bounded decision, intended performer, and feedback condition—or a named blocker due to missing or outdated action-guiding information, authority, capability, safety, applicability, or no current Work.
- Start with:
A.15.7. - Stop or return: Stop when the action, performer, and nearest return condition are clear. If ongoing Work is blocked by a missing or unsupported performer, support, or continuation-state relation rather than by candidate choice, use
A.15.8to repair that configuration or stop, then return. If Work has not begun, useA.15.2for intended-work content,A.15.5for work-entry readiness, orC.11only when a known chooser must compare an already formedOptionSet.
METHOD-RECOVERY — Explain what reusable way several performances may show
- Situation: Several observations or records suggest a reusable way, but no Method has been established.
- Question: What candidate explanation is supported, which rival explanations remain, and which uncertainty can change the intended use?
- First useful result or blocker: One source-traceable provisional account per candidate with its rival explanations and relevant gaps—or a qualified record-only result. Include a useful distinguishing question when it changes recovery or receiving use; designing or undertaking a study is a separate choice.
- Start with:
A.3.1.MR. - Stop or return: Stop at the strongest supported account or lowering result. Continue to
A.3.1, or toRMP.10for a needed empirical programme orRMP.11for a needed historical inquiry, only when that further use is current.
PROFESSIONAL-RESULT — Use one result from another practice without transferring the decision
- Situation: A decision needs a legal, safety, tax, privacy, engineering, scientific, or other outside-practice result, but the available source or request names only a title, department, document, approval, provider, or tool.
- Question: What does the available result support for this decision, and would an obtainable additional contribution warrant its whole acquisition burden?
- First useful result or blocker: The supported answer with its necessary use limit, a worthwhile bounded result request, or an identified blocker involving the source, Method, capability, authority, access, evidence or applicability.
- Start with:
A.15.9. - Stop or return: Finish at the useful answer and its material limit; a remaining gap alone does not require a request. Select acquisition through A.15.9 when its contribution is worth obtaining. The supplier keeps its Method and professional authority; the receiver keeps the receiving decision.
NAMING — Give one identified thing a usable name
- Situation: One already identified thing needs understandable wording; later use may also require a stable, reusable name.
- Question: Does ordinary wording suffice, or which durable name preserves the thing and avoids misleading alternatives?
- First useful result or blocker: Use ordinary wording when it suffices. Return a local
NameCardonly when reuse needs a durable name. If the wording or name cannot be settled, identify what is missing about the thing, use, reader group, scheme, sense or candidate evidence. - Start with:
F.18when the name must become durable. For one-off wording, keep the ordinary phrase and use the thing’s direct pattern only if its meaning is unclear. - Stop or return: Stop without a card when ordinary wording answers the need; otherwise stop at the local naming settlement. Return when the thing, use, readers, scheme, or likely misunderstanding changes.
SYSTEM-RECOGNITION — Test systemhood only when it changes the decision
- Situation: A decision may change if one identified entity is a System, while the same noun may instead name Work, a Method, capability, episteme, structure, or another subject.
- Question: What decision depends on treating that entity as a System?
- First useful result or blocker: Return to the non-system claim at issue; recognize or reject the System reading; or name the missing construction fact or test.
- Start with:
A.1.SCR. - Stop or return: Stop at that result or the identified blocker.
TIME — Decide what a timing claim lets you do
- Situation: A trend, deadline, cadence, or stale result is being used to decide what to do next.
- Question: Which moment, rate, rhythm, or freshness relation matters, and does it support continuing, refreshing, waiting, synchronizing, or changing rhythm?
- First useful result or blocker: A bounded temporal claim and supported continuation, or the missing window, evidence, effort, resistance, or currentness basis.
- Start with:
C.27; useG.11only when an affected result may need scoped refresh because its basis is stale. - Stop or return: Stop at a state or rate reading when it supports no stronger claim. Return when the window, evidence, currentness, or intended use changes.
CAUSAL-USE — Keep a causal-looking result within its support
- Situation: A correlation, estimate, simulation, or comparison is being used to say that an action will cause an outcome.
- Question: What causal statement may the evidence support, and what stronger statement must not guide intervention or investigation?
- First useful result or blocker: A supported statement and its limit, or the missing alternative, intervention, comparator, evidence path, identification result, or transport basis.
- Start with:
C.28. - Stop or return: Stop, narrow the claim, or abstain when support is insufficient.
MEASUREMENT — Make a number interpretable before relying on it
- Situation: A proposed measurement needs a model, or a reading, score, rating or dashboard value needs interpretation before comparison or decision.
- Question: What claim or model is needed, and which subject, Characteristic, Scale and rule give it meaning? For a measurement, how does the procedure produce an indication, and what can be inferred under its applicable unit, calibration, time and uncertainty conditions?
- First useful result or blocker: A usable measurement relation or an interpretable attributed value with the uncertainty and use conditions its claim requires, or the missing contribution. A claim of performed measurement retains its observation and Work grounds.
- Start with:
C.16for a measurement claim;C.16.Pwhile the value’s meaning is ambiguous;A.17/A.18for a Characteristic or Scale question;A.19.CPMfor comparison. - Stop or return: Stop when the model or value supports the present use. Return when its subject, governing rule, measurement conditions or use changes.
MATHEMATICAL-MODELING — Obtain a useful consequence from a representation
- Situation: A working question needs a mathematical construction, or a proposed representation may omit something that changes the answer.
- Question: Which object and correspondence make the question answerable, and which conditions permit using its result?
- First useful result or blocker: A calculation, bound, construction, obstruction or distinguishing observation, with its interpretation; alternatively, the missing relation or operation.
- Start with:
C.29:4.1. Use an adequate local equation or algorithm directly when no representation question remains. - Stop or return: Stop when the consequence answers the present use. Return when a changed assumption, lost distinction or execution condition changes that consequence. Validate correspondence to a phenomenon when the intended reliance requires it under
C.29:4.5a.
When the direct pattern is already known, open it: E.11.PFP for framework publication, E.11.DSG for the DPF Suite Reference when a question spans several DPFs, A.15.6 when project, process, or case hides the subject, A.1.1 for model-use organization, C.22.PFR for an actual-problem claim, and A.6.REL for an obtaining relation.
METHOD-CONSTRUCTION — Construct, connect and change methods for practical use
- Situation: Relevant methods or operations exist, but their joining, explanation or adaptation is still missing for the work you need to do.
- Question: How can I obtain the result, make the way usable by another practitioner, and change it without losing independently useful parts?
- First useful result or blocker: One explained candidate way or connected account, its supported conditions and selective return after change; alternatively, the missing operation or basis.
- Start with: C.39:4 supplies the general construction. Use a sufficient existing Method directly and stop. No framework authorship or pattern format is required.
- Stop or return: Stop when the intended use has its adequate explanation. Reopen connections affected by changed conditions; retain independent uses whose conditions still hold.
For example, a corrected recording with a qualified movement–sound mismatch bound of 2.5 ms over the receiving interval meets the 3 ms tolerance for movement analysis and the 8 ms tolerance for viewing. Tightening the analysis tolerance to 2 ms reopens that branch without invalidating viewing. C.39:5.3 develops the preparation, its independent professional premises and that return. If the result must become a framework explanation, E.4.CM:5.4 shows the additional public-content and pattern-form decisions.
WORK-OPPORTUNITY — Find a useful continuation before proposing change
- Situation: Work meets its present requirements, or you have useful material but no settled question about what to change.
- Question: What result could matter here, and is finding or proposing another way worth the work it creates?
- First useful result or blocker: A supported local possibility, a question worth resolving, a missing contribution you can identify, or continuation of the present work.
- Start with: Use C.40 for material whose useful result is still open; C.39 when the result is known but its obtaining way is missing; C.11.DUA when a proposed change needs a value-and-burden judgement. Use adequate domain reasoning directly.
- Stop or return: Stop at that first result, including no worthwhile advice. Reopen affected conclusions when their conditions change; existing obligations remain in force.
Start with a bounded piece of available work: for example, replay an order queue using its durations and delivery conditions, or compare how two recipients use the same result. Try a supported variation of an operation, order, contribution or use; say which consequence it could change. A different word or an unusual observation is a lead, not a diagnosis. If the needed way is absent, construct and explain a local operation or identify the basis it lacks.
Before proposing that variation, distinguish the larger work performed through the action from later work that uses its result. Use B.1.5.EW to recover unclear connections between the action, its constituents and the larger work, and B.1.5.RS when replacing the action can affect another use. Follow a later result handover separately when it can change the proposal. Stop following the connections when further detail cannot change this continuation on the available basis.
Compare with continuing as at present. Thinking, obtaining evidence, explaining the advice, deciding and making the change can burden different people and resources. Include already committed work and other proposed changes in the same interval: two worthwhile changes can exceed shared capacity together. DUA supplies this comparison and returns to C.11.CRC when a finite comparison is missing. Offer only the result whose contribution warrants that burden; explain its decisive conditions in the recipient’s working language. A useful local answer can end the inquiry.
COMMUNICATION-FOR-USE — Make communication useful, then learn from what happens
-
Situation: A report, model, message, or answer seems clear, but its intended use and evidence are unclear, including whether its producer can use it later.
-
Question: Who should understand or do what with it, what evidence is enough, and what should change if that use is not achieved?
-
First useful result or blocker: A supported decision to keep or repair it, change prerequisites or a future use, or stop, with evidence, causation, and permission limits.
-
Start with: Use
A.2.9to evaluate the communication against what its recipient should understand or do. Distinguish the act of communicating from its wording and medium, and interpretation from response, later action, world change and causal contribution.Choose the repair by its object:
A.6.3.CRfor wording,A.6.3.RTfor representation,A.6.3.NARfor narrative,E.17.EFPfor explanation orE.24.PUBfor publication. UseA.10,C.28orC.11when you need to establish evidence, causation or a comparison of repair options, respectively. A repair may change prerequisites, medium, interaction or future use. Check authority, consent and admissibility separately. -
Stop or return: Stop when the named use has enough support or a blocker is explicit. Preserve the earlier intended use when interpreting the response; revise a future use when warranted. Response or silence alone proves neither meaning, success, causation, authority, consent, nor permission.
RESULT-TO-NEXT-MOVE — Route an obtained result to the next probe or option
- Situation: A DPF or project calls something information gain, learning progress, or novelty, or has articulated a result from an earlier cue, and wants to use it to choose the next probe or option.
- Question: What result actually exists, and which downstream question, if any, is current?
- First useful result or blocker: The obtained result plus the first needed reliance disposition, characterization, possibility-space claim, configuration-relative comparison,
ChoiceResult, or missing basis. - Start with: Name the obtained result and use its direct pattern. Use
E.10.LRNwhen learning hides the result; separate ambiguous claims and return each to its direct pattern. Continue toA.10only for actual reliance,C.17/C.18only for characterization or space change,C.11.CRConly for a missing finite realizable-configuration comparison, andC.11only for a live choice. - Stop or return: Stop when the present question is answered. Observations, objectives, and characterizations retain their identities. Route the result articulated from a cue through its direct pattern; if its
A.16.1cue pack remains current as a source or provenance, retain it separately.
ACTUAL-TEMPORAL-STRUCTURE — Recover what actually obtains before testing coordination
- Situation: A cycle, onset list, trace, notation, or geometry is called rhythm, but may be a prescription, representation, Method unfolding, or account rather than what obtains.
- Question: Which subjects and relations support the selected structure, what grounds it, and is a coordination trial useful now?
- First useful result or blocker: A supported temporal claim, or the missing bearer, relation, observation or ground. Establish an A.22-selected structure or a separately identified C.2.1 account when the receiving use needs it. Keep future specifications and representations separate. For a selected coordination trial, add direct relations, conditions, observations, and next decision or stop.
- Start with: Begin with the changing subjects and the temporal claim needed for their use; C.27.TA supplies its conditions. Use A.3.4 or A.15.1 for a needed change or Work claim, A.22 when the organization requires a selected structure, and C.2.1 when its account needs separate identity. Preserve the distinctions among structure, account, future specification, representation, Method unfolding and Work. For coordination, name bearers and direct relations. Only when a trial can change the decision and warrants its burden, compare feasible interventions, try one within bounds, observe, then decide or stop. Open specification, representation, decision, causal, trial or domain patterns as their questions arise.
- Stop or return: Stop when answered. Return when bearer, relation, constraint, grounding, intervention, or use changes; domain Methods stay in DPF.
CONSEQUENCE-BEARERS — Find omitted Systems before closing a decision
- Situation: A consequence account for a decision or investigation may omit physical or operational wholes beyond its candidate bearer.
- Question: Which other Systems may undergo a relevant change, through what supported relation or still-modal path, and what next step follows for the decision or investigation?
- First useful result or blocker: A bounded consequence account with its focus, bearers or intended referents, obtaining or modal paths, changed characteristics, support, uncertainty, and material limit. A useful constraint, alternative, or explicit unknown can complete the answer; further discovery needs a worthwhile obtainable contribution.
- Start with: Use
A.1.CSDfor the focus and receiving decision or investigation. Trace obtaining relations separately from modal paths, challenge the boundary and recover the relevant wholes; useA.1.SCRonly when a candidate’s systemhood is load-bearing. Qualify each change and keep each bearer’s changes and conditions distinct. Leave through the direct evidence, causality, comparison, domain or value pattern only when that stronger question is current. Select further inquiry by individual and combined contribution and burden. - Stop or return: Return a useful account with its material limit; it may change or hold open the named decision or investigation. Reopen when the focus, configuration, horizon, whole, relation support, bearer, observation, or receiving use changes.
Practical-Use Cards
Each card offers an optional route for extended work. Use the keys to find cards. Choose a card by the situation and intended result, then open and combine only the pattern contributions the case needs. Stop at the first useful result or blocker.
UNFAMILIAR-THEORY - Make an unfamiliar theory usable
- Situation: A theory offers a useful construction or result, but you cannot yet assemble and interpret its application to your question.
- Question: How can you obtain the needed consequence and use it?
- First useful result or blocker: A worked application with an interpreted answer, or the missing operation, premise or correspondence that directs the next contribution.
- Mantra: Recover the question the theory helps answer. Connect its objects and rules to one case. Obtain the construction and reconstruct the decisive argument. Compare the corresponding operations when using another representation. Apply the consequence; use what suffices or identify the remaining question.
- Start with:
B.5.TUfor application construction.B.5.RCandB.5.RAsupply construction and argument recovery,A.6.3.RTan operative expression, andC.29.1result transfer. UseC.39for a missing way. - Stop or return: An adequate supplied result can enter where needed. Stop when its interpreted consequence answers the question. If a premise changes, follow its effect instead of repeating unaffected work.
PHYSICAL-RESULT - Connect physics, mathematics and computation
- Situation: A team has physical, mathematical and programming knowledge, but cannot connect the contributions needed to produce a physical result.
- Question: Which missing contribution prevents the next engineering move?
- First useful result or blocker: An interpreted calculation, proposed realization or located failure in the physical account, computation or execution.
- Mantra: State the physical change sought. Construct the state and continuation needed to reason about it. Formulate the mathematical question and interpret its variables and operations. Obtain a result or computational procedure. Connect input preparation, system actions and output reading. Return to the physical question and repair the failed contribution.
- Start with:
B.5.MPCto connect available contributions and select the missing one.C.29constructs mathematical correspondence;C.29.1tests result transfer;C.29.2constructs computation;C.29.3connects it to an executing system. Subject engineering supplies physical laws and mechanisms. - Stop or return: Reuse ready contributions. Stop when the result suffices for the present decision. Reopen contributions whose changed conditions invalidate their use.
Expansion for PHYSICAL-RESULT
Divide the work. Give the next participant the result, what it denotes and the assumptions needed to use it. For the robot in B.5.MPC:5.1, the physical contribution supplies the motion model; the mathematical contribution relates distance to motor increments; the computational contribution produces an integer command and its rounding bound; the realization contribution checks what that command makes the controller do. People and AI agents can take these contributions according to their capabilities.
Use A.3.3 to construct a missing state account and C.16 for a needed measurement relation. These are dependencies between results. A ready model or computation can be reused at its point of need. Slip may call for revising the motion model; numeric overflow may require another command representation; a timing change may require a different execution arrangement. A calculated displacement remains conditional on the model until actual motion is established.
ARCHITECTURE — Carry an outside need through structure and feedback
- Situation: A system or another architecture subject must produce an outside result, but its pressure, options, decision, or realized feedback is unclear.
- Question: What missing architecture result prevents the next useful decision or action?
- First useful result or blocker: One clear architecture question, candidate comparison, decision, or the missing fact or constraint.
- Mantra: Start with the outside change and who relies on it. Name the subject and pressure; separate facts from intended constraints; compare plausible structures; choose what the current decision needs; check what the realized structure produces; reopen when use, evidence, or structure changes.
- Start with:
C.32.P2S, then the pattern for the current question inC.30,C.32,C.32.PAD, orC.30.AD. - Stop or return: Stop when the first result makes the architecture work reviewable.
PRACTICE-ARCHITECTURE — Connect methods with their use, support and development
- Situation: A decision about methods depends on performed or planned Work, capabilities, providers, descriptions, tools or cultural change whose structures do not align one-for-one.
- Question: Which relations change how the methods can be used or improved?
- First useful result or blocker: One readable synthesis, one bounded development action, or the missing Work case, relation, or transfer evidence.
- Mantra: Start from representative Work and its needed result, or a proposed use with a later-test condition. Keep Methods, Work, capabilities, providers, descriptions, tools and cultural processes distinct; compare the structures that conflict; develop a limiting capability when needed; test transfer in real Work; return when the method, provider, evidence or style changes.
- Start with:
C.32.MWA; useE.23.CDI,E.23, orC.36only when the decision raises the corresponding question. - Stop or return: Stop when the synthesis or transfer result answers the decision.
WORKING-DOCUMENTS — Make a document answer one use
- Situation: A document is requested, but its label does not reveal the use it must support.
- Question: Do you need to check one view, reuse related views, show the same subject differently, see enough structure, compare named sources, or use an architecture description in a decision?
- First useful result or blocker: A checked view, a reusable viewing approach, another presentation of the subject, an account of sufficient or missing structure, a source comparison, the architecture-description result needed now, or the specific obstacle to obtaining it.
- Mantra: Name who will use the document and what it must support. Check one view; prepare recurring views; show the subject another way; expose enough structure; compare sources; or use a description in architecture work. Keep document, subject, decision, and performed Work distinct. Stop when the needed result exists; return when its use or content changes.
- Start with:
E.17.0for checking one view against its viewpoint;E.17.1/E.17.2for recurring use;A.6.3.RTfor representation change;C.33for structural information;E.17.ID.CRfor source comparison;C.30.ADfor architecture-description use; otherwise use the direct pattern for the document result. - Stop or return: Stop when that result answers the use. One file may carry several results without merging them.
OPTION-COMPARISON — Keep unlike option results distinct
- Situation: Labels such as build, buy, reuse, provider, internal, outsource or AI need comparison; uncertainty blocks costly commitment; or advice demands costly or infeasible work.
- Question: Do you need to form complete ways, compare or retain candidates, govern a pool, prepare options for another chooser, choose now, or repair an evidence demand?
- First useful result or blocker: A sufficiently developed set of ways to obtain the same result, comparison or retained set, pool rule, prepared
OptionSet,ChoiceResult, usable advice, answer to the blocking question or exact gap. - Mantra: Name one result, use, situation, horizon, and acceptance basis. Turn labels into complete ways on one parity basis, keeping supported, proposed, and unknown premises visible. Compare or choose only when current; preserve worthwhile variants and gaps. For costly action, resolve only the uncertainty blocking commitment. Return when the result, basis, evidence, or use changes.
- Start with:
C.11.DUAfor a demand’s contribution or feasibility;C.38for incomplete ways; otherwiseA.19.ECS,C.18,C.19,G.5orC.11for the current question. For costly commitment, select the current check inA.10,B.3,A.20,A.21,C.28,C.11orA.15.5. - Stop or return: Stop at the present question’s result.
PROBLEM-SHAPING — Stop at the earliest useful problem-side result
- Situation: Something matters, but the team may have only signals worth preserving, a direction for inquiry, a question about competing explanations, or enough clarity to accept a problem statement.
- Question: What can the available material support now: preserved signals, a routed direction for inquiry, an explicit question that contrasts possible explanations, or a problem statement ready for acceptance?
- First useful result or blocker: A preserved set of signals, a clear inquiry route, a question about plausible explanations, an accepted problem statement, or the missing anchor, route, subject, constraint, or acceptance basis.
- Mantra: Keep what was noticed before declaring a problem. Route the inquiry only when the signal has a stable anchor. Ask about explanations only when the open question and contrast are clear. Accept a problem statement only when the subject, constraints, unresolved relations, important distinctions, and basis can be stated. Stop at the earliest useful truth; return when its basis changes.
- Start with:
A.16.1for a cue pack,B.4.1for routed cues,B.5.2.0for an abductive prompt, andC.22.2for an acceptedProblemCard. - Stop or return: Do not force a cue into a problem. Open
C.22.PFRonly when whether the adverse relation obtains changes the next use.
IMPROVEMENT — Define better before repeating change
- Situation: A team wants to improve something but has not agreed what better means or how the changed version will be checked.
- Question: Which evaluation question, characteristics, scales, changes, and comparison make improvement reviewable?
- First useful result or blocker: One evaluation question, current assessment, bounded change, before-after comparison, or the missing use, evidence, scale, or trade-off.
- Mantra: Name the entity, current state, and use that better must serve. Frame the question before choosing metrics; select characteristics, scales, and protected trade-offs; assess the current state; compare candidate changes; make only the supported change; evaluate it on the same basis; continue, stop, or change direction from that result.
- Start with:
E.22,A.19.ECS,C.16, andE.23as their questions become current. - Stop or return: Stop at the first missing prerequisite or useful comparison. Reopen when the entity, use, evidence, or scale changes.
WORDING — Repair language without replacing the project question
- Situation: A load-bearing sentence hides the subject, relation, kind or use, or invites a false inference.
- Question: What should the reader understand and do, and which distinctions matter for that use?
- First useful result or blocker: One plain repaired sentence, direct clarification, local naming result, or the missing subject, sense, test, or reader use.
- Mantra: Recover the ordinary project sentence first. Name what it is about, what it claims, and who must use it; add ontological distinctions only where they change truth, understanding, or action; choose a durable name only when later use needs one; rewrite in plain technical language; check that a reader without private context can recover the intended claim and action; retain a guard only under F.19’s full grounded-contribution test; return to the domain task.
- Start with:
F.19; useE.10for unresolved FPF wording, andF.18,F.0.1,F.9, or the subject’s direct pattern only when needed. - Stop or return: Stop when the reader can understand the claim and carry out its intended use.
SOTA-PORTFOLIO — Use a plural field of approaches to answer your question
- Situation: A project needs the modern field of approaches rather than one popular answer and may later need maintained domain guidance.
- Question: What plural view is adequate now, and does the remaining problem call for reuse, a contribution, another product, a DPF or LPF, or no maintained result?
- First useful result or blocker: One source-linked SoTA view, live option set, reuse route, framework decision, or the missing scope or maintenance basis.
- Mantra: Name the question, scope, freshness need and rival traditions. Build a source-linked plural view; preserve disagreement, source-use limits and constructions; compare useful approaches; compare reuse or contribution with framework authoring and maintenance; open a framework decision only for a recurring unmet problem; author and test the needed patterns; refresh when the field or use changes.
- Start with:
G.2; addC.18,C.19, orG.5for the set and the E.4/E.9 authoring route only if a framework is selected. - Stop or return: Stop at the first adequate maintained or one-off result. If allocation to familiar patterns loses a source’s construction, use
FPF.Reference:16.5to identify the missing result, obtain it through the appropriate subject method and return to the original use.
SYSTEM-DELIMITATION — Separate parts, selected boundary, and crossings
- Situation: One System is recognized, but a decision mixes its parts and assembly with a chosen boundary, external participants, and relations that cross it.
- Question: Which facts, use-relative choice, crossings, and selected structure answer the decision?
- First useful result or blocker: One exact part or assembly fact, boundary choice, crossing relation, selected structure, or missing participant, predicate, constraint, or use.
- Mantra: Start with the recognized System and decision. Recover parts and assembly as facts; keep external participants outside the part list; choose a boundary only when alternatives matter; name every crossing by its own relation; select a joint structure only when organization changes the decision; reopen when identity, facts, use, crossings, or constraints change.
- Start with:
B.1.2,A.14, andC.13; useC.11,C.32.PAD, the direct relation pattern, orA.22only when needed. - Stop or return: Stop when the result answers the decision. If system recognition is unresolved, return to
A.1.SCR.
Decide Whether FPF Fits
Use FPF when more explicit distinctions or connections would help keep the work coherent. Typical signs:
- several teams, experts, tools, or AI agents share reasoning about the same work;
- the real-world test is slow, expensive, noisy, risky, or politically hard to repeat;
- different readers need different reports, dashboards, explanations, or decisions about the same underlying work;
- names, roles, responsibilities, options, evidence, or quality criteria are starting to blur;
- the team needs a current view of possible approaches, not just one recommendation;
- a decision is small enough to make now but important enough to leave a durable reason.
When the task is small, feedback is fast and cheap, the vocabulary is stable, the decision will not be reused or audited, and a quick answer is enough, use that answer directly. Use only the framework guidance the question needs.
FPF can help people who need to keep work understandable across boundaries, including:
- engineers and systems engineers working with complex products or operations;
- researchers building claims for inspection or reuse by others;
- platform and AI teams coordinating humans, models, tools, and approvals;
- safety, assurance, compliance, and regulatory leads who need visible evidence and responsibility boundaries;
- managers and product leaders comparing options, budgets, risks, and delivery promises without hiding trade-offs.
Examples of use include:
- Human-only: use it as a writing and review discipline for meetings, notes, decisions, and technical documents.
- Mixed team: use it to keep specialists, managers, safety leads, and AI assistants aligned around the same work.
- AI-assisted: attach or index the specification, ask for plain-language project help first, and use pattern names only when they make the answer easier to check.
FPF can help with the evidence and decision questions that remain as AI becomes more capable. AI can generate fluent options quickly, but projects still need to decide what counts as evidence, which option is being compared, who may rely on an answer, when a claim is stale, what remains a guess, and what work is authorized. FPF helps make those boundaries explicit before the answer is used.
Core ideas in plain language:
-
first name the project object under concern; FPF calls it a holon when its actual construction supports treatment as a whole with parts and as a possible part of a larger whole; use
A.1to check a candidate; -
local teams may use local meanings; boundary-crossing work makes the translation relation explicit;
-
the project object itself, its description, a dashboard about it, a decision about it, and the work done to change it are not the same;
-
architecture is structure of that holon or project object in a context, not the diagram, document, approval, or plan about it;
-
serious architecture work can move from problem pressure to candidate structures, selected structures, decisions, method and work, actual structures, and feedback;
-
when the current question is which reusable way of doing changes, produces, derives, selects, controls, or preserves the project object under stated conditions, inspect
A.3.1 U.Method; -
to decide whether setting up and applying a selected apparatus, such as a model, is worth the cost for one use, inspect
C.19.2; it tests the bounded application against the required result and guarantee. UseC.39when a missing obtaining explanation must be developed, orC.40when usable material needs variation and examination. UseC.18for archive or front claims, andC.11when two or more eligible alternatives make a local choice current; -
when a clear engineering claim leads to an incorrect conclusion about action, identity, dependence, whether a relation obtains, responsibility or projection, inspect
A.7.1; when current FPF uses produce incompatible consequences for the same receiving claim and scope, inspectA.7.2. The latter can expose an unresolved incompatibility rather than produce one reconciled answer; -
when an accepted C.22.2
ProblemCardepisteme must remain usable while the project selects a method, prepares or performs work, interprets a result, branches, stops, or returns after a changed assumption, inspectE.18.1 P2W Problem-to-Work Carry-Through; it carries the accepted problem-side distinctions into one next value or relation returned by the pattern that answers the current question; -
when route-like positions, relations or constraints change which continuation is possible, use
E.18.3. Start with the thing being transformed, two recognizable places or states, the proposed connection or guard, and the continuation question. An ordinary provisional explanation may answer it or identify what is missing: a predicate, an occurrence rule, a fact about the case or information you cannot obtain.Use A.22/E.18 qualification when the named use depends on the identity and qualification of the unfolding organization as an E.18.3 structure. Add a separate demonstrative-slice claim only if that use needs it. When no branch, connection or constraint affects the continuation question, an ordinary route description suffices.
-
keep several options alive until the comparison is clear enough to choose;
-
say what “better” means before optimizing or scoring;
-
make trust depend on evidence, freshness, scope, and intended use;
-
publish different views for different readers without changing the underlying claim;
-
when explaining or reordering selected source structure, including narrative rendering, state what is preserved, deliberately coarsened, abstracted, omitted or lost, and when the reader must return to the source. Establish any stronger claim under the pattern that governs it;
-
use mathematics or formal models when they clarify what structure is preserved, what is lost, and what can be checked;
-
build domain or local FPF-grounded frameworks as dependents of FPF Core, not as silent rewrites of the Core.
When Several Transformation Flows Form One Network
Inspect E.18.NET when the current question joins independently identified transformation-flow structures through exact direct relation occurrences. Several stages, several paths, or several valuations of one flow do not make a network.
- Build the builder. A compiler-source-change flow, a bootstrap-compiler build flow, an application build flow, and a deployment-and-operation flow keep their own changes, work, positions, and local state. Recover the project’s exact relation that says which executable compiler is used for the application build and its exact delivery relation to deployment. A selected tool-build network can itself be a member of a selected release network; follow a finite member path rather than inventing “level 2” and “level 3” kinds. Inspect
E.18.NET; if the case is only one flow with several stages or valuations, stay inE.18. - Change a product and its production system. Product-development Work changes and verifies the product definition; production-system-change Work redesigns, retools, and qualifies equipment; production Work makes units; operation supplies observations that may inform later product-development Work. Treat their transformation-flow structures as separately identified selected structures: the structures organize positions and exact relations but do not perform the Work. Keep the product and production system distinct, and recover the exact release, readiness, production, and observation relations needed by the current case. A selected product-development network and a selected production-system-change network can be members of a larger selected network without becoming one giant flow. Inspect
E.18.NET; if only one architecture correspondence is current, use its direct architecture pattern instead.
When the immediate question is whether dated Work occurred or an entity was produced, apply these tests in order:
- A.13 recovers every actual performer System’s core: exact admitted System, local agential kind and criterion, classification, obtaining assignment for the scope, working situation and window, and adequate core evidence. Add a characteristic profile only when conditionally consumed.
A.15.1independently admits oneU.Workoccurrence from the exact performance history, at least one Method actually followed, temporal extent, and at least one obtaining locally declared containing-System relation. That admission neither assumes nor requires F.6.- Only when the receiving use needs precise assignment-bound performer attribution, F.6 tests
performedUnderAssignmentthrough the same obtaining A.13 assignment, direct case fact, holder equality, declared species and participants, and coverage. An unresolved attribution alone leaves independently admitted Work intact. Recheck any consumed A.13/A.15.1 premise invalidated by the same finding and its dependent conclusions. A compact attribution sentence may omit an assignment identifier that its receiving use does not need; the omission changes only the sentence, not those facts. - After that Work and the required participant facts are exact,
A.15.PRODseparately tests the Work’s participation in producing the entity, the start of that entity’s identity, and production completion.
Missing agency basis, Work granularity, production-participation predicate, identity-specification or inception basis, completion criterion or applicability, boundary or composition facts, or required substrate is a branch-local blocker. Actual change, output or result, identifier allocation, evidence, delivery and acceptance remain separate claims.
Perform several levels of work through one action
While adding an amount to a customer’s running total, an agent can be calculating that total and preparing the report that contains it. These are related descriptions of the work being performed through the action. The report can still be unfinished. Earlier data collection supplies an input; it need not be taking place during the addition.
Use B.1.5.EW when you cannot explain these constituent–whole connections: recover the constituent operations, the encompassing work and the conditions that connect them. Stop expanding where the practitioner can perform the needed operation or obtain its required result from another agent. Check that the necessary capabilities and shared resources fit together.
If the report must now identify the first chronological crossing of a limit, preserving the final total is insufficient. Use B.1.5.RS to compare a proposed replacement with the requirements of each receiving use; restoring order or changing the procedure may be necessary. A.22.CGUS helps distinguish a continuation that can be performed now from one whose constituent capability or resource conditions are missing. A feasible practice or preparation step may remain available while the whole performance is not.
Recover a lost path from outside use to recursive builders
Use this guide when a project account needs to connect a local result to its receiving use, construction, Work and creator contributions. A.1.STM starts with the intended receiving changes at the time of operation, including a possible future operation. From the system boundary, examine the larger whole and how its parts function together. Derive the system’s needed contribution from that account and use it to justify later inward and creation-side choices. If the whole is unknown, investigate it. The mantra can reveal a dependency before anyone raises a complaint or show why a noticed difficulty matters to the project.
The system-of-interest (SoI) supplies the common product-use purpose for the creators’ cooperation. A creator organization remains fully engineerable as the local system-in-hand, with its own finite result and acceptance. A.1.STM:4.1.1 connects its needed capability, resource choices and acceptance to the products it serves. A machine or component offered as a distinct usable supply can have its own product SoI under the receiving-use and fitness conditions in A.1.STM:4.1. Use the narrower first-gap mode when the shared basis is already adequate.
Trace the dependencies backward from the release, runtime use, or outside change that matters now, stopping at the first unsupported answer. If the actual versus intended project system-of-interest or its project designation is unclear, apply A.15.6 first to distinguish actual project Work, intended material, and project designation. Apply A.1.SCR to the recovered exact entity only when recognition under U.System remains load-bearing for the named decision.
One-Minute Example
A platform team asks:
Should we buy, fine-tune, or build an agent stack for our product?
The discussion can mix architecture, vendor comparison, safety, evidence, budget responsibility, user value and implementation planning before the team has established what it is comparing.
A first pass with FPF can make the following distinctions explicit:
- project objects: distinguish the product, the agent stack, and the team or toolchain involved in changing them;
- architecture flow: which candidate and selected structures address the problem pressure, and how expected and actual structures compare;
- comparison frame: which alternatives are in the candidate set;
- evaluation characteristics: cost, latency, controllability, safety, maintainability, time to first use, and other project-specific characteristics;
- evidence gaps: which missing evidence can change whether commitment is justified;
- current decision state: whether the team is choosing now, keeping a selected set, making a project architecture decision, or doing more discovery;
- work and feedback: which method and readiness conditions are needed, what Work was performed, and what evidence supports realization of the selected structures;
- reader reliance: what engineering, management, and assurance readers may responsibly rely on.
These questions can also guide a factory modernization, laboratory protocol, construction design change, supply-chain decision, safety case or research program. They help keep reasoning reviewable and reusable while preserving its meaning in different presentations.
What FPF Is
FPF is a pattern language for making project reasoning explicit and checking the meanings, claims and connections on which action depends.
It helps teams:
- keep meanings stable when work crosses teams, tools, documents, and time;
- separate the project object being discussed from diagrams, dashboards, explanations, promises, decisions, and actual work;
- state what a claim can responsibly be used for before people rely on it;
- compare options without collapsing too early to one favorite;
- define quality criteria before improvement starts;
- keep evidence, assurance, decisions, and implementation work visible as different questions;
- carry architecture work from problem pressure to real structures and feedback instead of stopping at diagrams or decision prose;
- grow domain or local frameworks from FPF Core without silently changing Core meaning;
- repair confusing wording by first asking what the wording is doing in the project, not by swapping synonyms;
- leave each pass with a useful result: a clearer question, a better name, a comparison note, an evidence gap, a document fit for its intended use, or a reason to inspect a specific pattern.
What FPF Is Not
FPF is not:
- one prescribed project methodology to apply in full;
- a replacement for domain expertise;
- a requirement to study the whole specification or apply every pattern before useful work begins.
Compare the expected gain—such as clearer meanings, better-supported choices or a constructible method—with the full effort of using the relevant guidance.
How to Use This Repository
Start with one of the ordinary examples or one of the cross-pattern cards when it recognizes the current project question. A direct example is enough when one pattern can return the needed result. A card helps when the answer must retain several pattern contributions, checks, and returns. If no example fits, use the Table of Contents or ask an assisting agent to compare a small plausible set of direct patterns.
Use the Architectural Reference for the cross-cutting ideas. Big FPF Storylines follows a report-review question through measurement, assurance, a shared-capacity condition and further inquiry. The Architectural Rationale there explains the choice of direct patterns, combinations and profiles and the contributions and limits of their shared sources.
For one selected pattern, read its Solution. Use E.11.PUA to follow it to an answer or identify what is missing. Name a receiving use only if there is a continuation or later reliance to account for. Use E.11.PUR when the question concerns applicability, recommendation, coordination or ordering among possible uses, or when an earlier result may already answer it. An ordinary reversible judgement can stay conversational. Make it addressable only if a named later use needs that support.
If you use an AI assistant, attach or index FPF-Spec.md and ask for plain-language project help first. Let internal pattern names enter only when they make the answer more precise.
A good first prompt is:
You have the FPF specification as a file.
Help me with this current project question:
[short project description and question]
Use plain language for engineer-managers. The Readme examples are clues,
not a list of the questions FPF allows. If one direct pattern can answer
the difficulty, start there. If the answer needs several pattern
contributions, give me a short attention map and open only the
contributions whose questions are current.
First give one useful result for the situation, or a specific blocker.
Then name the project question that result answers and any missing fact,
rule, evidence, or authority needed before a truthful answer is possible.
Add PatternIDs after the plain explanation so I can inspect the direct
Solutions and checks. Stop when the current question is answered; do not
turn the example or card into a whole-project plan.
License and reuse
The original FPF and DPF content by Anatoly Levenchuk, including the Engineering DPF Suite and Narrativization DPF, is available under CC BY 4.0: you may share and adapt it, including commercially, with attribution, a license link and an indication of changes. See the licensing scope (Licensing FPF Library) for the full notice and third-party and software boundaries.
You choose the license for your own original DPF or LPF. Using FPF methods or its publication form does not impose CC BY on your work. When sharing licensed FPF or DPF text under CC BY 4.0, preserve its attribution and comply with the license. Where your use needs no copyright permission, including under an applicable exception, these conditions do not apply. The license has no ShareAlike requirement.
Citation
To cite this Core specification, use:
Levenchuk, Anatoly. First Principles Framework (FPF Core). In FPF Library.
GitHub repository: https://github.com/ailev/FPF