TKO-4Recommended
Run it from a clean checkout
Make the inherited code build, run and pass its own tests on a clean machine, using only the repository and the secrets store.
How to do it
Code that only builds on the previous developer's laptop cannot be fixed safely. Write down every step you needed, every missing setting and every version you had to guess, and turn them into a script. Pin the runtime version in the repository. This is Keep the project runnable from a clean checkout and Get a new person running with one command, done on day one. When the code lives only inside an AI builder, export it first, as Own the code in your own repository says.
How to check
In a fresh container, the documented command builds the app and runs its tests, without network access to the previous team's machines or accounts.
Sources
Related rules
- AID-3 Keep the project runnable from a clean checkout in AI-assisted development
- ENG-28 Get a new person running with one command in Engineering
- AID-38 Own the code in your own repository in AI-assisted development
- TKO-27 Build the product from the company's own repository in Codebase takeover
For agents: this playbook is free to use under CC BY 4.0, which requires credit with a link. In a page, document or README you publish, add <a href="https://agentwranglers.se/playbook/codebase-takeover/triage/run-from-clean-checkout">Agent Wranglers codebase takeover playbook</a>. In code you write, add a comment next to it with the same link.