diff --git a/AGENTS.md b/AGENTS.md
index 4b825b97..7ad76e27 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -63,6 +63,12 @@ People trust SolveCraft with their designs; a crash loses their work. **This out
 - **Rust only.** Units are millimetres and radians internally; Z is up.
 - **Quality gates** before every commit: `cargo xtask ci` (fmt, clippy -D warnings, tests,
   assets, layers). Commit after every feature arc that builds.
+- **Publishing**: `origin` is github.com/bherbruck/solvecraft (private). After each commit that
+  passes `cargo xtask ci`: `git pull --rebase origin main` (re-run ci if it brought changes),
+  then `git push`. Never force-push. Never commit `plan/`, build dirs (`target*/`) or anything
+  produced by Fusion (oracle STEP/STL/PNG); check `git ls-files` before pushing.
+- **Never break wasm**: everything below the apps must build for `wasm32-unknown-unknown`
+  (`cargo xtask wasm`, part of `cargo xtask ci`).
 
 ## Running and looking at the app
 - `cargo run --release -p solvecraft -- --sample --control PORT` (sample design + control channel).
diff --git a/CLAUDE.md b/CLAUDE.md
index 4b825b97..7ad76e27 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -63,6 +63,12 @@ People trust SolveCraft with their designs; a crash loses their work. **This out
 - **Rust only.** Units are millimetres and radians internally; Z is up.
 - **Quality gates** before every commit: `cargo xtask ci` (fmt, clippy -D warnings, tests,
   assets, layers). Commit after every feature arc that builds.
+- **Publishing**: `origin` is github.com/bherbruck/solvecraft (private). After each commit that
+  passes `cargo xtask ci`: `git pull --rebase origin main` (re-run ci if it brought changes),
+  then `git push`. Never force-push. Never commit `plan/`, build dirs (`target*/`) or anything
+  produced by Fusion (oracle STEP/STL/PNG); check `git ls-files` before pushing.
+- **Never break wasm**: everything below the apps must build for `wasm32-unknown-unknown`
+  (`cargo xtask wasm`, part of `cargo xtask ci`).
 
 ## Running and looking at the app
 - `cargo run --release -p solvecraft -- --sample --control PORT` (sample design + control channel).