Skip to content

Engineering philosophy

Principles with enforcement, not values on a wall.

Each of these exists because a specific engineering failure demanded it, and each is enforced by the platform's own architecture — several fail our build when violated. Our full constitution is public.

Evidence First

Why — A claim without provenance is an opinion, and opinions cannot be audited.

Enforced — Every finding carries its rule, its artifacts and its commit. Reports are projections of findings — never fresh readings of the data.

Single Source of Truth

Why — Two sources of truth always diverge, and the divergence stays invisible until it is expensive.

Enforced — The repository is the only store. Every model is compiled from it, per run, and thrown away — a derived model can never disagree with the files for long.

Deterministic Engineering

Why — Certification requires the same answer twice. A tool that answers differently on Tuesday is not an instrument.

Enforced — No wall-clock, no randomness, no environment on any evidence path. Byte-identical regeneration is asserted in our test suite, not assumed.

Compiled Knowledge

Why — Meaning interpreted in two places becomes two meanings, and every save becomes an invalidation problem.

Enforced — A declared role becomes a typed relationship in exactly one module. Nothing downstream re-derives what something means.

Compiled Governance

Why — Policy re-evaluated at the point of use drifts with whoever evaluates it.

Enforced — Rules, rigour bands and inheritance resolve once, at load. Engines look policy up — they are forbidden from computing it.

Continuous Verification

Why — A review held twice a year catches drift twice a year — at its most expensive.

Enforced — A full analysis pass runs in milliseconds at five thousand requirements, so it runs on every change instead of every quarter.

AI with Explainability

Why — An unexplained suggestion is a liability anywhere a regulator can ask why.

Enforced — Inferred results are marked as candidates for human judgement, rendered as such at every surface, and excluded from reproducible evidence.

Organizational Memory

Why — The reasoning behind a decision leaves with the engineer unless it is captured where the work happens.

Enforced — Decisions are recorded with their rejected alternatives, in the repository, versioned with the engineering they govern.

The full constitution is public and versioned: ejadah-foundation.