Okay. Hello. Hey everyone. Thanks for joining in. Today uh we will be talking about how to kill the code reviews.

Everyone's favorite topic. I'm Ankit, co-founder of Aviator. At Aviator, we are building AI code verification platform.

So we'll bring in some of the ideas and concepts that we talk about in the uh that we build in our product. Uh but first, let's dive into a little bit.

So a few months ago I wrote a post on latent space about uh how to kill code review creating a framework a five layers trust model. So this model was focused around how do we actually layer by layer build trust into the code that can then be merged without needing line by line review.

And I got some things right and I got some things wrong. So this talk will be about just really diving a bit more into it. I'm not going to talk about specific layers but we will talk about some of the concepts that emerge from this session.

So let's just talk about the problem we are looking today at the volume of code is increasing every day and we are struggling to keep up.

So when we think about like how long will it take us to actually stop reading code line by line and the reality is we've already stopped reviewing it there is 861% code churn that means we are like producing more code the incidence to PR ratio is increasing that means even if you're doing reviews today they're not effective so the medium time of review is increasing we have just increased the bottleneck to from the coding now kind of like coding is solved to now reviewing where everything just gets stuck there.

You're spending 4x the time that you were spending before just waiting for the reviews.

And today over 30% of changes are actually getting merged without a review at all. So let's just think about it a little bit.

Think about AI reviews. So everyone is probably using some form of AI reviews today. when AI write the code and AI review the code, why are we doing it in a UI, right?

Like we open a GitHub, there's kind of like, you know, maybe two or three AI coding agents who are like doing the reviews. You know, you the review goes back pass to the user and or the agent and it gets resolved and they're kind of like you're doing back and forth with the agent.

like you're eventually just looking at okay you know if AI has reviewed it most of the things probably found let's just kind of like you know do a skimming of it and merge it so when AI reviews and nobody reads we have configured the wrong thing so let's just take a step back code reviews are not very old they're maybe 15 to 20 years ago in 2006 was when Google launched Montrean internally when they made formal code review as a thing if you think about Windows back in the days.

The first versions were actually built without reviews. But if we look carefully, code review is not just about code reviews.

You know, obviously we are looking at it like catching bugs, understanding kind of conventions, identifying security issues, but code reviews is also about alignment.

And this was one piece which was missing from my five layers model that I talked about a few months ago. So a big part of code reviews is knowledge sharing, mentorship, architectural feedback, on boarding, being able to collaborate.

This is again if you're doing um white coding, you're working as a solo project, this is not a talk for you. If you are working in teams, which I believe most of you folks are collaborating in teams, you're not likely using completely dock factories orchestrators where nobody looks at the code.

You're actually collaborating in teams. you need to do knowledge sharing which is the alignment part and that is the part which is the most important aspect of release.

So for semantic accuracy we can build better tooling but alignment must survive. So let's just kind of like dive into alignment. What does it mean? Like in today's world can we actually think of better model than aligning just based on reading line by line code.

So most folks have probably heard about specdriven development by now. So specdriven development is like okay we write a spec you know um it covers all the details we pass it to an agent it generates a code and then we verify.

So what's wrong here? If you look back in 1970 this is what waterfall model was.

You know you have requirements you have specification you implement and then you verify but there's no feedback loop. You know the spec is written before we identified everything else. Right?

That's why today everyone still wants to use your coding sessions whether it's clot code, codeex, cursor, whatever you're using. You want to interact with the agents and the reason you're interacting with agents is because there were certain things which are not clear in the spec and we still need to capture that.

And second is as you implement you identify more issues and you never go back and update the spec because like if you're doing a spec development it's already done. Once the spec is done you expect like you know the code will come deterministically. But guess what? LLM is not deterministic.

It's going to make decisions itself. So that's why specdriven development is a great uh methodology, but it falls short in day-to-day software development. But there are some interesting aspects of this which we should carry forward. The most important part is the intent and intent doesn't only live in the spec.

Intent live in your zero ticket. That's the goal, right? Like it's kind of like where you express what we want to do.

It lives in your pods. It's kind of like details like it's a plan. But most importantly, it lives in your prompts today. This is where the real decisions are being made.

You start with like, okay, this is a zero ticket I'm going to look at, but you're going back and forth with the agent and this is where all the user decisions are being made.

But what we do today is we create a change, we create a pull request, and then we throw away the cross.

And this is one of the things that we need to change. Let's just first talk also about semantic accuracy because like you know you're saying hey an okay I understand the alignment part but like there are still bugs in the code who's going to look at that lms are also not great at this and we already talked about how AI agents may reviewers may not also be perfect so this is where I introduce you to a concept of AI slop registry so think about this we are reviewing if you're reviewing code today manually and I expect everyone should be doing some degree of this we are essentially possibly identifying the same issues over and over again.

Can we actually capture these concepts and codify them so that we don't have to always create those review feedback one by one. You actually also have all of those things automatically identified.

The beauty of this is if you do it a few times, you now build sort of like a system which actually learns over time.

So think of this as sort of like you're not you know you're doing more training on top of the standard LLM that you have actually extracted like built on top of.

