Skip to content
@World-Semantic-Foundation

World Semantic Foundation

WSF: An authoritative, governed semantic foundation bridging meaning, representation, execution, and application.

World Semantic Foundation

An authoritative, governed semantic foundation bridging meaning, representation, execution, and application.

The World Semantic Foundation (WSF) provides a governed, versioned, authoritative semantic foundation from which downstream semantic systems ; enterprise architecture, assessment models, knowledge graphs, AI agents, and digital twins ; specialize, integrate, and extend without redefining foundational meaning. 5fde161 (docs: replace en/em dashes with colons and semicolons per punctuation rule)

The architecture bridges four normally separated concerns:

Meaning ──► Representation ──► Execution ──► Application

The 8 Repositories

WSF is implemented as 8 specialized repositories. Each repository has a clear role and they work together as a governed product foundation.

Core Semantic Repositories

RepositoryRoleStatus
wsfCanonical semantic assets ; authoritative concept definitions (Entity, Concept, Capability, Relationship, Event, State, Disposition, Proposition, Assertion, Identity, Context, Time, Space)Baseline
wsf-specNormative semantic & conformance specificationsScaffold
wsf-governanceArchitectural decisions, change requests, governance, lifecycle, authority, investigation recordBaseline
wsf-examplesReference applications (OTCHERE Inc, OTCHERE DC-01, Order Fulfillment Simulation)Baseline

Implementation Repositories

RepositoryRoleStatus
wsf-softwareWSF Semantic Engine (Semantic Store + Services + API layer)Scaffold
wsf-connectorsIntegration adapters for OpenDEA, EA platforms, KG platforms, AI agentsScaffold
wsf-visualsReproducible visual semantic assets (Mermaid, PlantUML, SVG)Scaffold
wsf-docsConceptual & implementation documentation (12 Foundational Principles)Partial

How to Navigate the Org

For Newcomers

  1. The 12 Foundational Principles
  2. The Top-Level README in wsf-governance
  3. The 17+ Architectural Decision Records
  4. The Tier 1 concepts

For Specific Lookups

To understand...See
What WSF is and whywsf-governance/README.md
The 12 Foundational Principleswsf-docs/conceptual/FOUNDATIONAL-PRINCIPLES.md
How WSF is governedwsf-governance/GOVERNANCE/
What concepts are definedwsf/concepts/
The investigation historywsf-governance/RESEARCH/INVESTIGATION-RECORD.md
Worked exampleswsf-examples/
The Semantic Engine architecturewsf-software/README.md
Integration architecturewsf-connectors/README.md
Visualization conventionswsf-visuals/README.md
How to author a new ADRwsf-governance/templates/ADR-TEMPLATE.md

The 7-Capability Product Architecture

The WSF Product Foundation provides seven mutually reinforcing capabilities:

 WSF
│
┌──────────────────┼──────────────────┐
▼ ▼ ▼
SEMANTIC KNOWLEDGE SEMANTIC
FOUNDATION ASSETS ENGINE
│ │ │
▼ ▼ ▼
INTEGRATION ──► VISUALIZATION ──► REALIZATION
│
supported by
│
GOVERNANCE
#CapabilityRepository
1Semantic Foundationwsf
2Knowledge Assetswsf-docs + wsf-spec
3Semantic Enginewsf-software
4Integrationwsf-connectors
5Visualizationwsf-visuals
6Realizationwsf-examples
7Governance (wraps all 6)wsf-governance

What WSF Provides

The architecture establishes an authoritative semantic layer that:

  • Establishes meaning through 12 Tier 1 foundational concepts (Entity, Concept, Relationship, Event, State, Disposition, Proposition, Assertion, Identity, Context, Time, Space)
  • Enables specialization through governed inheritance rules
  • Supports assertion of facts with full provenance, evidence, and trust evaluation
  • Maintains identity across representation, context, version, and lifecycle changes
  • Validates conformance through semantic constraint checking
  • Versions evolution while preserving semantic lineage

What WSF Is Not

  • A flat vocabulary or terminology list
  • An enterprise architecture metamodel (OpenDEA remains separate)
  • An assessment model (Assessment-Models remains separate)
  • A specific ontology technology (RDF/OWL/JSON-LD are implementation choices)
  • A repository convention (architecture follows semantic responsibility)

