Tool decisions made by demo are made by the vendor. This playbook designs a 4–6 week bake-off: a task battery drawn from your real backlog, a rubric that scores quality, speed, security, and developer experience, cohorts built to cancel enthusiasm bias — and a decision memo that states what evidence would have changed the answer.
Workflow area: Measurement & ROI · Tier: Core · Hands-on time: ~40 minutes to design; 4–6 weeks to run
The two failure modes of tool selection are mirror images. Hype mode: the shiniest demo wins, and three months later the licenses sit idle because the tool demos better than it works in your codebase. Incumbency mode: whatever arrived first stays forever, because nobody wants to re-justify a decision that is "fine." A bake-off is how you buy the right tool — and just as valuably, how you generate the evidence that makes the decision stick when the next shiny demo or the next budget review arrives.
Build the task battery from your backlog, not from benchmarks. Pick 8–12 real tasks that engineers actually did recently or will do soon, spanning your true distribution: a feature in your largest legacy module, a bug with a misleading stack trace, a test-coverage task, a refactor touching a gnarly interface, a small greenfield service. Public benchmarks measure the model; the battery measures the tool in your codebase, with your build system, on your worst code. Include at least two tasks the current stack handles badly — that is where differentiation lives.
Fix the rubric before anyone touches a tool. Four dimensions, weighted in advance so the winner cannot be chosen by adjusting weights afterward:
QUALITY (35%) - correctness on battery tasks; review findings
per PR; test adequacy (assertions, not lines)
SPEED (25%) - time-to-merged on battery tasks vs baseline;
iteration latency as reported by users
SECURITY (20%) - findings from pb-28 gates on generated code;
vendor posture: terms/tier per pb-34 comparison;
admin controls, SSO, audit logs
DX (20%) - weekly 4-question survey: would you keep it?
where did it fight you? plus friction notes
Security scores partly from documents (pb-34's vendor table), not usage — a tool can lose on terms alone, and it is cheaper to learn that in week one.
Design cohorts to cancel enthusiasm. Enthusiasts make every tool look good for two weeks. Recruit 3–4 engineers per candidate, mixing a skeptic and a mid-level engineer into each cohort — not just volunteers. Run a crossover where feasible: cohorts swap tools at the halfway mark, so each tool is scored by people who also used its rival. Everyone logs the same lightweight evidence — battery-task timings, PR links, and the weekly survey. Keep the trial period honest: 4–6 weeks, because week one measures novelty and only week four measures the tool.
Score in the open, decide in a memo. Compile scores per rubric line with the evidence linked. Then write the decision memo — one page, four sections: the recommendation; the scores with the two or three decisive gaps; what we are explicitly giving up (the losing tool's genuine strengths, recorded so the next evaluation starts honest); and what would change this decision — the falsifiable conditions ("if vendor X ships enterprise SSO", "if quality gap closes in two releases") with a named re-review date. That last section is what converts a purchase into a policy that can be revisited without a fight.
Roll out with the evidence attached. The bake-off's artifacts — battery results, survey verbatims, the memo — become the enablement material: "here is where it beat the incumbent in our codebase" lands better than any vendor deck, and the recorded weak spots become the training's honest warnings. Feed the winner's baseline numbers straight into pb-37's measurement system; you will want this before/after later.
Bake-off telemetry — per-engineer task timings, survey verbatims, acceptance data — exists to compare tools, not people; publish that purpose before the trial starts, report results only at cohort level, and destroy or aggregate the per-person raw data when the memo ships (pb-38's rules apply to trials exactly as they do to production telemetry).
Real tasks, pre-committed weights, skeptics in every cohort, and a memo that states what would falsify its own conclusion — that is the machinery that beats both the vendor's demo and the incumbent's inertia, and it costs four weeks against a decision your org will live with for years.