A.6.7:8 - Common Anti-Patterns and How to Avoid Them
-
Anti-pattern: “Family-as-suite”. Using
MechFamilyDescriptionto list multiple distinct mechanisms. Fix: useMechSuiteDescriptionfor “many mechanisms”, and keepMechFamilyDescriptionfor “many realizations of one mechanism”. -
Anti-pattern: “Pack-as-suite”. Naming/using the suite as a
Pack. Fix: reservePackfor publication/shipping bundling; useSuitefor mechanism bundles. -
Anti-pattern: “Suite contains admissibility tables”. Duplicating CG‑Spec or embedding CL/Φ/Ψ tables in suite obligations. Fix: publish pins and references only; keep admissibility content in
...Specand policy registries; keep crossing realization in E.18/gate surfaces. -
Anti-pattern: “Suite is a hidden gate”. Introducing thresholds,
block, orDecisionLogin the suite. Fix: suite declares guard formats and required pins; the gate issues decisions. -
Anti-pattern: “Implicit calls”. A protocol implies “normalize happens somewhere” without explicit member and pin visibility. Fix: protocols enumerate steps and required pins; E.18
Usesedges remain explicit.