From 026835995ac5a26c8315262bd6d733aa5c107f9e Mon Sep 17 00:00:00 2001 From: Lee Calcote Date: Mon, 26 Oct 2026 16:12:15 -0500 Subject: [PATCH] docs(agents): work in treehouse worktrees; land through no-mistakes, at most three runs Agents work in a leased treehouse worktree (treehouse get --lease -b , treehouse return ), never in the main clone, and land every change through no-mistakes, at most three runs per pull request. Signed-off-by: Lee Calcote --- AGENTS.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) 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.