How it works

Three weeks. Five stories. One decision.

We read the decision history your systems left behind — code, commits, tickets, ownership — and turn it into answers your board can act on. Delivered in three weeks, then kept current as your systems change.

What we actually do

Decision archaeology.

Every system is a dig site. The code is one layer. The commits, the tickets, the PRDs, the deployment history, the team structure — each one preserves decisions nobody remembers making. We excavate all of them.

We don't audit code quality. We answer business questions.

The process

Three phases. Three weeks.

Phase 01

Connect

Week 1

We get read-only access to your systems. No disruption to your team.

  • Codebase access (GitHub, GitLab, Bitbucket)
  • Ticket system sync (Jira, Linear)
  • PRDs and documentation
  • One 30-minute stakeholder call
  • Read-only. Always.
Phase 02

Map

Week 2

Our tooling correlates everything. Commits to tickets. Tickets to requirements. Requirements to code. We build the real picture.

  • Code archaeology — trace how decisions became code
  • Knowledge graph construction — who knows what, how concentrated
  • Automated system topology — the real architecture, not the diagram
  • Risk correlation — technical findings linked to business impact
  • Drift analysis — stated intent vs. actual implementation
Phase 03

Deliver

Week 3

You get answers you can act on. Stories backed by data, options backed by numbers.

  • Executive briefing (60–90 minutes)
  • Five Stories with supporting evidence
  • Risk map — which risks matter, which are dormant
  • Strategic options — fix, rebuild, or hybrid with effort and trade-offs
  • Searchable knowledge base of your entire system
Technology + Judgment

Technology finds the data. Experience finds the truth.

Our tooling surfaces everything hiding in your system — across code, commits, tickets, PRDs, and deployment history. Our practitioners turn those findings into decisions you can act on.

Risk mapped to decisions

Which risks are actively slowing you down, which are safely dormant, and what each one means for the business. Not "high complexity" — actual implications.

Compliance by framework

SOC 2, PCI DSS, GDPR, NIST — readiness scored per framework. Gaps identified with remediation priority.

Security & dependency risk

Where you're exposed — security holes, leaked secrets, end-of-life dependencies and license traps — framed as the risk an acquirer or regulator would flag, not a raw CVE list.

Strategic options, not just findings

Fix, rebuild, or hybrid — each option with effort, timeline, and risk reduction. An independent read you can act on, not a rebuild we're selling.

What we access

Four inputs. That's it.

Codebase

GitHub, GitLab, or Bitbucket. We clone and analyze. We never write.

Read-only

Ticket System

Jira, Linear, or equivalent. We map tickets to commits to understand intent.

Read-only

Documentation

PRDs, architecture docs, runbooks. Whatever exists. Sparse is fine.

Read-only

One Stakeholder Call

30 minutes. We ask the questions your team won't ask each other.

30 min

How a question becomes an answer

One question, drilled until it's answerable.

We start with the question a leader actually has, break it into sub-questions, name the exact records that answer each, and pull them. Here is one question, end to end.

Big question

“What breaks if a key engineer leaves?”

Sub-questions & the records we pull
Ownership
  • Who wrote it?
  • Who maintains it now?
  • Who else has touched it?

git authorship + merge/blame history

Concentration
  • Where does one person hold the knowledge?
  • Which systems have a single author?
  • What has no second reviewer?

single-author analysis across the commit graph

Criticality
  • What does this code run?
  • What depends on it?
  • What fails without it?

dependency & call graph

Continuity
  • What is documented?
  • What lives only in their head?
  • What would a successor need?

tickets, PRDs, comments, doc coverage

↓ then we map what we pulled ↓
Answer

Bus factor = 1 across every top-10 component (95% confidence). One person authors 100% of PROD / PROD-FIX / UAT merges and solely owns a 1,496-node Authentication module — roughly $9,000 of manual triage per change (100% confidence). Modeled retention exposure: $600K–$1.2M (modeling assumption).

The read, step by step

“What breaks if someone leaves?” — start to finish.

The same question, walked through the read — from the business outcome at risk to a 30/60/90-day plan. Click a step, or use the arrows.

Why this is doable — the mapping

Pulling the data is the easy part.

Making it mean something — grouping it into areas, seeing how they depend on each other and which ones carry the weight, in one repo, across a project, and up the whole stack — is the read.

Semantic mapping across three scopes The same evidence is resolved at three widening scopes: inside a single repository (files into modules into domains), across the repositories that make one project (linked by shared contracts), and up the whole technology stack (vendors, models, and external systems mapped to risk). SINGLE REPO CROSS-REPO PROJECT TECHNOLOGY STACK widen widen Billing Intake Auth 1 owner Repo A Repo B Repo C Repo D Messages one DTO → 7 projects AI×8 Project 23 vendor integrations
Scope 01

Single repo

Files and functions roll up into modules, modules into business domains. We resolve who owns each area and what is coupled to what.

A 1,496-node Authentication module — single-author, with 1,332 nodes reflection-bound, so its blast radius can’t be traced statically. (100% confidence)

Scope 02

Cross-repo project

Many repositories make one product. We follow the shared contracts between them, so a change in one place shows its real reach.

One intake DTO fans into 7 projects — a single change forces a platform-wide rebuild. (no feature flags; rollback = redeploy)

Scope 03

Technology stack