So AI slop registers now can create better results because it's trained it's learning from the review experience that you as humans are providing.

Every recurring comment is now a guardrail that you don't have to review again. Okay, so let's kind of like try to put both of these alignment and the semantic accuracy together.

It is two halves of the same problem. We are trying to understand what are the core mechanics of review. How do we actually break it down into two parts which is the alignment and the semantic accuracy and bring them together into a single loop.

So first thing is you go take your session and you capture the uh user responses and that essentially forms your acceptance criteria.

This acceptance criteria then tied with your AI slop register that you are now constantly maintaining finally creates a test plan and this is the test plan which then gets verified. This is part of the system that we're building is the verification system where it spins up a preview, takes your test plan and make sure it actually works end to end.

Even if the code looks right, does it actually work?

So this verification parts become interesting. And now the kicker is this is now your review surface. You're not reviewing code line by line, but rather you're looking at the evidence of what was the intent.

Did the user actually implement the capability that was defined in the intent and did the behavior actually meet the requirements that we had in the accept as acceptance criteria. So you're still having the architectural decisions, you're still having these arguments but the review surface changes.

So just giving a walkthrough of like how we have built our system. The session becomes a criteria. So all these decisions that you are doing here with the agent you're asking uh you know you're providing this feedback like even if there is a simple task many times you're going back and forth agent will stop to ask questions.

These are the decision that we need to capture. This is the intent. This is what makes your review makes your collaboration more valuable.

This is how you teach your junior engineers on how to improve over time. And these are the decisions which make a software engineer valuable today.

We convert those into an acceptance criteria. This is where you can also leverage LLM to do so. So you capture these user uh decisions and make sure you can actually create a test plan based on this.

I know test plan creation is always painful which is where I would also recommend people to use LLM for this purpose.

And finally the criteria plus invariant is what makes the test plan and we build the verification systems to actually capture the test plan run your previews and be able to test based on this test plan. So even imagine if you're building a new feature you don't have to maintain test at all.

This is creating test in real time and this is where you can leverage the power of LLM because the test plan maintenance and creation can be very painful but the value of human in the loop here is the governance and the review part and the part where you're reviewing the test plan and not the code.

Right? I know it's been like over 20 years we came up with test-driven development. This in some ways is closer to behavior devel driven development where the test plan is now something which even you can share with your product managers, your designers, everyone can participate because these things are now in English.

At the same time we have now deterministic verification which actually verifies whether the particular test criteria has been met or not.

Let's move on. So this is where I would say the system is not supposed to be perfect. It's deterministic where it can be but LLM where you must. Not everything can be deterministic.

Not every system can be built in a way which is 100% built on deterministic uh systems. This is where you use LLM as a fallback. Let me give you an example. Like if you're making a change in your web application, what you can do is it creates a test plan of what the behavior changes.

Let's say you introduce a new payment uh form.

So it creates a new payment form. The verification here is does the payment system changes.

a an AI agent can go and browse through your application to fill out a form and capture screenshots as evidence and then take those screenshots as well as your database snapshots to identify whether the criteria was met.

So the screenshot testing or like sampling can then still be done by agents, but at the same time you're creating more solid evidence which now a reviewer can look at and build more confidence that this actually works.

So now reviewers are reviewing the intent, not the diff. You're reviewing the intent decisions uh what we said to build out what we tried and rejected and capture all of these things from the sessions. Remember capturing it from the sessions is the key.

If we try to build it from the code, you end up in the same situation that we were talking about. I think Dex was talking about yesterday which is if your code is built by the same agent which is actually building a test plan.

It's not going to build a test plan which will actually catch issues.

So that's why it's important to actually use the session information to build out a test plan. You can discuss architectural decisions.

So how you're creating the data models, how these services interact with each other. So you're moved one level above. So you're essentially instead of like reviewing line by line, you're actually having discussions on architecture which are very critical for any kind of collaboration.

And then you look at the evidence, everything that was collected from the verification. So here's a homework for everyone. Go home and mine your last 1,000 review comments and build out a AI swap register for the things which are repeatable.

So a vast majority of the comments that we're providing in your code review are something that we repeat over and over again. This compounds with every merged PR. Every time you capture something as a register, you don't have to capture that comment again.

And this is where you can actually codify some of the best practices of doing code, maintain semantic accuracy. At the same time, do not lose the collaboration part of the review.

It does follow a J curve. So PIN is real. uh you will have to spend some time to actually make it pay off because initially creating a registry can take some time and this is where I would recommend you folks can come and try out our product.

So code review is not just about code review it is about uh really getting the alignment and where we can build better tools is creating the semantic accuracy and defining your AI slop register.

So if you remember one thing from today, remember code review is not just about code review.

It is about getting the alignment. And yes, we are piloting our new product called verify. Uh please uh join and be our early design partners. We are working with a few companies to uh pilot out a new verification system.

This combines both the alignment side of things as well as building tools and capabilities for detecting semantic accuracy using the AI's lock register.

[한글자막] 코드 리뷰를 완전히 없애는 방법: diff 대신 의도를 검증하세요

Scripts