From 18db7520e090e255bc1bfac354f3b7f8f21a12fe Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Burak=20Emre=20Kabakc=C4=B1?= Date: Mon, 20 Apr 2026 23:45:15 +0100 Subject: [PATCH] docs(agents): document the two-PR flow for owletto-web submodule changes --- AGENTS.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index da6a5859d..8c83d4473 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -19,6 +19,10 @@ - When fixing unused parameter errors, remove the parameter entirely if possible rather than prefixing with underscore - Worker prompt delivery: prompts are passed to the agent runtime directly (no named pipes used) +### Submodules +- `packages/owletto-web` is a git submodule pointing at `lobu-ai/owletto-web`. ANY code change inside it must ship as TWO PRs in this order: (1) submodule PR in `lobu-ai/owletto-web`, merge it; (2) parent PR in `lobu-ai/lobu` that bumps the submodule pointer. Never push parent commits that reference an unmerged submodule SHA — the production build resolves submodule SHAs from the parent and the deploy will break. +- After the submodule PR merges, run `git -C packages/owletto-web pull --ff-only origin main`, stage `packages/owletto-web` in the parent, and open the parent bump PR. + ### Architecture #### Platform