Clone the code, inherit the understanding

7 September 2026

Here is a test that tells you how much your project's understanding is actually worth.

Take a clean checkout. No chat history, no open session, nothing but the code. Point a fresh agent at it and ask the questions that matter. What is this for. How is it built. What is contested. Which files should I read before I change the auth flow. See how far it gets.

On most projects it gets the shape of the code and none of the reasoning. It can read every file and still not know which decisions are load-bearing or what you already ruled out.

Understanding that ships with the repo

Naetive keeps your project's understanding in the repo, in a portable .naetive folder. It sits next to the code, version controlled with the code, and it travels with the code.

So the test above changes. Clone the repo with .naetive present and the fresh agent does not open cold. It reads what the project is for, how the pieces fit, which claims are grounded and which are open questions, and the file and line behind each one. It inherits the understanding, not just the files.

Clone the code, inherit the understanding. That is the idea in one line.

Why in the repo, and not in a service

Putting it in the repo is a deliberate choice, and it matters.

It is portable. Any agent, any tool, any machine that can read the repo can read the understanding. Nothing to call, no account needed to get the context.

It is versioned. The understanding moves with your branches and your history. Check out an old commit and you get the understanding as it was then.

It is yours. It is a folder in your project, not rows in someone else's database. You can read it, diff it, and see exactly what an agent will inherit.

What this unlocks

Once understanding travels with the code, a lot of daily friction disappears. Onboarding a new agent is not a re-explanation, it is a read. Switching from Claude to ChatGPT mid-project does not reset anything. Handing the project to a teammate, or to yourself in three months, comes with the reasoning attached.

The code was always portable. Now the understanding is too.

If you are still placing it, it may help to read what Naetive is and is not.