1 files changed, 5 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
index bdcf9f0..4958740 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -43,6 +43,11 @@ jr task create "Command X fails when Y" --discovered-from=<current-task-id> --js
   - `_/tmp/` - Temporary files, test databases, scratch data
 - Never create dotfile directories (like `.tasks/`) in the repo root
 
+## Python Conventions
+
+- **Imports**: Use `import X as Y` pattern only. Do NOT use `from X import Y` because `bild` only detects the former.
+- **Module naming**: If you have both `Foo.py` and `Foo/` directory, the build system gets confused. Rename `Foo.py` to `Foo/Core.py` and update imports accordingly.
+
 ## Common Commands
 
 **Build:**