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:20:10 UTC

E.11.PFP:8 - Common Anti-Patterns and How to Avoid Them

Anti-patternWhat failsRepair
Complete record before entryA maintainer detail—such as authorship, assistance, date, dependency, provenance, a product-declared maintenance status, support window, or currentness window—or the whole edition record appears before the ToC merely because it exists.Preserve the product’s compact opening; project only cues whose possible values change a named reader move and keep the full record in maintainer evidence or the justified reference tail.
Development state as public identityCandidate keys, local paths, digests, commits, blobs, generated comments, or machine warnings describe the publication to readers.Keep them in builder or maintainer evidence; publish a stable designation and public return.
Date as edition identityTwo editions on one day become indistinguishable.Use a stable public designation linked to the exact edition record; show a date only when it changes reader use.
Fresh navigation grammarA generic mini-menu is inserted ahead of an established ToC, duplicating units and making one product unlike itself.Extend the product’s existing non-pattern ToC segment and make the checker recognize that exact grammar.
Flat-index compulsionVisible Part grouping is removed merely to satisfy one-table code.Check one logical index across consistently headed, uniquely labelled segments.
Index by cell guessA relation or source-return table is rejected because it cites PatternIDs and titles.Recognize only the closed authoritative and support-index grammars.
Position used as PatternIDPatterns are renumbered when the ToC changes, or identifier order is read as dependency, Method order, or semantic hierarchy.Keep PatternID stable while the pattern continues, show current § position separately, keep ToC and body order aligned, and state every substantive relation in its own field or claim.
Readme as another editionThe standalone Readme mints its own designation or copies a full editable record.Repeat only the shortest cue whose absence would change use or return when the Readme circulates independently; never duplicate the edition or rebuildability record.
Outside the pattern set means another productA Preface, coverage account, or refresh note is split into a product with no independent use.Keep it as a named support unit when it shares the framework boundary.
Shared use means one productA cross-framework registry or service is absorbed into one DPF.Treat shared use as a prompt to inspect the boundary; preserve an independent product when its own use, citation, or change makes that useful.
Combined carrier merges productsA framework and catalogue receive one identity and one framework index.Keep the outer carrier neutral and each constituent in its own selected form.
Parser pass as accessibilityCanonical English labels parse, so translation, assistive navigation, low-tool return, and cold-reader use are assumed.Test the actual carrier and reader route; repair headings, labels, links, projections, and mnemonic wording without weakening source return.
Rival entry sets or key registriesOrdinary entries and cards are maintained as separate front doors or the same key appears once in each list.Keep one Practical entries set and one declaration for the product that assigns every selectable key one form and one occurrence.
Card classification by syntaxAn H4, six fields, a short body, or a historical label is treated as proof that the reader needs a card.Use E.11 to compare the same truthful content without a mantra; the form checker only verifies the selected form.
One candidate’s labels, example inventory, and limits made universalAnother product must publish the same topics or another language must use one candidate’s labels and whitespace limits even when they do not support its readers.Preserve the shared field order and direct-versus-cross-pattern distinction, but let each product select its non-exhaustive examples and declare one suitable measure with mantra/card maxima.
Whole account as a second catalogueA list of pattern names replaces the explanation of how their contributions work together.State the shared problem, connected results, choices, and reasons; return to the full bodies for each contribution.
Recursive form as fixed taxonomyEvery intermediate group receives a parent pattern, or every profile must have one exclusive parent.Select substantive scopes by useful changes in practice and state the relations that hold; keep publication grouping separate.