Skip to content

docs(agents): work in treehouse worktrees; land through no-mistakes, at most three runs - #1888

Merged
ritzorama merged 1 commit into
masterfrom
chore/agents-worktrees-no-mistakes
Oct 26, 2026
Merged

ritzorama merged 1 commit into
masterfrom
chore/agents-worktrees-no-mistakes

Conversation

@ritzorama

Copy link
Copy Markdown
Contributor

Intent

AGENTS.md: work in leased treehouse worktrees, never the main clone; land every change through no-mistakes, at most three runs per pull request

What Changed

  • Added a "Worktrees and landing a change" section to AGENTS.md (also served as CLAUDE.md, which symlinks to it). It says to work in a leased treehouse worktree (treehouse get --lease -b <branch>, released with treehouse return <path>) and never in the main clone. It also bans git worktree add and second clones.
  • Documented the landing flow: commit in the worktree, then run no-mistakes axi run --intent "<goal>". The section also covers no-mistakes init for a clone without a no-mistakes remote, axi status and axi respond, and the pipeline's review, test, push and PR steps.
  • Set a cap of three no-mistakes runs per pull request. After the third run, merge the PR as it stands and open an issue for anything still flagged. A run stopped by a usage limit counts toward the cap, and one cancelled before it did anything does not.

Risk Assessment

✅ Low: Docs-only addition of one section to AGENTS.md that states exactly the required rules (leased treehouse worktrees, at most three no-mistakes runs per PR) with no code impact.

Testing

I read the diff and confirmed it touches only AGENTS.md. No product, UI, API or CLI behavior changed, so there was nothing to run live. Checking that agents follow the new rules would need a live model evaluation, which is out of scope. I wrote no source-grepping test, per the test-quality rule.

  • Live validation: ⚠️ no-surface - 0 of 1 scenarios driven live against the product
Scenario Result Live Evidence
Agent follows the new AGENTS.md rules: works in a leased treehouse worktree and lands through no-mistakes in at most three runs ⏸️ untested no No live-validatable surface. The change is agent guidance text only and alters no runtime behavior, UI or API. Compliance can only be judged by a live agent evaluation, which is not part of this step.
  • Outcome: ⚠️ 1 warning across 2 runs (1m6s)

Pipeline

Updates from git push no-mistakes

✅ **intent** - passed

✅ No issues found.

✅ **Rebase** - passed

✅ No issues found.

✅ **Review** - passed

✅ No issues found.

⚠️ **Test** - 1 warning
  • ⚠️ this change has no live-validatable surface; proceed without live validation? (0 of 1 scenarios were driven live against the product); Agent follows the new AGENTS.md rules (work in a leased treehouse worktree, land through no-mistakes in at most three runs): The change adds guidance text only. No runtime behavior, UI, or API changed, and agent compliance with the text cannot be driven live without an LLM-in-the-loop evaluation.
  • Live validation: ⚠️ no-surface - 0 of 1 scenarios driven live against the product
Scenario Result Live Evidence
Agent follows the new AGENTS.md rules (work in a leased treehouse worktree, land through no-mistakes in at most three runs) ⏸️ untested no The change adds guidance text only. No runtime behavior, UI, or API changed, and agent compliance with the text cannot be driven live without an LLM-in-the-loop evaluation.
  • git diff 56fe2c57 02683599 --stat: AGENTS.md only, 16 insertions
  • treehouse get --help: --lease, --branch/-b and --base exist
  • treehouse --help: status and return exist
  • no-mistakes axi --help: run, status and respond exist

🔧 No changes applied.
1 warning still open:

  • ⚠️ this change has no live-validatable surface; proceed without live validation? (0 of 1 scenarios were driven live against the product); Agent follows the new AGENTS.md rules: works in a leased treehouse worktree and lands through no-mistakes in at most three runs: No live-validatable surface. The change is agent guidance text only and alters no runtime behavior, UI or API. Compliance can only be judged by a live agent evaluation, which is not part of this step.
  • Live validation: ⚠️ no-surface - 0 of 1 scenarios driven live against the product
Scenario Result Live Evidence
Agent follows the new AGENTS.md rules: works in a leased treehouse worktree and lands through no-mistakes in at most three runs ⏸️ untested no No live-validatable surface. The change is agent guidance text only and alters no runtime behavior, UI or API. Compliance can only be judged by a live agent evaluation, which is not part of this step.
  • git diff 56fe2c57 02683599 - confirmed the change is limited to 16 added lines in AGENTS.md
✅ **Document** - passed

✅ No issues found.

✅ **Lint** - passed

✅ No issues found.

✅ **Push** - passed

✅ No issues found.

…at most three runs

Agents work in a leased treehouse worktree (treehouse get --lease -b <branch>,
treehouse return <path>), never in the main clone, and land every change
through no-mistakes, at most three runs per pull request.

Signed-off-by: Lee Calcote <lee.calcote@layer5.io>
@coderabbitai

coderabbitai Bot commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

Caution

Review failed

The pull request is closed.

Finishing Touches
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ritzorama
ritzorama merged commit fcaa158 into master Oct 26, 2026
4 of 5 checks passed
@ritzorama
ritzorama deleted the chore/agents-worktrees-no-mistakes branch October 26, 2026 21:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants