Jump to text
On this page
Copy and source
Published source confirmed at last check

Source changed 2026-11-18 21:11:39 UTC · snapshot created 2026-11-18 21:12:35 UTC · last check 2026-11-18 21:55:20 UTC

E.6 - Didactic Architecture of the FPF Specification

Status: Stable

E.6:1 - Problem frame

Use this pattern when arranging the specification’s explanation and practical entry. Readers differ in at least two respects:

  • Disciplinary background — for example, systems engineering, knowledge science or ethics.
  • Preparation — newcomers may need introductory examples. Prepared readers may enter through a precise definition or operation.

E.6:2 - Problem

The publication needs an explanatory order in which readers can find the grounds needed for later claims. A practical question may require entry into a later Part. Document order must not become a compulsory workflow.

E.6:3 - Forces

ForceTension
Cognitive LoadFormal detail supplies grounds for later reasoning, but too much detail at the outset can obscure the opening explanation.
Conceptual IntegrityWithout examples, the explanation risks becoming too abstract. Too many examples delay the axioms.
Didactic order vs practical entryThe order of Parts is stable, while a first practical route that fits the reader’s question may cross Parts.

E.6:4 - Solution — Order the explanation and keep practical entry separate

E.6:4.0 - Document order is distinct from first-practical entry

The document’s macro-order organizes explanation. It does not prescribe one practical workflow. Apply E.11.PFP to the compact opening and navigation.

After the Table of Contents, the Readme offers recognizable working questions and direct entries. The Architectural Reference explains the whole pattern language, its cross-cutting ideas, connections and architectural choices, including introductory explanation.

These informative explanation and navigation units and ToC cues may cross Parts when the reader’s question requires it. Use E.11 for practical entry. When the compact cues leave the choice of entry unclear, use its worked comparisons.

Keep the main explanatory sequence recoverable:

  1. Readme and Architectural Reference. The Readme helps a reader find a first useful result. The Architectural Reference explains the connected language and its rationale. Its introductory System and Episteme stories build intuition before the kernel exposition.
  2. Part A — Kernel Architecture. Introduce the holonic ontology and acting-side externalization in A.12.
  3. Part B — Trans-disciplinary Reasoning. Connect the general reasoning moves with applicable System and Episteme grounding under E.7.
  4. Part C — Kernel Extension Specifications. Develop the calculi and extension patterns whose questions use those foundations.
  5. Part D — Multi-scale Ethics and Conflict Optimization. Introduce the reflective ethical and conflict questions with the needed holonic distinctions available.
  6. Part E — Constitution and Authoring Guides. Place framework governance and contributor guidance after the principal kernel and reasoning exposition so an ordinary first use need not begin with authoring rules.
  7. Part F — Unification Suite. Keep concept-set, sense and system-role unification methods in their own Part. Reach them directly when the question calls for them.
  8. Part G — Discipline SoTA Patterns Kit. Keep the discipline source-synthesis, comparison and refresh methods in their own Part.

Part H remains reserved. Examples and extended explanations belong with the pattern whose contribution they explain. Tooling guides and executable examples follow their separate family and lexical rules.

This publication order does not require readers to traverse every Part. Practical entries return to the pattern needed by the reader’s question.

E.6:5 - Archetypal Grounding (System / Episteme)

Narrative layerFirst sight of U.SystemFirst sight of U.Episteme
Architectural ReferenceCoffee‑machine story (pump as system).Meta‑analysis story (study bundle as episteme).
Part AFormal definition states the System criterion and applicable boundary conditions.Formal definition states the Episteme criterion. F‑G‑R coordinates characterize a claim under the C.2.2 profile.
Part B Tell-Show-ShowB.1.2:5.1: identify pump-skid parts and external relations for an aggregation decision.B.1.3:5.1: synthesize a study bundle into a bounded guidance statement.

E.6:6 - Conformance Checklist

IDRequirement
CC‑DA.1Each Part SHALL open with a one-paragraph situational introduction before formal text.
CC‑DA.2Every architectural pattern MUST supply the grounding required by E.7: applicable System and Episteme illustrations, or the explicit single-substrate scope and justification under CC‑AG.3.
CC‑DA.3Governance patterns (Part E) SHALL NOT appear before the Kernel in the main document flow.
CC‑DA.4Navigation aids SHALL distinguish document order from first-practical entry guidance. First-entry pattern-comparison guidance and expanded entry-disambiguation cases are informative and MAY cross Parts without implying a universal process history.

E.6:7 - Consequences

BenefitsTrade‑offs / Mitigations
Readers can choose introductory explanation or direct entry to the pattern they need.Authors must maintain the explanation and entry guidance under E.8.
Grounding can be read beside the claims it explains.The Architectural Reference’s introductory examples evolve when new archetypes are added. Their change is handled through the relevant architecture decision.

E.6:8 - Rationale

Pairing an abstract rule with contrasting, applicable illustrations makes its intended application and scope inspectable. The document order and E.7 grounding rule provide those connections while leaving practical entries free to cross Parts. This implements P‑2 Didactic Primacy and P‑1 Cognitive Elegance without replacing the subject’s reasoning or evidence.

E.6:9 - Relations

  • Depends on: pat:constitution/guard‑rails (GR-1 governs implementation detail and necessary subject syntax).
  • Constrains: Placement of Parts, patterns, and their explanatory examples.
  • Instantiates pillars: P‑1, P‑2

E.6:End

Referenced in the corpus

7 literal mentions in other sections. Read their context to establish the relation.