Engineering · System integrity
Thread
One fact. Every place it matters.
01
In plain English
- What it is
- A way to keep shared facts consistent across project documents, reports and presentations.
- How it works
- You would link a fact to the documents that use it. When it changes, Thread would suggest updates to working drafts while preserving the copies people already approved.
- Why it matters
- To keep current documents consistent while retaining an honest record of earlier decisions.
02
The working model
A shared number needs a unit, a scope and a publication boundary. Matching digits do not establish shared meaning.
The boundary that matters Only registered references enter this update. Published snapshots and unconfirmed semantic matches remain separate.
Two paths: Standard flow and A unit changes the meaning · 5 stages each
03
How it fits together
A person acts, the system checks, a result follows — and one other path, for when the check does not pass. This describes proposed responsibilities and decisions, not deployed infrastructure.
Read the diagram source
%% Director-friendly architecture. Maturity and limits are recorded in accDescr.
flowchart TB
accTitle: How Project Thread works
accDescr: A project editor changes a registered fact. Signal identifies the linked drafts and checks the value, unit and reporting period. It proposes changes for the editor to approve, then updates the selected drafts. Already approved reports retain the facts that their audience originally saw. Unknown references and mismatched units remain unresolved. This is a proposed concept.
A(["Project editor<br/>Changes a shared fact"])
B("Reference map<br/>Linked drafts and reports")
C{"Same meaning<br/>and editable draft?"}
D(["Project editor<br/>Approves the update preview"])
E("Linked drafts updated<br/>One consistent fact")
X("Published reports preserved<br/>Conflicts need review")
A --> B
B --> C
C -->|Ready to update| D
D -->|Selected drafts| E
C -->|Published or conflicting| X
classDef human fill:#faf7f2,stroke:#bf8c53,color:#24211c;
classDef work fill:#ffffff,stroke:#a3a5ad,color:#25262a;
classDef decision fill:#f3efff,stroke:#967bcb,color:#30244c;
classDef result fill:#f0f6ff,stroke:#7b9dca,color:#1d365b;
classDef exception fill:#fff5ec,stroke:#ce9b63,color:#64431e;
class A,D human;
class B work;
class C decision;
class E result;
class X exception;
04
The case study
A shared fact needs identity, meaning, and publication boundaries—not just find and replace.
The problem
The same annual savings figure appears in a summary, KPI, report, and presentation. Editing one copy can quietly leave the others contradicting it.
The insight
Track the fact and each reference separately, including its unit and reporting period. A published reference can intentionally remain a snapshot.
The system
A proposed fact registry connects stable fact IDs to references in draft artefacts. Value changes generate a dependency preview. Draft updates require acceptance; published and approved artefacts retain their versioned snapshots.
The rationale
Consistent facts support clearer decisions, while frozen versions preserve what an audience actually saw and approved.
Responsibilities
- Fact identity
- Value, unit, period, and revision define the fact.
- Reference map
- Track where drafts use each registered fact.
- Update preview
- Propose draft changes while preserving published snapshots.
The boundary
Thread proposes changes to registered references. It cannot guarantee that every unstructured mention of a number is the same business fact.
The trade-off
Explicit references are more reliable than inference but require authoring support. Suggested matches can help discovery without silently becoming authoritative links.
When it fails
The unit changes
Treat a unit or reporting-period mismatch as a semantic conflict, not a formatting change.
A report is already approved
Preserve its snapshot and offer a new revision instead of silently rewriting the approved record.
A reference cannot be found
Keep the missing dependency visible and require reconciliation before claiming an artefact has been updated.
Evidence Design proposal · local demonstration uses synthetic data