Beyond your code: the vendors, models, and external systems the product leans on — each mapped to where it creates risk.

23 vendor integrations with no shared abstraction, plus 8 bureau-scoring decisioning systems. (consequential-decision AI surface)

How the read is built

Precision first. So nothing is a guess.

Three layers, each checked by our experts. We start with deterministic scanners — not AI — so every finding is grounded in your actual code. That precision is what protects the read from AI hallucination.

Fragmented evidence — plans, requirements, tickets, code, commits, comments, ownership, architecture, and delivery — grouped by semantic mapping into business domains such as auth, billing, platform, intake, AI surface, and risk, then surfaced as decision answers: roadmap drift, key-person risk, AI exposure, and diligence risk.

Layer 1

Precision scanning

Deterministic static analysis, not AI. It reads your code exactly as written, so every finding traces to a real line, commit, or file. Nothing is inferred.

Layer 2

Semantic mapping

The mapping shown above — scanned facts correlated across commits, ownership and history, then grouped into your business domains by relationship and importance. Checked by our practitioners, never left to an AI’s guess.

Layer 3

Knowledge base

The correlated read becomes a queryable layer your team keeps — the same grounded evidence, live, for the next question.

What you get

The Five Stories

Five narratives backed by evidence, compliance scorecards, strategic options, and a searchable knowledge base of your entire system.

01

The Architecture Story

What you actually have vs. what you think you have. We map the real system topology and compare it to stated architecture. Every gap is a risk you didn't know about.

02

The Knowledge Story

Who knows what, and what happens when they leave. We identify knowledge concentration, single points of failure in your team, and the institutional memory that lives only in someone's head.

03

The Risk Story

Where technical debt concentrates and what it costs. Not every debt matters. We show you which debt is actively slowing you down and which is safely dormant.

04

The Velocity Story

Is the team building what the roadmap says — or spending cycles on maintenance, gap-closing, and work nobody decided to prioritize? We show you where engineering time actually goes vs. where the business thinks it goes.

05

The Investment Story

Is investment following the strategic plan — or going to maintenance, rework, and decisions nobody made? We show where the money actually goes vs. where the business thinks it goes.

Frequently asked

Common questions

How is this different from a code audit?

Code audits tell you what's wrong with your code. We tell you what your code means for your business. We answer questions about risk, knowledge, cost, and velocity — not code formatting.

Do you need to talk to our engineers?

One 30-minute call with a stakeholder. That's it. We work from the code, not from interviews. People forget. Code doesn't.

What if our documentation is sparse?

Most documentation is. That's actually useful data — the gap between what's documented and what exists tells its own story. Our tooling works from the code first.

How do you handle security?

Read-only access, always. We never write to your systems. Data is encrypted in transit and at rest. We can work within your VPN. SOC 2 compliant.

What does it cost?

Fixed-price engagement scoped to your codebase. The quote depends on the number of repositories and the complexity of the system. You get a firm number before we start, and the price doesn't change.

How long until we get results?

Three weeks from access. Week one is connect, week two is mapping, week three is analysis and delivery. The executive briefing happens at the end of week three.

How we engage

A standard engagement runs three weeks.

The method, in plain terms

How technology intelligence actually works.

How does technology intelligence work?

We read every signal the system emits — the code, the commit history, the tickets, the PRDs, the roadmaps, ownership, tests and data — and correlate them over time rather than at a single snapshot. Deterministic static analysis surfaces what's there; multi-source temporal correlation ties it together; and every finding is mapped to your business domains and features, not the repository tree. A pattern in any one source is noise. A pattern across all of them, over time, is a finding. The output isn't a scan score — it's a defensible read of what's true about the system and why it became that way.

Why focus on why, not just what?

A scanner tells you what the code is — the violations, the complexity, the dependencies. It can't tell you why it was built that way, which is where the risk and the decisions actually live. A module looks over-engineered until you learn it was built for a contract that no longer exists; a service looks fragile until you find the one person who has quietly kept it alive. We call the discipline decision archaeology: reconstructing the sequence of decisions that shaped the system — including the ones nobody wrote down — so you can act on cause, not just symptom.

What do you mean by "let the system testify"?

Interviews give you what people remember and what they're willing to say. The system itself can't forget, can't spin, and has no stake in the answer. So we let it testify: the commit that introduced the workaround, the ticket that was closed without a fix, the dependency that hasn't been updated in three years. Where the team's account and the evidence disagree, the evidence wins — and that's precisely what makes the read defensible to a board, an acquirer, or a regulator.

How is this different from a code scanner or an engineering dashboard?

A scanner hands you a thousand warnings and a score; a dashboard hands you metrics with no story. Both leave the interpretation to you. We do the opposite: technology finds the data, experience finds the truth. The deliverable is the Five Stories — architecture, knowledge, risk, velocity, investment — each one a decision you can defend, in business language, traceable to the commit. Not a tool you have to run and read yourself, but a read you can act on.

What We Are Not

We don't write code, manage your engineering team, or sell you a transformation roadmap. Our only interest is an accurate picture — which is exactly why you can trust it. What happens next is your decision, made with the right information for the first time.

Where the read applies

Technical due diligence · Code & software audit · AI compliance & shadow-AI · Private equity · M&A · New & fractional CTOs · CEOs & boards · Glossary

Ready to get started?

One conversation. We'll tell you if we can help.

Get a Read