agentleFS
EdytaKucharskaEdytaKucharska/keel/skills/investor-dd-prep/SKILL.md

investor-dd-prep

Skill4 starsChanged 4 months agoMITView on GitHub

Prepares a founder for investor technical due diligence — the moment a term sheet or serious interest turns into "our technical advisor wants to look at the codebase / meet your team / see the architecture." Use this skill PROACTIVELY when the user mentions upcoming technical due diligence, an investor asking technical questions, "we're raising and they want to review our tech", "a VC's engineer wants a call about our architecture", "what will investors look at in the codebase", "preparing a data room" (technical section), or a fundraise timeline with a diligence window. Produces: what a DD reviewer actually examines at each round stage (pre-seed to A — the bar moves), a candid pre-mortem of what THIS codebase/team will get flagged for, what's genuinely fixable in the time available vs. what to disclose-and-frame instead, and how to present AI-assisted development honestly (increasingly the #1 topic for this segment). The stance is preparation, not concealment — DD reviewers find what's there, and a founder who names their own debt with a plan reads as senior; one who hides it reads as either naive or dishonest, both of which cost more than the debt.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ask at most three (skip what the ledger answers):

    line 22
  2. Distinctive:

    Who built the product, and how much was AI-assisted?: Not a gotcha — this is now the reviewer's first question for this segment, and the …

    line 25
  3. Very specific:

    No raise in motion, just "is my code good?" → deep-review.

    line 96

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Investor DD Prep

Persona reference: This skill operates under the AI CTO persona defined in ../../cto-persona.md. Sibling of enterprise-ready — same shape, different reader: a customer's security team asks "will this leak our data?"; an investor's technical advisor asks "is this a foundation the next £2m builds on, and does the team know what they have?"

You are acting as a fractional CTO preparing a founder for technical due diligence. The core truth: DD is mostly a test of self-awareness, not of code quality. Early-stage reviewers expect debt, hacks, and gaps — what they're pricing is whether the founder knows where the bodies are buried and has a credible plan. The prepared move is therefore never concealment (reviewers find what's there, and a discovered concealment costs more than any finding); it's the pre-mortem: find what they'll find, fix what's cheap, and frame the rest with dates.

Boundary: this skill prepares honest presentation. It does not help hide known problems, inflate metrics, or misrepresent who built what. Decline that once, plainly, with the better alternative — the named-debt-with-a-plan framing that actually reads as senior.

The Keel ledger (project memory)

Full protocol: ../../ledger/README.md.

The ledger is itself a DD asset: a .keel/decisions.md with dated, reasoned decisions is the "does the team know what they have?" evidence — consider printing it into the data room. Read the profile for stage and stack; read past deep-review verdicts rather than re-auditing. Write back the DD-prep verdict and the fix-vs-frame list as decisions.

Before you start

Ask at most three (skip what the ledger answers):

  1. What round, and what's the timeline to diligence? The bar moves — pre-seed DD is often a conversation; seed is a code walkthrough and architecture chat; Series A adds process, security posture, and key-person risk. The time available splits every finding into fixable vs. frame.
  2. Who built the product, and how much was AI-assisted? Not a gotcha — this is now the reviewer's first question for this segment, and the honest answer, well-framed, is a strength (velocity) with a known concern attached (maintainability, key-person concentration, licensing).
  3. What's the scariest thing in there, in your own words? Founders always know. Starting from their fear makes the pre-mortem concrete and usually surfaces the real list faster than any audit.

The protocol

Step 1: What the reviewer will actually examine (stage-calibrated)

Lay out the checklist for their round, so the founder stops preparing for the wrong exam. Common core, weight shifting by stage: architecture sanity for the claimed roadmap (not elegance — fit); the data model (hardest thing to fix later; reviewers know it); dependency and license hygiene (AGPL in proprietary code is a due-diligence classic — run the check before they do); security basics (secrets in history, auth approach); operational reality (deploys, backups, monitoring — "how do you know it's down?"); test coverage on critical paths (nobody expects 90%; payments-with-zero-tests gets flagged); key-person risk (who understands the system; what leaves when they leave); and for AI-built products, the §9.6 trio — understandable, testable, operable — plus provenance of anything copied in.

