Library / First Principles Framework (FPF) - Core Conceptual Specification
Jump to passage
In this reading

Link to current text

Published source confirmed at last check

Source changed 2026-10-03 11:52:20 UTC · snapshot created 2026-10-03 11:53:41 UTC · last check 2026-10-03 13:15:03 UTC

C.32.ADR:8 - Common Anti-Patterns and How to Avoid Them

Anti-patternSymptomRepair
BlankTemplateADRA template is filled with plausible prose but no PAD relation can be cited.Draft or recover ArchitectureDecisionRelation@Project with C.32.PAD; then project it into the record.
ArchitectureDescriptionDumpThe ADR copies diagrams, views, or model text and the decision outcome is hard to find.Keep the record small; cite architecture-description refs and restore decision outcome, rationale, consequences, and work effects.
OptionsInventedInRecordThe ADR lists options that were not part of candidate synthesis or accepted decision basis.Use C.32, A.19.CPM, or PAD; update the decision relation before updating the record.
MethodInstructionHiddenInRationaleA decision requires developers to change their practice, but the instruction is buried in rationale prose.Record the prospective content through the exact plan, policy, commitment, permission, decision, responsibility, authority, or other direct relation that states it, with Method refs, intended Systems, expected structure effect, and readiness or gate exit; otherwise return its exact missing governor. Do not manufacture a current assignment or performed Work. If performance later occurs, recover every precise performer’s A.13 core and independently admit the Work under A.15.1; add F.6 only when precise assignment-bound attribution is current, and add only the other direct relations that independently obtain.
NoConfirmationPathFuture teams cannot tell whether the decision still holds or has been violated.Add confirmation, eval, guardrail, source-return, or supersession condition; use the receiving evaluation or governance pattern.
PackageOrderAsGovernanceThe latest file by number is treated as active without explicit status or supersession.Add package map or status fields; make active, proposed, superseded, and related relations explicit.