Turn an AI proposal into a decision brief: the verdict, the evidence gaps and the next action for the person who owns the work.
Try one proposal in your browser
Open aibvf.com/start. Your first assessment needs no account or installation.
Review an AI proposal and return Stop, Fix or Accelerate, the decision gaps and the next action.
2026-11-15
Stars
โ
Tools
โ
Uptime
โ
Paste this synthetic example, or describe a proposal you are reviewing:
We are a EUR 2.4bn manufacturer considering GenAI for predictive maintenance in our supply chain. Our operating model is traditional. We have a sponsor, but the affected roles, human override rights and performance measures still need review.
Run the assessment, check how the proposal was interpreted, and correct the assumptions. The assessment asks for unresolved inputs and marks estimated pillar scores. Keep the action list, name an owner and return with evidence when the work changes.
The decision brief
The result brings the following questions together. This is an illustrative reading guide for the example, with the engine's field names documented below.
Part of the brief
What to review
Verdict
Stop, Fix or Accelerate, with the rule that produced the call. An initial proposal with estimated pillars remains provisional.
Evidence gaps
Which inputs were supplied, which were estimated, and what remains unknown about workflow, roles, decision rights and measures.
Planning benefit
A readiness-adjusted EUR scenario. Build costs, operating costs, change costs and financial timing still need a separate business case.
Decision score
A 0 to 100 summary of pillar inputs and input completeness. It has no calibrated probability interpretation.
Next action
The evidence or work change needed before another review, with an accountable owner assigned by the team.
For the example above, the first useful action is to evidence the proposed workflow and its owners. An Accelerate verdict requires the pillar thresholds to clear and all four work architecture checks to be met.
See the reproducible worked example for exact inputs, calculations and a re-score that stays at Fix until the work architecture is evidenced.
Bring the assessment into your existing workflow
The browser is the first-use route. The hosted connector and local MCP package let an assistant repeat the assessment while you work on a proposal.
Hosted connector on claude.ai
Open Settings, then Connectors, then Add custom connector, and paste:
https://mcp.aibvf.com/api/mcp
Then ask:
Assess this AI initiative using AI BVF: we are a EUR 2.4bn manufacturer considering GenAI predictive maintenance, with a traditional operating model. Resolve the inputs, show the assumptions and identify the evidence needed for the next decision.
Start with assess_ai_initiative. Use recommend_improvements for a Fix or Stop, review the proposed actions with the people who own the work, and re-score after the evidence changes.
How to read a result
AI BVF is a deterministic planning model with disclosed assumptions. The source and formulas can be inspected, and identical inputs produce identical outputs for a given engine version.
The four pillars are Strategic Alignment, Financial Return, Change Enablement and Governance Risk. GR >= 70 or FR <= 20 returns Stop; SA >= 60, FR >= 60, CE >= 60 and GR <= 40 clear the pillar test for Accelerate. A gap, partial assessment or missing work architecture evidence holds an otherwise green initiative at Fix.
Keep these boundaries with the result:
Decision score. Existing API fields confidence, decision_confidence and projected_confidence retain their names for compatibility. These are rule-based scores, with no measured probability of project success or prediction accuracy.
Planning benefit. The scorer's net_low_eur, net_high_eur and MCP net_value_eur apply a readiness capture assumption to a revenue-based benefit scenario. Project costs, margins, timing and overlap are outside that calculation.
Research context. External research informs the questions. It does not publish or validate the AI BVF function rates, industry multipliers, readiness capture percentages or drag rates.
Module labels.applied_modules records implementation context. Labels such as healthcare_clinical_validation and financial_dora_module do not perform clinical validation or certify regulatory compliance.
Supplied evidence. The engine records supplied values and work architecture checks. The organisation remains responsible for reviewing the evidence behind them.
Thirteen tools are exposed through local stdio and the hosted Streamable HTTP connector.
Tool
Purpose
assess_ai_initiative
Resolve a plain-English proposal, request missing decision inputs and return the assessment.
score_initiative
Score explicit inputs, apply the work architecture gate, and return reasoning, audit and sensitivity.
recommend_improvements
Propose pillar actions and work redesign steps for a Fix or Stop. Re-score evidence before accepting a projected outcome.
assemble_portfolio
Structure loose portfolio inputs, resolve aliases and disclose estimated pillars.
validate_portfolio
Validate a portfolio document against the published JSON Schema.
score_portfolio
Score a portfolio and return its aggregate shape. Review benefit overlap before using a total.
sequence_portfolio
Produce rollout waves with change-capacity constraints and named gates.
diagnose_process
Evaluate observed process signals and return an intervention with its modelled effect.
infer_readiness
Infer a readiness classification from supplied process signals and report coverage.
calculate_pace_layer_drag
Return a directional scenario for operating-model friction using disclosed rates.
get_benchmark
Return AI BVF planning rates with evidence status and use guidance.
list_taxonomy
List the accepted industries, functions, AI tiers and readiness levels.
map_to_taxonomy
Map everyday business terms to the supported taxonomy and expose unresolved terms.
For portfolios, use assemble_portfolio, validate_portfolio, score_portfolio, then sequence_portfolio. An aggregate modelled range needs a separate review of overlapping work and shared benefits.
Python scoring engine and validator. Check its documented feature coverage before substituting it for the TypeScript implementation.
The public portfolio specification is version 1.0. That document format has a separate version from the packages implementing it; the package version identifies the code and behaviour used for a particular assessment.
The MCP server can report tool calls and a server_connect event. Events include protocol and package versions, entry route, assessment stage, work architecture status, taxonomy fields, a daily-rotated caller hash, and classification plus confidence where supplied.
Local stdio calls also include a stable one-way install_hash for repeat-use measurement, derived from a random local seed. Hosted calls send no stable install hash, and a broad user_role is sent only when a local user explicitly sets AIBVF_USAGE_ROLE.
No portfolio content, revenue figures, numeric pillar scores or personal identifiers are included. Set AIBVF_TELEMETRY_DISABLE=1 to prevent events and creation of the local install-id file. Point at your own backend with AIBVF_TELEMETRY_URL and AIBVF_TELEMETRY_KEY.
Package downloads include repeat installs, dependencies and automation. Use completed assessments and subsequent decision reviews to evaluate adoption.
Contribute a case or a correction
Bring a reproducible counterexample: the inputs, actual output, expected decision, supporting evidence and engine version. The contribution guide includes a template and explains the review and licensing boundaries.
The ten-team pilot pack defines the first-use and return-use checks, interview prompts and tracker. Examples in this repository are synthetic unless a case explicitly records consent and its evidence.
If AI BVF helped you review a decision, star the repository or share a counterexample. Both give the project useful feedback.
License
Repository source code is MIT licensed under LICENSE. The specification and JSON Schema under spec/ are CC-BY-4.0, and the AI BVF names and logo are trademarks, as set out in NOTICE.
Private benchmark material and certification marks are outside the source-code contribution route. The contribution guide explains how to discuss those materials without changing the rights granted by the repository licenses.
About the author
Craig Horton is an independent transformation lead based in Amsterdam and the author of the AI Business Value Framework. His work connects AI investment decisions with organisational readiness and the redesign of work.