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 16:02:47 UTC · snapshot created 2026-10-03 16:03:51 UTC · last check 2026-10-03 16:45:04 UTC

A.19.CHR:8 - Common Anti-Patterns and How to Avoid Them

Anti-patternWhy it failsAvoid / repair
Using MechFamilyDescription as a suite containerCollapses “many implementations of one mechanism” into “many mechanisms”, mixing levels and breaking reuse constraintsUse MechSuiteDescription for multi-mechanism sets; use MechFamilyDescription only for multiple implementations of a single U.Mechanism
Embedding a second CG‑Spec or CL/Φ/Φ_plane tables inside the suite or plan itemDuplicates the governing spec refs and creates drift between planning, gates, and auditPublish refs and pins only (CGSpecRef, BridgeCardRef, policy-id pins); keep tables in their canonical registries and cite them
Implicit UNM/UINDM/ULSAM “inside” score/compare/selectBreaks auditability and violates the suite protocol explicitness obligationMake dependencies explicit as protocol steps (Uses) and cite the chosen mechanism instances in the planned baseline and audit pins
Hidden thresholds or weights in CHR coreMoves acceptance criteria into the wrong layer, defeating the declared defaults source and traceabilityKeep thresholds in AcceptanceClauses, TaskSignature, or GateProfile; if a policy is needed, mint a policy-id and cite it explicitly
Scalarizing partial orders “for convenience”Violates set-return semantics and hides incomparabilityKeep comparisons set-valued via CPM and selectors set-returning; any scalar summary must be declared as report-only telemetry or as an explicit lawful comparator
Treating planned baseline as a launch witnessSmuggles execution facts into planning and blurs P2W separationRecord the edition/reference baseline in A.15.2; add A.15.3 fillings only for declared positions and keep actual bindings and launch witnesses in enactment
Using CompareGuard / LaunchGuard as mechanism lexemesCollides with reserved gate-level pins and blurs guard vs gate responsibilitiesIn mechanisms use …Eligibility / …Admissibility; reserve USM.CompareGuard and USM.LaunchGuard for gate-visible pins