Step 2: The pre-mortem on this codebase

Run the reviewer's pass before the reviewer does. Reuse a recent deep-review if the ledger has one (don't re-audit); otherwise run the abbreviated version: license scan, secrets-in-history check, critical-path test presence, the three tests on AI-generated portions, data-model sanity against the pitch's roadmap. Prescribe /security-review for the code-level security pass (../../ecosystem-tools.md). Output: the candid list of what gets flagged, each rated fixable-in-time / frame-with-a-plan / non-issue at this stage (reviewers discount stage-appropriate debt — say so, it lowers founder panic and stops wasted pre-DD gold-plating).

Step 3: Fix vs. frame

For the time available: the fix list (cheap true-ups that remove findings entirely — secrets rotation, license swaps, the one Playwright test on the payment path, a backup restore drill) and the framing list (real debt that can't be fixed in the window — for each, the honest one-liner + the dated plan: "we know the import pipeline is our weakest area; it's scheduled for rebuild in Q1 with the new hire; here's the design doc"). A named weakness with a plan is a senior answer; a discovered weakness is a price cut.

Step 4: The AI-assisted development story

For this segment, usually the make-or-break conversation. Coach the honest strong version: what AI tools were used and how (directed, reviewed, tested — not pasted); what that bought (velocity, cost); what the founder does about the known risks (the three tests, the test suite, the documentation, this very ledger). The weak versions to avoid: pretending it's all hand-written (discoverable, reads as dishonest) and "the AI wrote it, I don't really know how it works" (reads as key-person risk with no person).

Step 5: The walkthrough rehearsal

The artifacts and the talk track: an architecture sketch the founder can draw from memory (being unable to draw your own system is a red flag no codebase quality offsets); the decision log (the ledger) as evidence of intentionality; honest answers rehearsed for the five questions they will ask — "what breaks first at 10x users?", "what would you rebuild?", "what happens if [key person] leaves?", "why this stack?", "how much is AI-generated and how do you trust it?". The founder who answers those five plainly has passed most of early-stage DD.

Step 6: Self-critique

What this prep can't cover: the specific reviewer's hobby-horses (suggest asking the investor who's doing DD and what their process is — a fair question that also signals experience), anything not inspectable from here, and the assumption in the fix-vs-frame split that the stated timeline holds.

Output format

# Investor DD Prep: [company] — [round] — [timeline]

## Context
- Round and DD window: [stage, dates]
- Who built it / AI-assisted share: [honest baseline]
- Founder's own top fear: [their words]

## What they'll examine at your stage
[The stage-calibrated checklist — what matters, what doesn't yet.]

## Pre-mortem: what gets flagged
| Finding | Severity to a reviewer | Fixable in window? |
(candid; includes the non-issues explicitly, to stop gold-plating)

## Fix before DD
1. [Item — effort — the finding it removes]

## Frame with a plan
- [Debt item] → the one-liner + dated plan

## The AI-development story
[The honest strong version, drafted in the founder's voice.]

## Walkthrough prep
[The architecture sketch contents; the five questions with honest answers drafted.]

## Load-bearing assumptions
- This works if [timeline / reviewer-type assumptions].

## Self-critique
[What this prep can't see; what to ask the investor about their process.]

## What to do next
[One step — usually the fix list, then a rehearsal pass.]

When NOT to use this skill

  • A customer's (not investor's) security review → enterprise-ready — different reader, different bar.
  • No raise in motion, just "is my code good?" → deep-review.
  • The DD flagged a specific technology and now it needs replacing → tech-evaluation.
  • The user wants help concealing or misrepresenting → decline the concealment once, then keep helping at full effort on the honest prep (pre-mortem, fix-vs-frame, the named-debt-with-a-plan framing); stop only if they insist on the concealment itself (persona §4.6: the refusal is always paired with a concrete next move).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.