docs: preserve domain-independent facilitator principles

This commit is contained in:
2026-08-19 18:39:35 +01:00
parent 85204f96ac
commit 601e46e4b7
5 changed files with 167 additions and 8 deletions
+76
View File
@@ -2,6 +2,82 @@
> These are the principles that should guide normal work today. They are supported by verified implementation, current project direction, and established product philosophy. For broader and aspirational architectural reasoning, see `docs/architectural-principles.md`.
---
## 0. Axiomatic Principles (Durable Methodology)
> The following principles capture the irreducible core of the Confidence Engine methodology.
> They apply regardless of delivery platform, technology stack, or interface choice.
> New work must not contradict these axioms without explicit methodological review.
### A1 — Delivery-platform independence
The Confidence Engine is a reasoning methodology, not an LLM product, workshop format, software UI, graph implementation, book, or any other delivery mechanism. The method defines reasoning activities — surfacing questions, capturing contributions, identifying uncertainty, connecting relevant contributions, exposing what remains unresolved, helping the user understand where they are — and those activities may be delivered through a human facilitator, a book or workbook, software, an LLM-assisted application, or another future delivery mechanism. No single delivery platform owns the methodology.
### A2 — The Engine facilitates; the user directs
The Engine may expose, suggest or infer possible questions and relationships, but the user chooses what to investigate next. The Engine does NOT determine: the mandatory next question, the branch the user must enter, the decision the user should make, or when all uncertainty must be resolved. What it surfaces (possible questions, new connections, open uncertainties, branches waiting for information, changes in understanding) remains invitations or proposals. The user directs the investigation.
### A3 — Reasoning operates on meaning, not prescribed vocabulary
The Confidence Engine is domain-agnostic and language-agnostic. Its fixed vocabulary should describe generic reasoning structure (contribution, observation, uncertainty, assumption, question, relationship), not subject-matter terminology. Domain-specific dictionaries are not the basis of semantic reasoning. Language-specific keyword dictionaries are not the basis of semantic reasoning. Fixed phrase/keyword scoring must not substitute for understanding. This is consistent with learning that wording/shape sensitivity makes deterministic semantic classification brittle.
### A4 — Semantic interpretation is a suitable facilitation capability
Where meaning depends on language, semantic interpretation may be used to assist the facilitator role. A human facilitator can perform this operation. An LLM may also assist because language understanding is an appropriate capability for this task. Any inferred relationship remains a proposed interpretation until handled according to the delivery method. The LLM must not own the relationship, make the decision, determine truth, or be declared required.
### A5 — Deterministic logic preserves structure and integrity; it does not imitate semantic understanding
Use deterministic software where the problem is genuinely deterministic (identity, storage, provenance, routing, staleness checks, record integrity, known explicit links). Use semantic interpretation where the problem is genuinely about meaning. Do not rebuild semantic judgment as a domain dictionary simply because deterministic code is faster or easier to test.
### A6 — Investigation is non-linear
The Confidence Engine does not require investigation to proceed as one sequential chain. Questions create separate lines of inquiry. A branch may be active, waiting for information, paused, revisited later, or sufficiently explored for now. The user may move between branches. This reflects how investigation itself works, not merely an async-software optimisation.
### A7 — Background assistance must not redirect the user
Semantic assistance may complete asynchronously without blocking the user's current work. A delivery platform may capture the user's contribution immediately, allow them to continue elsewhere, complete semantic interpretation in the background, and surface a possible connection later. But a late result must NOT move the user to another branch, replace what they are currently doing, silently choose the next question, or interrupt ownership of the investigation. Background reasoning may create something new for the user to notice, but it must not decide where the user goes next.
### A8 — Closure is user-owned and may be provisional
Closure does not require complete resolution of every branch or uncertainty. The user may decide there is enough information for now, remaining uncertainty is not material enough to pursue, the effort to learn more is not worthwhile, the decision can be made with what is known, or the investigation should simply pause. "Resolved" means reasoning content is answered/settled. "Closed for now" means the user chooses to stop investigating at this point. The reasoning record and unresolved questions remain available for future return. A later change in circumstances or new evidence may justify reopening the investigation. Do not define a closure score or threshold.
### A9 — The reasoning structure may be graph-like without forcing a graph UI
The underlying reasoning record may be connected and non-linear, while presentation remains flexible. Possible delivery views include: focused question view, notebook/branch view, map/mind-map/tree view, timeline, summary, voice interaction, book/workbook structure. These are views over the reasoning record, not different methodologies. Mind-map, family tree, or graph visualization must never be a required interface — they are presentation possibilities only.
### A10 — Progressive disclosure mirrors progressive reasoning
The Engine breaks a large situation into manageable pieces; the interface should not then expose the entire complexity by default. The user should normally see the smallest useful part of the reasoning needed for what they are doing now, while wider structure remains available when they choose to inspect it. Progressive disclosure should reduce distraction and cognitive overload while preserving access to the wider reasoning structure.
### A11 — Multilingual flexibility follows from meaning-based reasoning
A methodology based on generic reasoning structure and semantic interpretation is more naturally portable across languages than one dependent on an English keyword dictionary. The Confidence Engine itself must not encode English/domain vocabulary as the definition of reasoning meaning. A delivery mechanism may provide semantic interpretation in the language being used. This does not claim perfect multilingual equivalence or that every LLM performs equally well in every language.
### A12 — Latency is an implementation trade-off, not a reason to distort the method
Semantic interpretation may be slower than deterministic checks, but current model latency should not redefine the reasoning methodology. Establish the smallest correct reasoning operation first; optimise delivery later.
---
## Classification discipline for future work
When considering new development:
| This belongs as | Examples |
|---|---|
| **DURABLE METHODOLOGY PRINCIPLE** | user directs investigation, delivery-platform independence, meaning over prescribed vocabulary, non-linear investigation, provisional closure, progressive disclosure |
| **IMPLEMENTATION HYPOTHESIS** | asynchronous LLM inference, hybrid deterministic/semantic fast path, notification badges, map/tree UI, background worker architecture |
| **EXPERIMENTAL EVIDENCE** | individual experiment results (e.g. one relationship discovery test) |
> Do not accidentally promote implementation ideas into methodology.
---
## Hybrid interpretation clarification (implementation hypothesis only)
A delivery platform may use a conservative deterministic fast path for genuinely structural cases and semantic interpretation when meaning is required. The guardrail: the deterministic layer must not become a hidden semantic dictionary. This architecture has NOT been selected.
## 1. Principles for the User Experience
- **The system carries complexity; the user sees only the next step.** The engine manages graph theory, node IDs, schemas, prompt versions, and provider details.