Method and trust

Evidence before confidence.

Build Pearls separates what a source establishes from the project action we suggest. Each Pearl shows where the lesson came from, which reviews have been completed, its limitations, and how a correction can be raised.

Knowledge boundaries

Three sources, kept clearly apart.

PUBLIC

Public-source Pearls

Lessons developed from an exact version and location in published investigations, standards, or official guidance.

Never described as field-tested, client-approved, or expert-reviewed unless those reviews have actually been completed.

FIELD

Field-contributed Pearls

De-identified project experience contributed by a practitioner, with separate attribution, verification, and publication checks.

A field story does not become a public-source rule and is not silently merged with one.

PRIVATE

Private portfolio Pearls

Client-specific project context, required proof, and role assignments used inside that client's workflow.

Kept out of public results, public counts, published source material, and other clients' results.

How a Pearl is published

Every change creates a new, traceable version.

Every published Pearl is generated from a reviewed version and stored with a content hash. Editing creates a new version, so its source and review history remain traceable.

  1. 01 · Exact sourceRegister the document, edition or date, exact location, URL, access date, jurisdiction, status, and retention rights.
  2. 02 · New versionCreate a new Pearl version with its editor, completed reviews, content hash, applicability, and limitations.
  3. 03 · Published copyGenerate the public Markdown, JSON, and search text, verify their hashes, and add a permanent audit event.
  4. 04 · Approved useShow only the version permitted by its publication, freshness, source, supersession, and client-access rules.

Review is not one badge

Each state answers a different question.

A Pearl can be source-checked without being reviewed for operational usefulness. It can also be published without independent expert review when the publication rules permit it. The interface never compresses those distinctions into an unexplained “verified” label.

Review checkPossible resultsWhat it tells you
PublicationDraft · in review · published · rejected · supersededWhether the revision may appear publicly
Source checkNot checked · checked · failedWhether the cited source and operational proposition were checked
Operational reviewNot reviewed · reviewed · changes requestedWhether a commissioning practitioner reviewed operational usefulness
Independent expert reviewNot reviewed · reviewed · changes requestedA separate expert review; never inferred from other states
FreshnessCurrent · review due · stale · superseded · withdrawn · unknownWhether source and review dates still permit use

What the source establishes

A bounded paraphrase with an exact locator.

The source statement stays close to the cited text and shows its jurisdiction, document status, and limitations. Protected standards are referenced, not reproduced.

Build Pearls operational translation

A project action that remains visibly an interpretation.

The relevant situation, required proof, responsible role, warning sign, agenda prompt, and return-to-normal check are original project guidance—not a quotation from the source.

Correction mechanism

A correction creates a traceable revision, never a silent edit.

The current preview explains the correction process but does not promise a response time until production ownership and service levels are approved.

Explore current coverage