diff --git a/AGENTS.md b/AGENTS.md index e7b237ae2..9110f7d35 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -254,6 +254,22 @@ The agent-specific trap: the usual offender is a follow-up commit (review fix, d fixup), not the first one. Sign every commit you add, including the ones an automated pass makes for you. +## Worktrees and landing a change + +- **Work in a treehouse worktree, never in the main clone.** Other agent sessions and the + no-mistakes pipeline share the main clone. Take a worktree with + `treehouse get --lease -b ` (it prints the path; `--base ` starts it from + another branch), work there, and release it with `treehouse return ` once the change + has merged. `treehouse status` lists the pool. Never make one with `git worktree add` or a + second clone. +- **Land every change through no-mistakes, at most three runs per pull request.** Commit in + the worktree, then run `no-mistakes axi run --intent ""` (a clone without a + `no-mistakes` remote needs `no-mistakes init` once). `no-mistakes axi status` shows the step + and its findings, and `no-mistakes axi respond` answers a review gate. The pipeline reviews, + tests, pushes and opens the pull request. After the third run, merge the pull request as it + stands and open an issue for anything still flagged. A run that stopped on a usage limit + counts; one cancelled before it did anything does not. + ## Maintaining this file Keep this file for knowledge useful to almost every future agent session in this project.