Agent
Files under /.liza/ are installed copies, not sources — some symlinks, some regular files. Edits there are lost on next install and diverge from the repo. The Edit tool also silently replaces symlinks with regular files.
Agent
Go test files in this project often exceed 10K tokens (table-driven tests, helpers, setup).
Agent
Repository-wide validation such as rtk make test-race, rtk make coverage, or a repeated race/shuffle package run can run for several minutes. RTK may buffer successful package output while the execution tool exposes the still-running process through a session ID.
Agent
Some validation tools consume their primary input from stdin, including gocover-cobertura when converting a Go coverage profile.
Agent
Configuration files like claude-settings.json exist in two places.
Agent
Liza embeds contracts and skills from internal/embedded/ at build time. In a worktree, those embedded copies can lag behind the repo masters after branch switches or edits.
Agent
Claude Code's Edit tool tracks prior reads by exact string path. If you Read via one path and Edit via a slightly different string (even if both resolve to the same inode), the edit is rejected.
Agent
The worktree root already ends in the task id: .worktrees/ . Relative paths inside the worktree are rooted there — you do NOT prepend the task id again.