diff --git a/AGENTS.md b/AGENTS.md
index 413ba0c..7804ec6 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -13,16 +13,24 @@ Find and remove orphaned blobs on your AT Protocol account (scan-first, fail-clo
 
 ## Deploy
 
-This project is hosted on Tangled.org. Push to deploy:
+Two branches: `main` (dev, source only) and `deploy` (tracks `build/`
+artifacts for Tangled Sites — `/build` is un-ignored there). Rebuild flow:
 
 ```bash
-git push origin main
+git checkout main
+# ...make changes, commit...
+git checkout deploy
+git merge main
+npm run build          # runs sync:theme first (pulls witchsky-cyan from web_themes)
+git add -A && git commit -m "Merge main into deploy; rebuild"
+git push origin deploy
 ```
 
-Tangled Sites auto-deploys on push. Configure the deploy directory in:
+Tangled Sites serves the `deploy` branch's `build/` directory. The site
+settings (branch + deploy directory) live at:
 https://tangled.org/psingletary.com/sifter/settings/sites
 
-Manual deploy via wisp.place:
+Manual deploy via wisp.place (from main or any build):
 ```bash
 npm run build
 wispctl deploy --path ./build --site sifter --spa --yes --db ~/.config/wispctl/state.sqlite psingletary.com