Four layers · seven modules + M2b disaster-risk addendum · the T0–T7 schema is the content/code contract · build & stress-test via the wireframe.
Alliance Bioversity International & CIAT
World Bank D591 · June 2026
Pilots: Sierra Leone (FSRP) · Agroforestry
01
Framework primitives — reusable mechanisms every downstream module calls into
5 mechanisms · reusable
Five reusable mechanisms, one schema-driven engine.
Standardisation, weighting, MCDA, the recipe template and the subpractice pattern are the framework primitives every module below reads. They are specified and reusable — the build now is wiring them to the schema and into the wireframe to construct and stress-test the method, not rebuilding the analytical engine. Some run back-end / technical and are not surfaced in the TTL view (tagged below); the TTL tool exposes the simpler controls.
P1 · STANDARDISATION
Membership-function library
Canonical set: trapezoidal · gaussian · linear ↑/↓ · sigmoid · threshold · piecewise. Single list shared by schema & wireframe.
Risk to rural livelihoods · H × E (×AC) · baseline + future. ↓ M2b branches off in parallel (asset risk).
BrBrayden
T1T2
M3
4 / 7
SPEC'D
Opp Space Characterisation
Assembles T5 priorities + descriptors · poverty · biodiversity · IPLC · production · pop · farm size. BIND-resolved per AOI. Spec v0.1.1.
PPete
T1T5
M4
5 / 7
SPEC'D
Priority Hotspots (MCDA)
User-weighted MCDA on T5 priorities (mcda_role=priority) within opp space. M2b applied as scope, never summed. Spec v0.1.1 · uses shipped mcda.py.
PPete
T5
M5
6 / 7
SPEC'D
NbS Scorecard & Response
Likert effects (T6 linked only to T5 priorities) · economic archetype + cost-effectiveness denominators · benefit profile. Spec v0.1.1.
PPete
T3T6
M6
7 / 7
SPEC'D
Implementation Hand-off
Next-step tools · context tailoring · feasibility & domain pointers · FPIC/ESS7 flag on IPLC overlap · country-endorsed source list (context_sensitivity=high). Spec v0.1.1.
PPeteMMFL team
T0T6
↳ branches off M2 parallel lens
M2b
addendum
SPEC'D
Project Disaster-Risk Screen
Risk to the investment / asset · WB Climate & Disaster Risk Screening · baseline + future. Two streams at v0.3.0: A = asset hazard exposure (T2 × T3 asset_threat); B = operational/enabling levers (accessibility · tenure incl. IPLC+FPIC · conflict · governance · finance · market · labour). Filter / flag, never summed.
BrBrayden
T1T2T3T7
Evaluated within the M1 opportunity space → later exposed as a third scope on M4 Priority Hotspots. Two-risk distinction: M2 = risk to livelihoods (a need layer); M2b = risk to the investment (a feasibility filter).
src/nbs_ruralscan/ (uv · ruff · ty) — schema_tools · recipe · runtime · ingest · data_loaders. Implements the primitives in Python (xarray · rioxarray · xee); reads T0–T7, never hardcoded. Data pulled into Python from the GEE catalog and other sources; GEE processing runs through xee.
BUILD · LEAD
WIREFRAME → METHOD HARNESS
Pete + Claude — we build the method into the v0.7 wireframe and stress-test it interactively. The primary working surface and WB-facing demonstrator. (Not contractual; GEE App dropped.)
BUILD
COLAB DELIVERABLE NOTEBOOK
Per-pilot — reproducible, the contracted hand-off to the WB technical team.
PHASE 3
PILOT × 2
Apply methodology to 2 LDC pilots — SSA + Asia (or per Dinara's offer).
CONTRACT
The schema (T0–T7) is the seam between content and code.
Primitives power the pipeline; recipes parameterise it; runtime consumes recipes through the schema. Analytical rules read from the schema — never hardcoded. New NbS = new schema rows, not new code.
Variable selection — Ani's three principles, sub-step in M1 & M3
REDUCEThematic grouping (per recipe) + correlation cluster (per AOI). One representative per cluster enters MCDA.
SOURCEGEE catalog → community → upload; data pulled into Python. Fitness-for-purpose precedes platform.
EXPLAINEvery variable shipped as a Variable Card: What · Why · How to read · Cluster · Source · Interpretation.
Scope guardrails — for the World Bank deliverable
NOWBuild the method into the v0.7 wireframe & stress-test it · agroforestry F1 evidence sweep (18/23 papers) · M2b two-stream (asset hazard + operational levers) · Sierra Leone pilot scaffolding.