This is an automated email from the ASF dual-hosted git repository.
asf-gitbox-commits pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/cayenne.git
The following commit(s) were added to refs/heads/master by this push:
new 1c739dc15 adding Modeler coexistence to skills
1c739dc15 is described below
commit 1c739dc158ac74c2b93ded95eed7ffd7cdc5f15b
Author: Andrus Adamchik <[email protected]>
AuthorDate: Sat May 23 16:11:05 2026 -0400
adding Modeler coexistence to skills
---
ai-plugin/skills/cayenne-modeling/SKILL.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/ai-plugin/skills/cayenne-modeling/SKILL.md
b/ai-plugin/skills/cayenne-modeling/SKILL.md
index fac821865..cfc8903d1 100644
--- a/ai-plugin/skills/cayenne-modeling/SKILL.md
+++ b/ai-plugin/skills/cayenne-modeling/SKILL.md
@@ -84,6 +84,10 @@ If anything fails, fix it before reporting done.
- **If the user is asking about a full DB sync** (importing many tables,
syncing with a changed schema): hand off to `cayenne-reverse-engineer`. Do not
try to script this via XML edits.
- **If the change is structurally messy** (bulk renaming relationships, visual
graph rework): suggest the `cayenne-modeler` skill. Otherwise do not.
+## Modeler coexistence
+
+CayenneModeler **watches the project XML files** and automatically detects
on-disk changes. When you edit a `*.map.xml` file directly, the Modeler will
prompt the user to reload the project the next time they interact with it.
There is no risk of the Modeler silently overwriting your edits. Do **not**
warn the user that the Modeler may overwrite changes or tell them to close the
Modeler before editing — that is incorrect and unnecessary.
+
## Anti-patterns
- **Don't hand-edit `_<Entity>.java` superclass files.** They are regenerated
by cgen and your changes will be overwritten. Edit the user `<Entity>.java`
subclass instead.
