diff --git a/AGENTS.md b/AGENTS.md index 313b3aa5..8d8461f4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -38,3 +38,4 @@ Measure twice, cut once: understand the problem fully before building, because c These steer us in the right direction. They are not hard-set, but default to following them; if you think one should be ignored, be very loud about it and get approval from us first. - Never edit `*.g.dart` files. Edit the source models, then run `dart run build_runner build --delete-conflicting-outputs`. +- Each thread owns one running instance of the app, and never touches another's. Start yours once, keyed by your worktree or branch name: `flutter run -d macos --pid-file /tmp/icarus-.pid --dart-entrypoint-args "--hive-store-dir="`, with `` = `~/Library/Containers/xyz.icarus-strats/Data/Library/Application Support/icarus-` so its library is yours alone, launched from an unsandboxed shell or it draws but takes no clicks. Instances share a window frame, so move yours aside before you click. After every edit, hot reload it with `kill -USR1 $(cat /tmp/icarus-.pid)`; the tool's stdin is not a terminal, so typing `r` does nothing. Keep it running for the thread, and kill it when the thread ends.