docs(maestro): write the worktree lifecycle contract

Closes #89
2026-08-24 10:29:42 +01:00
parent bbbc24a4aa
commit 35c75f9238
2 changed files with 131 additions and 0 deletions
@@ -62,6 +62,10 @@ nix/                     # Home Manager module (`services.maestro`)

 See `docs/INSTALL.md` for end-user install instructions.

+`docs/WORKTREES.md` is the contract for session worktrees — placement,
+collisions, what blocks a kill, what `--force` retains, and what reclaim
+touches. Read it before changing anything that creates or removes one.
+
 `nix run .#dev` (or `just dev`) brings up the whole local stack under
 process-compose: a debug daemon on 127.0.0.1:7071, then Vite on :5173 once the
 daemon answers `/api/info`. The SPA proxies `/api/*` back to the daemon, so only