The 13 Foundational Semantic Domains

WSF recognizes the following foundational semantic domains:

DomainExamples
ExistenceEntity, Concept, Identity
OccurrenceEvent
ConditionState, Disposition
RelationRelationship, Specialization
IdentityIdentity, Identifier, Reference
SemanticsDefinition, Specification, Context
PropositionProposition, Assertion
QualificationContext, Validation
TemporalityTime, Event
SpatialitySpace, Position, Region
EpistemicsProvenance, Evidence, Trust

Boundaries Preserved

WSF operates in a federated ecosystem with explicit boundary preservation:

  • WSF : World semantics
  • OpenDEA : Enterprise Architecture specialization (separate org)
  • Assessment-Models : Maturity / Assessment governance (separate org)
  • Semantic Architecture / Ontology Architecture : semantic & formal representation layers

Each maintains independent lifecycle boundaries with governed semantic interfaces.


Tier 1 Foundational Concepts (12/12 Baseline)

#ConceptTierDomain
1Entity1Existence
2Concept1Existence / Semantics
3Relationship1Relation
4Event1Occurrence / Temporality
5State1Condition
6Disposition1Condition (Capacity, Ability, Capability)
7Proposition1Proposition
8Assertion1Proposition (attributed, evidenced)
9Identity1Identity
10Context1Qualification
11Time1Temporality
12Space1Spatiality

Capability (Tier 3 specialized Disposition) is included as a worked example.

Browse them: github.com/World-Semantic-Foundation/wsf/tree/main/concepts


Governance Model

The architecture operates under these governance disciplines:

  1. Investigation before implementation. Every architectural decision traces to documented investigation.
  2. Decisions are explicit. The architectural decision record (ADR) is the authoritative architectural statement.
  3. Implementation is traceable. Change requests implement ADRs with explicit scope.
  4. Lifecycle is governed. Semantic artifacts move through defined status states.
  5. Authority follows semantic responsibility. Not repository location.
  6. Identity persists through compatible evolution. Meaning-based identifiers survive representation, context, and version changes.
  7. Meaning precedes representation. Semantic authority is independent of format.

Canonical Example Convention

All WSF documentation uses:

  • Enterprise: OTCHERE Inc (or OTCHERE)
  • Individual: Kwesi
  • System: OTCHERE DC-01

Other enterprise names are not used in WSF artifacts.


Current State

ComponentStatus
Foundational semantic baselineFinal
Architectural decision records22 records (1 final, 21 baseline)
Tier 1 concepts12/12 final
Tier 3 example concepts1 (Capability)
Repositories live8
Reference examples3 (OTCHERE Inc, OTCHERE DC-01, Order Fulfillment Simulation)
Documentation12 Foundational Principles complete; remaining documentation scaffolded
ImplementationsScaffold; specifications provided by subsequent architectural decisions

Quick Links


WSF bridges meaning, representation, execution, and application ; under governed, versioned, authoritative semantics.

Popular repositories Loading

  1. wsf-test-probe wsf-test-probePublic

    probe

  2. wsf wsfPublic

    Canonical WSF semantic assets: authoritative Tier 1/2/3 concept definitions (Entity, Concept, Capability, Relationship, Event, State, Disposition, Proposition, Assertion, Identity, Context, Time, S…

  3. wsf-spec wsf-specPublic

    Normative semantic & conformance specifications — machine-readable WSF semantics, conformance requirements, serialization formats. Implementation-neutral specifications per ADR-WSF-23.

  4. wsf-governance wsf-governancePublic

    WSF governance: Architectural Decision Records (ADRs), Change Requests (CRs), investigation record, lifecycle documentation, status models, ADR/CR templates. Where WSF is governed, not just described.

  5. wsf-examples wsf-examplesPublic

    WSF reference applications: OTCHERE Inc canonical enterprise model, OTCHERE DC-01 digital twin example, Order Fulfillment simulation pattern. Worked examples showing WSF semantics in action.

  6. wsf-software wsf-softwarePublic

    WSF Semantic Engine:- deployable software platform (Semantic Store + Services + API layer). 11 engine capabilities per CR-WSF-17 Rev.1. Architecture documented; implementation awaits ADR-WSF-24.

    TypeScript

Repositories

Showing 10 of 10 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…