Skip to content

LightCraft: An open-source non-destructive photo editor written by scratch in pure Rust

docs: AGENTS.md — merge agent branches one at a time with CI in between

Brandon Thomas36e80900bb04
diff --git a/AGENTS.md b/AGENTS.md
index b8dfdba5c..40f492c7e 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -9,6 +9,9 @@ LightCraft is a clean-room, open-source, pure-Rust photo library + non-destructi
`plan/` is gitignored (local-only).
+**Merging agent branches:** merge one branch, run `cargo xtask ci`, fix, commit — then the next. Two individually green
+branches can still break each other (e.g. a new struct field vs. a new constructor).
+
**Resuming after a crash / another session:** check `git status` on main, `git worktree list`, and each worktree's
`git log main..HEAD` + `git status` for unmerged commits or uncommitted work before starting anything new. Commit small
and often so a crash loses minutes, not hours.
diff --git a/CLAUDE.md b/CLAUDE.md
index b8dfdba5c..40f492c7e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -9,6 +9,9 @@ LightCraft is a clean-room, open-source, pure-Rust photo library + non-destructi
`plan/` is gitignored (local-only).
+**Merging agent branches:** merge one branch, run `cargo xtask ci`, fix, commit — then the next. Two individually green
+branches can still break each other (e.g. a new struct field vs. a new constructor).
+
**Resuming after a crash / another session:** check `git status` on main, `git worktree list`, and each worktree's
`git log main..HEAD` + `git status` for unmerged commits or uncommitted work before starting anything new. Commit small
and often so a crash loses minutes, not hours.