Skip to content
SMART Recommendations

SMART Recommendations · Docs

Authoring a SMART Recommendation

From Recommendation text to a validated package: the methodology, the gates, the walkthroughs. Start with the overview, then the chapters in order.

  • Overview — the corpus map
  • The Authoring Method — The end-to-end method in seven moves; the validation gates; the pitfalls catalog.
  • Modelling the Subject — Subject types, variants, dimensions, attributes, capabilities, behaviors, conditions.
  • Requirements — Anatomy; binding; OCL limits; applicability; verification methods; tables and profiles.
  • Conformance Tests — Variables and sources; steps; conditions; acceptance criteria; inheritance; instances; kinds and obligation.
  • Forms and Reports — Bind paths; measurement methods; pass/fail; the test-report skeleton; checklists; omissions.
  • Evaluation — Determinations, verdicts, model evaluation, decision; the certificate template; approvals.
  • Packaging — The package layout; uses composition; sample data; registration.
  • Walkthrough: R 60 — The worked example, end to end.
  • Walkthrough: R 91 + R 144 — Traffic speed meters and gas analytical systems: the stress cases.
  • Modelling Your Lab — The laboratory’s SOPs, equipment register and record forms as an implementation package (a fictional worked-example laboratory).
  • Migrating from YAML — The two trees and the round-trip discipline; the facets and packages of the v3 model; the gates.
  • Modelling Your Product — The manufacturer’s product reference package (the ACME LC-500 worked example).
  • Running the Demo — The demo manual: bootstrap, walkthrough, verification, run the full certification chain yourself.
  • Role Paths — Your first 10 minutes, per seat, the on-ramp per role, ending at the demo manual section for your depth.
  • Operator Guides — The twin flows, per role: twin-lab operator, lab tester, scheme operator, auditor.
  • The Campaign Protocol — The real-instrument campaign protocol, execution-ready, waiting on a physical instrument with a Primmel SMART twin.
  • The Campaign Report — The first demonstration campaign, executed 2026-08-01 against the OIML SMART SST.