Who reads it, and what it changes
A diligence report has one job — moving a decision someone is about to make with money — so a report that would read identically whether the deal proceeds or dies has failed, however much it found.
You can already do the hard technical half of this. Dropped into an unfamiliar React codebase you have not seen before, you would know inside a day whether the design system is real or decorative, whether the types constrain anything, and whether a new surface could be grafted in without a rewrite. That is not the gap.
The gap is that the artifact this skill produces — a document — is worthless until you know who opens it and what they are about to decide. Write the same set of true observations for the wrong reader and you have produced a very good piece of writing that changes nothing. That failure is invisible from the inside, because every sentence in it is correct.
The reader is not an engineer, and the document is not for you
Start with the one piece of this that is not inference. Vista publishes a Sustainable Investment Policy, effective December 2025, and buried in it is the only concrete description of a pre-investment technical review the firm puts on its own site:
“Value Creation team subject matter experts conduct an in-depth review of the company’s technology, cybersecurity and data privacy practices before platform private equity and permanent capital investments.” (Vista Equity Partners, Sustainable Investment Policy)
And then, on what happens to what those experts find: significant findings are generally communicated to the investment committee and management teams and, where applicable, are included as part of the company’s 100 days list.
This is a firm describing itself, so read it the way you would read any self-description: it tells you what they are willing to commit to in public, not how the work actually feels. But even taken at exactly face value it hands you three things you would otherwise have had to guess.
- The people doing the review are operators, not the deal team. The same organisation that publishes an Agentic Factory as its first value-creation pillar is the one named as doing pre-investment technical review. Those are not separate careers; they are the same job at two moments in the deal.
- There are two readerships, not one. The investment committee, who are deciding whether and at what price. And the management team, who are the subject of the document and will still be running the company on Monday.
- There is a downstream artifact with a name. Findings do not evaporate at close; where applicable they become entries on a 100 days list. That is a to-do list with an owner and a clock, which is a much more demanding destination for a finding than “noted.”
Do not extrapolate past that. Vista publishes no diligence methodology, no checklist, and no description of how a technical review is actually run — and inventing one in an interview with people who do it every week is the single fastest way to lose the room.
What a finding is allowed to change
Outside that one policy sentence, the public literature on technical due diligence is written almost entirely by firms that sell technical due diligence. That is worth stating plainly rather than pretending otherwise: what follows is trade marketing, and it is also the only published description of the mechanics that exists. Read it as a sales brochure that happens to describe the product accurately.
The consistent picture across those sources is a ladder, where the severity of a finding maps to a different deal mechanic. One vendor selling five-day diligence reads to private equity sets it out as four rungs: critical findings reprice the deal or trigger escrow; high findings require a remediation plan before close; medium findings go into the 100-day operating plan; low findings are left to the portfolio company on its own timeline. Note where that lands the middle of the ladder — on exactly the artifact Vista names.
A second vendor, this one selling both buy-side and sell-side reviews, is blunter about what usually happens:
“A confirmatory finding rarely kills a deal on its own. More often, it gives you a number to negotiate with” (MEV, a firm that sells technical due diligence)
That sentence is the whole lesson compressed. Your document is not a verdict. It is an input to a negotiation and a starting position for a remediation plan, and both of those consume numbers. A finding that cannot become a number — weeks, headcount, a condition of closing — has no slot to fall into.
Evidenced, not asserted
There is a second consequence of knowing your reader, and it is about form rather than content. A committee reading your page was not in the management meeting. They did not see the demo, they have not met the engineering lead, and they cannot tell your confident tone from your hedged one because they have no baseline for either.
One vendor — selling data-room software rather than diligence itself, so with a different axe to grind — draws the distinction as a report being “lender-grade”: written for a credit committee that was not in any management meeting, so every material finding is evidenced rather than asserted.
Applied to your axes, that is a real constraint with teeth. “The design system has poor adoption” is an assertion. “Three of the five screens I could reach use buttons that are not from the published component package; here they are” is evidence. The first one is what you would say to a colleague and it is completely adequate for that. The second is what survives contact with a management team that would prefer the first one not be true.
Nobody has claimed this territory yet
Here is the finding that should change how you feel about having zero diligence experience. Go through the published checklists — Bain frames its coverage as product functionality, infrastructure, security and innovation potential (Bain sells tech diligence to private equity); a specialist shop enumerates seven workstreams covering architecture, code quality, team, security, IP, data and roadmap (also selling the service); an openly licensed field guide for the CTO on the receiving end lists a full data-room checklist down to DORA metrics, incident logs and contractor IP assignment.
Not one of them names user experience, design systems, accessibility or front-end performance as a workstream. The front end is present only implicitly, dissolved into “architecture” or “code quality” or “integration readiness.”
Two honest readings of that, and you need to hold both. The uncomfortable one: it may be absent because the people paying for diligence do not think it moves a price. The useful one: for a firm whose stated plan is to build agentic products across a portfolio of 85 or more companies, the cost of changing an interface is not a footnote to the deal — it is the cost of the entire operating thesis, repeated 85 times.
Either way, the instrument you are building is an argument, not a standard you are implementing. Say that when you present it. Claiming it is established practice is checkable in thirty seconds and false.
Retrieval check
Your draft says: “The product has significant UX inconsistency and would benefit from a design system investment.” What is wrong with it, in the terms this lesson set out?
Check your answer
Three things, and the third is the one that matters.
It is asserted, not evidenced — a committee that was not in the room has nothing to check it against. It has no number, so there is no rung on the ladder it can land on: it cannot reprice, cannot become a condition of closing, and cannot become a 100-day item, because none of those accept “would benefit from.”
And it fails the decision test. Ask what would have to be different in the sentence for the investment committee to act differently, and there is no answer, because the sentence contains no threshold that could have come out the other way. It would read identically whether the company were a disaster or merely untidy. A finding that survives any state of the world is not a finding.
Hands on
Give the rubric a reader
Done when: RUBRIC.md’s cover block has a filled-in reader line and a written decision test, and at least one axis question has been deleted or rewritten because it failed that test.
- Open
learning/ux-diligence/RUBRIC.md. Add two rows to the cover block: Reader and Decision this is meant to move. Fill them in for a hypothetical software company being acquired — be specific about which reader, since the investment committee and the management team want opposite things from the same page. - Underneath the cover block, write the decision test out in full as a standing instruction to yourself: name the decision, then say what would have to be different in this document for the decision to be different.
- Now run that test against the nineteen questions already seeded in the rubric. Find at least one that fails it — a question whose answer, whatever it turned out to be, could not change a price, a condition of closing, or a 100-day item.
- Delete it, or rewrite it until it produces something a deal team could put a number against. Write one line next to it saying which you did and why. That line is the beginning of the design rationale you will be asked to defend out loud.
- Bring the changed cover block and the question you cut into the chat. I will push back on any question you kept that is really an observation with good manners.
What this does not cover
Knowing who reads the page tells you nothing about how complete it has to be, and that is the next thing to get straight. There is a strong instinct — a good engineering instinct, in most contexts — to find everything before you report anything. The audit-versus-diligence lesson is about why that instinct produces the wrong document here, and what replaces completeness once you give it up.
The constraints that make completeness impossible in the first place — the clock, the access, and a counterparty who has an interest in your conclusion — get their own treatment after that, in the lesson on the three constraints.
Read this next — primary source
Sustainable Investment PolicyVista Equity Partners, effective December 2025 — free; the firm describing its own process
The lesson takes one sentence out of it. Reading the whole document does something the sentence cannot: it shows you that the only concrete, published description of a pre-investment technical review that this firm puts on its own website lives inside an ESG policy, as a single clause, surrounded by climate and governance language. That is a bracing calibration on how large your workstream looms in the machine you are trying to join — and it is the difference between walking in with a realistic picture of where your page lands and walking in assuming everyone has been waiting for it.
Stuck, curious, or think this lesson is wrong? Ask your teaching agent. The lessons are the scaffold; the conversation is where the learning gets unstuck.