Align docs with v0.3.0: branching in CONTRIBUTING, dynamic skills, .heex files

CONTRIBUTING.md skill example updated with routes/0 callback and triple
tuple return format. README dynamic skills section mentions conditional
branching and route persistence. Architecture doc updated for .heex files.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: alessiobattistutta

ALEXCLAW_ARCHITECTURE.md

@@ -410,7 +410,7 @@ lib/
       database_controller.ex   # Schema browser, backup download
       github_webhook_controller.ex  # GitHub webhook receiver (HMAC verified)
       oauth_callback_controller.ex  # Google OAuth callback handler
-    live/admin_live/           # LiveView pages (12 pages)
+    live/admin_live/           # LiveView pages (13 pages, .ex logic + .html.heex templates)
     plugs/
       caching_body_reader.ex   # Caches raw body for webhook HMAC verification
       rate_limit.ex            # Plug for POST /login rate limiting

CONTRIBUTING.md

@@ -80,12 +80,23 @@ defmodule AlexClaw.Skills.MySkill do
   @impl true
   def description, do: "Short description for the skill registry"
 
+  # Optional: declare branches for conditional workflow routing.
+  # Default is [:on_success, :on_error] if not implemented.
+  @impl true
+  def routes, do: [:on_results, :on_empty, :on_error]
+
   @impl true
   def run(args) do
     # args[:input] — output from previous workflow step
     # args[:config] — step configuration from the workflow editor
     # args[:resources] — attached resources
-    {:ok, result}
+
+    # Return triple tuple with branch name for conditional routing:
+    {:ok, result, :on_results}
+
+    # Or on empty/error:
+    # {:ok, "No results found.", :on_empty}
+    # {:error, reason}  — implicit :on_error
   end
 end
 ```

README.md

@@ -60,6 +60,7 @@ Load custom skills at runtime — no code changes, no Docker rebuild, no restart
 - **Admin UI** — Upload, reload, and unload skills from the Skills page. Core and dynamic skills are shown separately.
 - **Telegram commands** — `/skill load`, `/skill unload`, `/skill reload`, `/skill create`, `/skill list`
 - **Cross-skill invocation** — Dynamic skills can call other skills (core or dynamic) through `SkillAPI.run_skill/3`
+- **Conditional branching** — Dynamic skills can declare `routes/0` (e.g. `[:on_results, :on_empty, :on_error]`) and return triple tuples `{:ok, result, :branch_name}` for workflow routing. Routes are persisted in the database on load and cleaned up on unload — same behavior as core skills.
 
 #### Permissions