template: make rename portable and add explicit otp_app dev flow

README.md

@@ -27,15 +27,19 @@ mix test
 For local development alongside a Tribes checkout:
 
 ```bash
+# Build plugin code once (host loads BEAM from _build/dev/lib/<otp_app>/ebin)
+cd /path/to/your-plugin
+mix compile
+
 # Symlink into the host plugins directory
 cd /path/to/tribes
 ln -s /path/to/your-plugin plugins/your_plugin
 
-# Start Tribes dev server — your plugin loads automatically
+# Start Tribes dev server
 iex --sname dev -S mix phx.server
 ```
 
-Edit your plugin source. Phoenix code reloader picks up changes.
+When you change plugin Elixir code, re-run `mix compile` in the plugin repo.
 
 ## Project Structure
 
@@ -63,6 +67,9 @@ your_plugin/
 ```json
 {
   "name": "your_plugin",
+  "entry_module": "YourPlugin.Plugin",
+  "host_api": "1",
+  "otp_app": "your_plugin",
   "provides": ["some_capability@1"],
   "requires": ["ecto@1"],
   "enhances_with": ["inference@1"]