RubyGems - robot_lab - Versions diffs - 0.1.0 → 0.2.1 - Mend

robot_lab 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (242) hide show

checksums.yaml +4 -4
data/.architecture/AGENTS.md +32 -0
data/.architecture/config.yml +8 -0
data/.architecture/members.yml +60 -0
data/.architecture/reviews/feature-free-will.md +490 -0
data/.architecture/reviews/overall-codebase.md +427 -0
data/.claude/settings.local.json +57 -0
data/.codex/config.toml +2 -0
data/.irbrc +2 -2
data/.rubocop.yml +172 -0
data/CHANGELOG.md +72 -0
data/CLAUDE.md +139 -0
data/README.md +91 -95
data/Rakefile +109 -3
data/agent2agent_review.md +192 -0
data/agentf_improvements.md +253 -0
data/agents.md +14 -0
data/docs/examples/index.md +37 -2
data/docs/getting-started/configuration.md +20 -7
data/docs/guides/index.md +16 -16
data/docs/guides/knowledge.md +7 -1
data/docs/guides/observability.md +132 -0
data/docs/index.md +30 -3
data/docs/superpowers/plans/2026-05-06-agentskills.md +1303 -0
data/docs/superpowers/specs/2026-05-06-agentskills-design.md +247 -0
data/examples/.envrc +1 -0
data/examples/01_simple_robot.rb +5 -9
data/examples/02_tools.rb +5 -9
data/examples/03_network.rb +8 -9
data/examples/04_mcp.rb +21 -29
data/examples/05_streaming.rb +12 -18
data/examples/06_prompt_templates.rb +11 -19
data/examples/07_network_memory.rb +16 -31
data/examples/08_llm_config.rb +10 -22
data/examples/09_chaining.rb +16 -27
data/examples/10_memory.rb +12 -28
data/examples/11_network_introspection.rb +15 -29
data/examples/12_message_bus.rb +5 -12
data/examples/13_spawn.rb +5 -10
data/examples/14_rusty_circuit/.envrc +1 -0
data/examples/14_rusty_circuit/comic.rb +2 -0
data/examples/14_rusty_circuit/heckler.rb +1 -1
data/examples/14_rusty_circuit/open_mic.rb +1 -3
data/examples/14_rusty_circuit/scout.rb +2 -0
data/examples/15_memory_network_and_bus/.envrc +1 -0
data/examples/15_memory_network_and_bus/editorial_pipeline.rb +6 -3
data/examples/15_memory_network_and_bus/linux_writer.rb +1 -1
data/examples/15_memory_network_and_bus/output/combined_article.md +6 -6
data/examples/15_memory_network_and_bus/output/final_article.md +6 -8
data/examples/15_memory_network_and_bus/output/linux_draft.md +4 -2
data/examples/15_memory_network_and_bus/output/mac_draft.md +3 -3
data/examples/15_memory_network_and_bus/output/memory.json +6 -6
data/examples/15_memory_network_and_bus/output/revision_1.md +10 -11
data/examples/15_memory_network_and_bus/output/revision_2.md +6 -8
data/examples/15_memory_network_and_bus/output/windows_draft.md +3 -3
data/examples/16_writers_room/.envrc +1 -0
data/examples/16_writers_room/writers_room.rb +2 -4
data/examples/17_skills.rb +8 -17
data/examples/18_rails/Gemfile +1 -0
data/examples/19_token_tracking.rb +9 -15
data/examples/20_circuit_breaker.rb +10 -19
data/examples/21_learning_loop.rb +11 -20
data/examples/22_context_compression.rb +6 -13
data/examples/23_convergence.rb +6 -17
data/examples/24_structured_delegation.rb +11 -15
data/examples/25_history_search.rb +5 -12
data/examples/26_document_store.rb +6 -13
data/examples/27_incident_response/incident_response.rb +4 -5
data/examples/28_mcp_discovery.rb +8 -11
data/examples/29_ractor_tools.rb +4 -9
data/examples/30_ractor_network.rb +10 -19
data/examples/31_launch_assessment.rb +10 -23
data/examples/32_newsletter_reader.rb +188 -0
data/examples/33_stock_generator.rb +80 -0
data/examples/33_stock_predictor.rb +306 -0
data/examples/34_agentskills.rb +72 -0
data/examples/README.md +1 -1
data/examples/common.rb +76 -0
data/examples/ruboruby.md +423 -0
data/examples/temp.md +51 -0
data/lib/robot_lab/agent_skill.rb +63 -0
data/lib/robot_lab/agent_skill_catalog.rb +74 -0
data/lib/robot_lab/ask_user.rb +2 -2
data/lib/robot_lab/bus_poller.rb +12 -5
data/lib/robot_lab/config.rb +1 -12
data/lib/robot_lab/delegation_future.rb +1 -1
data/lib/robot_lab/doom_loop_detector.rb +98 -0
data/lib/robot_lab/history_compressor.rb +4 -10
data/lib/robot_lab/mcp/client.rb +1 -2
data/lib/robot_lab/mcp/connection_poller.rb +3 -3
data/lib/robot_lab/mcp/server.rb +1 -1
data/lib/robot_lab/mcp/server_discovery.rb +0 -2
data/lib/robot_lab/memory.rb +32 -27
data/lib/robot_lab/memory_change.rb +2 -2
data/lib/robot_lab/message.rb +4 -4
data/lib/robot_lab/network.rb +11 -6
data/lib/robot_lab/robot/agent_skill_matching.rb +99 -0
data/lib/robot_lab/robot/bus_messaging.rb +9 -27
data/lib/robot_lab/robot/history_search.rb +4 -1
data/lib/robot_lab/robot/mcp_management.rb +5 -11
data/lib/robot_lab/robot/template_rendering.rb +60 -40
data/lib/robot_lab/robot.rb +323 -206
data/lib/robot_lab/robot_result.rb +6 -5
data/lib/robot_lab/run_config.rb +5 -11
data/lib/robot_lab/script_tool.rb +76 -0
data/lib/robot_lab/state_proxy.rb +7 -5
data/lib/robot_lab/tool.rb +3 -3
data/lib/robot_lab/tool_config.rb +1 -1
data/lib/robot_lab/tool_manifest.rb +5 -7
data/lib/robot_lab/user_message.rb +2 -2
data/lib/robot_lab/version.rb +1 -1
data/lib/robot_lab/waiter.rb +1 -1
data/lib/robot_lab.rb +41 -52
data/logfile +8 -0
data/mkdocs.yml +2 -3
data/robot_concurrency.md +38 -0
data/simple_acp_review.md +298 -0
data/site/404.html +2300 -0
data/site/api/core/index.html +2706 -0
data/site/api/core/memory/index.html +3793 -0
data/site/api/core/network/index.html +3500 -0
data/site/api/core/robot/index.html +4566 -0
data/site/api/core/state/index.html +3390 -0
data/site/api/core/tool/index.html +3843 -0
data/site/api/index.html +2635 -0
data/site/api/mcp/client/index.html +3435 -0
data/site/api/mcp/index.html +2783 -0
data/site/api/mcp/server/index.html +3252 -0
data/site/api/mcp/transports/index.html +3352 -0
data/site/api/messages/index.html +2641 -0
data/site/api/messages/text-message/index.html +3087 -0
data/site/api/messages/tool-call-message/index.html +3159 -0
data/site/api/messages/tool-result-message/index.html +3252 -0
data/site/api/messages/user-message/index.html +3212 -0
data/site/api/streaming/context/index.html +3282 -0
data/site/api/streaming/events/index.html +3347 -0
data/site/api/streaming/index.html +2738 -0
data/site/architecture/core-concepts/index.html +3757 -0
data/site/architecture/index.html +2797 -0
data/site/architecture/message-flow/index.html +3238 -0
data/site/architecture/network-orchestration/index.html +3433 -0
data/site/architecture/robot-execution/index.html +3140 -0
data/site/architecture/state-management/index.html +3498 -0
data/site/assets/css/custom.css +56 -0
data/site/assets/images/favicon.png +0 -0
data/site/assets/images/robot_lab.jpg +0 -0
data/site/assets/javascripts/bundle.79ae519e.min.js +16 -0
data/site/assets/javascripts/bundle.79ae519e.min.js.map +7 -0
data/site/assets/javascripts/lunr/min/lunr.ar.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.da.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.de.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.du.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.el.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.es.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.fi.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.fr.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.he.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.hi.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.hu.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.hy.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.it.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.ja.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.jp.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.kn.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.ko.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.multi.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.nl.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.no.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.pt.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.ro.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.ru.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.sa.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.stemmer.support.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.sv.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.ta.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.te.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.th.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.tr.min.js +18 -0
data/site/assets/javascripts/lunr/min/lunr.vi.min.js +1 -0
data/site/assets/javascripts/lunr/min/lunr.zh.min.js +1 -0
data/site/assets/javascripts/lunr/tinyseg.js +206 -0
data/site/assets/javascripts/lunr/wordcut.js +6708 -0
data/site/assets/javascripts/workers/search.2c215733.min.js +42 -0
data/site/assets/javascripts/workers/search.2c215733.min.js.map +7 -0
data/site/assets/stylesheets/main.484c7ddc.min.css +1 -0
data/site/assets/stylesheets/main.484c7ddc.min.css.map +1 -0
data/site/assets/stylesheets/palette.ab4e12ef.min.css +1 -0
data/site/assets/stylesheets/palette.ab4e12ef.min.css.map +1 -0
data/site/concepts/index.html +3455 -0
data/site/examples/basic-chat/index.html +2880 -0
data/site/examples/index.html +2907 -0
data/site/examples/mcp-server/index.html +3018 -0
data/site/examples/multi-robot-network/index.html +3131 -0
data/site/examples/rails-application/index.html +3329 -0
data/site/examples/tool-usage/index.html +3085 -0
data/site/getting-started/configuration/index.html +3745 -0
data/site/getting-started/index.html +2572 -0
data/site/getting-started/installation/index.html +2981 -0
data/site/getting-started/quick-start/index.html +2942 -0
data/site/guides/building-robots/index.html +4290 -0
data/site/guides/creating-networks/index.html +3858 -0
data/site/guides/index.html +2586 -0
data/site/guides/mcp-integration/index.html +3581 -0
data/site/guides/memory/index.html +3586 -0
data/site/guides/rails-integration/index.html +4019 -0
data/site/guides/streaming/index.html +3157 -0
data/site/guides/using-tools/index.html +3802 -0
data/site/index.html +2671 -0
data/site/search/search_index.json +1 -0
data/site/sitemap.xml +183 -0
data/site/sitemap.xml.gz +0 -0
data/site/tags.json +1 -0
data/temp.md +6 -0
data/tool_manifest_plan.md +155 -0
metadata +154 -92
data/docs/examples/rails-application.md +0 -419
data/docs/guides/ractor-parallelism.md +0 -364
data/docs/guides/rails-integration.md +0 -681
data/docs/superpowers/plans/2026-04-14-ractor-integration.md +0 -1538
data/docs/superpowers/specs/2026-04-14-ractor-integration-design.md +0 -258
data/lib/generators/robot_lab/install_generator.rb +0 -90
data/lib/generators/robot_lab/job_generator.rb +0 -40
data/lib/generators/robot_lab/robot_generator.rb +0 -55
data/lib/generators/robot_lab/templates/initializer.rb.tt +0 -42
data/lib/generators/robot_lab/templates/job.rb.tt +0 -21
data/lib/generators/robot_lab/templates/migration.rb.tt +0 -32
data/lib/generators/robot_lab/templates/result_model.rb.tt +0 -52
data/lib/generators/robot_lab/templates/robot.rb.tt +0 -31
data/lib/generators/robot_lab/templates/robot_job.rb.tt +0 -18
data/lib/generators/robot_lab/templates/robot_test.rb.tt +0 -34
data/lib/generators/robot_lab/templates/routing_robot.rb.tt +0 -59
data/lib/generators/robot_lab/templates/thread_model.rb.tt +0 -40
data/lib/robot_lab/document_store.rb +0 -155
data/lib/robot_lab/ractor_boundary.rb +0 -42
data/lib/robot_lab/ractor_job.rb +0 -37
data/lib/robot_lab/ractor_memory_proxy.rb +0 -85
data/lib/robot_lab/ractor_network_scheduler.rb +0 -154
data/lib/robot_lab/ractor_worker_pool.rb +0 -117
data/lib/robot_lab/rails_integration/engine.rb +0 -29
data/lib/robot_lab/rails_integration/job.rb +0 -158
data/lib/robot_lab/rails_integration/railtie.rb +0 -51
data/lib/robot_lab/rails_integration/turbo_stream_callbacks.rb +0 -72

data/site/guides/building-robots/index.html ADDED Viewed

@@ -0,0 +1,4290 @@
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+        <meta name="description" content="Multi-robot LLM workflow orchestration for Ruby">
+        <meta name="author" content="Dewayne VanHoozer">
+        <link rel="canonical" href="https://madbomber.github.io/robot_lab/guides/building-robots/">
+        <link rel="prev" href="../">
+        <link rel="next" href="../creating-networks/">
+      <link rel="icon" href="../../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.1">
+        <title>Building Robots - RobotLab</title>
+      <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
+        <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
+        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
+      <link rel="stylesheet" href="../../assets/css/custom.css">
+    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+  </head>
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="amber">
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+        <a href="#building-robots" class="md-skip">
+          Skip to content
+        </a>
+    </div>
+    <div data-md-component="announce">
+    </div>
+<header class="md-header md-header--shadow md-header--lifted" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="Header">
+    <a href="../.." title="RobotLab" class="md-header__button md-logo" aria-label="RobotLab" data-md-component="logo">
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2a2 2 0 0 1 2 2c0 .74-.4 1.39-1 1.73V7h1a7 7 0 0 1 7 7h1a1 1 0 0 1 1 1v3a1 1 0 0 1-1 1h-1v1a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-1H2a1 1 0 0 1-1-1v-3a1 1 0 0 1 1-1h1a7 7 0 0 1 7-7h1V5.73c-.6-.34-1-.99-1-1.73a2 2 0 0 1 2-2M7.5 13A2.5 2.5 0 0 0 5 15.5 2.5 2.5 0 0 0 7.5 18a2.5 2.5 0 0 0 2.5-2.5A2.5 2.5 0 0 0 7.5 13m9 0a2.5 2.5 0 0 0-2.5 2.5 2.5 2.5 0 0 0 2.5 2.5 2.5 2.5 0 0 0 2.5-2.5 2.5 2.5 0 0 0-2.5-2.5"/></svg>
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            RobotLab
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+              Building Robots
+          </span>
+        </div>
+      </div>
+    </div>
+        <form class="md-header__option" data-md-component="palette">
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="amber"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+      <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
+      </label>
+    <input class="md-option" data-md-color-media="" data-md-color-scheme="slate" data-md-color-primary="deep-purple" data-md-color-accent="amber"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_1">
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
+      </label>
+</form>
+      <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+        <label class="md-header__button md-icon" for="__search">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
+        </label>
+        <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
+      </label>
+      <nav class="md-search__options" aria-label="Search">
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
+        </button>
+      </nav>
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            Initializing search
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+      <div class="md-header__source">
+        <a href="https://github.com/madbomber/robot_lab" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
+  </div>
+  <div class="md-source__repository">
+    madbomber/robot_lab
+  </div>
+</a>
+      </div>
+  </nav>
+<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
+  <div class="md-grid">
+    <ul class="md-tabs__list">
+      <li class="md-tabs__item">
+        <a href="../.." class="md-tabs__link">
+  Home
+        </a>
+      </li>
+      <li class="md-tabs__item">
+        <a href="../../getting-started/" class="md-tabs__link">
+  Getting Started
+        </a>
+      </li>
+      <li class="md-tabs__item">
+        <a href="../../architecture/" class="md-tabs__link">
+  Architecture
+        </a>
+      </li>
+      <li class="md-tabs__item md-tabs__item--active">
+        <a href="../" class="md-tabs__link">
+  Guides
+        </a>
+      </li>
+      <li class="md-tabs__item">
+        <a href="../../api/" class="md-tabs__link">
+  API Reference
+        </a>
+      </li>
+      <li class="md-tabs__item">
+        <a href="../../examples/" class="md-tabs__link">
+  Examples
+        </a>
+      </li>
+    </ul>
+  </div>
+</nav>
+</header>
+    <div class="md-container" data-md-component="container">
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href="../.." title="RobotLab" class="md-nav__button md-logo" aria-label="RobotLab" data-md-component="logo">
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2a2 2 0 0 1 2 2c0 .74-.4 1.39-1 1.73V7h1a7 7 0 0 1 7 7h1a1 1 0 0 1 1 1v3a1 1 0 0 1-1 1h-1v1a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-1H2a1 1 0 0 1-1-1v-3a1 1 0 0 1 1-1h1a7 7 0 0 1 7-7h1V5.73c-.6-.34-1-.99-1-1.73a2 2 0 0 1 2-2M7.5 13A2.5 2.5 0 0 0 5 15.5 2.5 2.5 0 0 0 7.5 18a2.5 2.5 0 0 0 2.5-2.5A2.5 2.5 0 0 0 7.5 13m9 0a2.5 2.5 0 0 0-2.5 2.5 2.5 2.5 0 0 0 2.5 2.5 2.5 2.5 0 0 0 2.5-2.5 2.5 2.5 0 0 0-2.5-2.5"/></svg>
+    </a>
+    RobotLab
+  </label>
+    <div class="md-nav__source">
+      <a href="https://github.com/madbomber/robot_lab" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
+  </div>
+  <div class="md-source__repository">
+    madbomber/robot_lab
+  </div>
+</a>
+    </div>
+  <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item md-nav__item--nested">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_1" >
+          <div class="md-nav__link md-nav__container">
+            <a href="../.." class="md-nav__link ">
+  <span class="md-ellipsis">
+    Home
+  </span>
+            </a>
+              <label class="md-nav__link " for="__nav_1" id="__nav_1_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+          </div>
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_1">
+            <span class="md-nav__icon md-icon"></span>
+    Home
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../concepts/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Concepts
+  </span>
+      </a>
+    </li>
+          </ul>
+        </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
+          <div class="md-nav__link md-nav__container">
+            <a href="../../getting-started/" class="md-nav__link ">
+  <span class="md-ellipsis">
+    Getting Started
+  </span>
+            </a>
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+          </div>
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2">
+            <span class="md-nav__icon md-icon"></span>
+    Getting Started
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../getting-started/installation/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Installation
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../getting-started/quick-start/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Quick Start
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../getting-started/configuration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Configuration
+  </span>
+      </a>
+    </li>
+          </ul>
+        </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+          <div class="md-nav__link md-nav__container">
+            <a href="../../architecture/" class="md-nav__link ">
+  <span class="md-ellipsis">
+    Architecture
+  </span>
+            </a>
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+          </div>
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_3">
+            <span class="md-nav__icon md-icon"></span>
+    Architecture
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../architecture/core-concepts/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Core Concepts
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../architecture/robot-execution/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Robot Execution
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../architecture/network-orchestration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Network Orchestration
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../architecture/state-management/" class="md-nav__link">
+  <span class="md-ellipsis">
+    State Management
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../architecture/message-flow/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Message Flow
+  </span>
+      </a>
+    </li>
+          </ul>
+        </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+  <span class="md-ellipsis">
+    Guides
+  </span>
+            </a>
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+          </div>
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_4">
+            <span class="md-nav__icon md-icon"></span>
+    Guides
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item md-nav__item--active">
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+  <span class="md-ellipsis">
+    Building Robots
+  </span>
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      <a href="./" class="md-nav__link md-nav__link--active">
+  <span class="md-ellipsis">
+    Building Robots
+  </span>
+      </a>
+<nav class="md-nav md-nav--secondary" aria-label="On this page">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      On this page
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+        <li class="md-nav__item">
+  <a href="#basic-robot" class="md-nav__link">
+    <span class="md-ellipsis">
+        Basic Robot
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#robot-properties" class="md-nav__link">
+    <span class="md-ellipsis">
+        Robot Properties
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Robot Properties">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#name" class="md-nav__link">
+    <span class="md-ellipsis">
+        Name
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#description" class="md-nav__link">
+    <span class="md-ellipsis">
+        Description
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#model" class="md-nav__link">
+    <span class="md-ellipsis">
+        Model
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#system-prompt" class="md-nav__link">
+    <span class="md-ellipsis">
+        System Prompt
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#template-files" class="md-nav__link">
+    <span class="md-ellipsis">
+        Template Files
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Template Files">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#template-format" class="md-nav__link">
+    <span class="md-ellipsis">
+        Template Format
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#front-matter-configuration" class="md-nav__link">
+    <span class="md-ellipsis">
+        Front Matter Configuration
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#self-contained-templates" class="md-nav__link">
+    <span class="md-ellipsis">
+        Self-Contained Templates
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#tools-in-front-matter" class="md-nav__link">
+    <span class="md-ellipsis">
+        Tools in Front Matter
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#mcp-in-front-matter" class="md-nav__link">
+    <span class="md-ellipsis">
+        MCP in Front Matter
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#template-with-system-prompt" class="md-nav__link">
+    <span class="md-ellipsis">
+        Template with System Prompt
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#composable-skills" class="md-nav__link">
+    <span class="md-ellipsis">
+        Composable Skills
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Composable Skills">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#why-skills" class="md-nav__link">
+    <span class="md-ellipsis">
+        Why Skills?
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#defining-a-skill" class="md-nav__link">
+    <span class="md-ellipsis">
+        Defining a Skill
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#using-skills-via-constructor" class="md-nav__link">
+    <span class="md-ellipsis">
+        Using Skills via Constructor
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#using-skills-via-front-matter" class="md-nav__link">
+    <span class="md-ellipsis">
+        Using Skills via Front Matter
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#nested-skills" class="md-nav__link">
+    <span class="md-ellipsis">
+        Nested Skills
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#cycle-detection" class="md-nav__link">
+    <span class="md-ellipsis">
+        Cycle Detection
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#config-cascade" class="md-nav__link">
+    <span class="md-ellipsis">
+        Config Cascade
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#skills-without-a-main-template" class="md-nav__link">
+    <span class="md-ellipsis">
+        Skills Without a Main Template
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#shared-context" class="md-nav__link">
+    <span class="md-ellipsis">
+        Shared Context
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#adding-tools" class="md-nav__link">
+    <span class="md-ellipsis">
+        Adding Tools
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#mcp-configuration" class="md-nav__link">
+    <span class="md-ellipsis">
+        MCP Configuration
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#chaining-configuration" class="md-nav__link">
+    <span class="md-ellipsis">
+        Chaining Configuration
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Chaining Configuration">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#available-chain-methods" class="md-nav__link">
+    <span class="md-ellipsis">
+        Available Chain Methods
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#running-robots" class="md-nav__link">
+    <span class="md-ellipsis">
+        Running Robots
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Running Robots">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#standalone" class="md-nav__link">
+    <span class="md-ellipsis">
+        Standalone
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#with-runtime-memory" class="md-nav__link">
+    <span class="md-ellipsis">
+        With Runtime Memory
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#in-a-network" class="md-nav__link">
+    <span class="md-ellipsis">
+        In a Network
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#with-streaming" class="md-nav__link">
+    <span class="md-ellipsis">
+        With Streaming
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#robot-patterns" class="md-nav__link">
+    <span class="md-ellipsis">
+        Robot Patterns
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Robot Patterns">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#classifier-robot" class="md-nav__link">
+    <span class="md-ellipsis">
+        Classifier Robot
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#specialist-robot" class="md-nav__link">
+    <span class="md-ellipsis">
+        Specialist Robot
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#summarizer-robot" class="md-nav__link">
+    <span class="md-ellipsis">
+        Summarizer Robot
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#bus-connected-robot" class="md-nav__link">
+    <span class="md-ellipsis">
+        Bus-Connected Robot
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#spawning-robots-dynamically" class="md-nav__link">
+    <span class="md-ellipsis">
+        Spawning Robots Dynamically
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#configuration" class="md-nav__link">
+    <span class="md-ellipsis">
+        Configuration
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#best-practices" class="md-nav__link">
+    <span class="md-ellipsis">
+        Best Practices
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Best Practices">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#1-clear-focused-prompts" class="md-nav__link">
+    <span class="md-ellipsis">
+        1. Clear, Focused Prompts
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#2-compose-behaviors-with-skills" class="md-nav__link">
+    <span class="md-ellipsis">
+        2. Compose Behaviors with Skills
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#3-use-templates-for-reusable-prompts" class="md-nav__link">
+    <span class="md-ellipsis">
+        3. Use Templates for Reusable Prompts
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#4-handle-tool-errors-gracefully" class="md-nav__link">
+    <span class="md-ellipsis">
+        4. Handle Tool Errors Gracefully
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#next-steps" class="md-nav__link">
+    <span class="md-ellipsis">
+        Next Steps
+    </span>
+  </a>
+</li>
+    </ul>
+</nav>
+    </li>
+    <li class="md-nav__item">
+      <a href="../creating-networks/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Creating Networks
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../using-tools/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Using Tools
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../mcp-integration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    MCP Integration
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../streaming/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Streaming Responses
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../memory/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Memory System
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../rails-integration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Rails Integration
+  </span>
+      </a>
+    </li>
+          </ul>
+        </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
+          <div class="md-nav__link md-nav__container">
+            <a href="../../api/" class="md-nav__link ">
+  <span class="md-ellipsis">
+    API Reference
+  </span>
+            </a>
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+          </div>
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5">
+            <span class="md-nav__icon md-icon"></span>
+    API Reference
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item md-nav__item--nested">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
+          <div class="md-nav__link md-nav__container">
+            <a href="../../api/core/" class="md-nav__link ">
+  <span class="md-ellipsis">
+    Core Classes
+  </span>
+            </a>
+              <label class="md-nav__link " for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+          </div>
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_2">
+            <span class="md-nav__icon md-icon"></span>
+    Core Classes
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../api/core/robot/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Robot
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../api/core/network/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Network
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../api/core/state/" class="md-nav__link">
+  <span class="md-ellipsis">
+    State
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../api/core/tool/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Tool
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../api/core/memory/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Memory
+  </span>
+      </a>
+    </li>
+          </ul>
+        </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
+          <div class="md-nav__link md-nav__container">
+            <a href="../../api/messages/" class="md-nav__link ">
+  <span class="md-ellipsis">
+    Messages
+  </span>
+            </a>
+              <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+          </div>
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_3">
+            <span class="md-nav__icon md-icon"></span>
+    Messages
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../api/messages/user-message/" class="md-nav__link">
+  <span class="md-ellipsis">
+    UserMessage
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../api/messages/text-message/" class="md-nav__link">
+  <span class="md-ellipsis">
+    TextMessage
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../api/messages/tool-call-message/" class="md-nav__link">
+  <span class="md-ellipsis">
+    ToolCallMessage
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../api/messages/tool-result-message/" class="md-nav__link">
+  <span class="md-ellipsis">
+    ToolResultMessage
+  </span>
+      </a>
+    </li>
+          </ul>
+        </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
+          <div class="md-nav__link md-nav__container">
+            <a href="../../api/mcp/" class="md-nav__link ">
+  <span class="md-ellipsis">
+    MCP
+  </span>
+            </a>
+              <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+          </div>
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_4">
+            <span class="md-nav__icon md-icon"></span>
+    MCP
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../api/mcp/client/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Client
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../api/mcp/server/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Server
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../api/mcp/transports/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Transports
+  </span>
+      </a>
+    </li>
+          </ul>
+        </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
+          <div class="md-nav__link md-nav__container">
+            <a href="../../api/streaming/" class="md-nav__link ">
+  <span class="md-ellipsis">
+    Streaming
+  </span>
+            </a>
+              <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+          </div>
+        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5_5">
+            <span class="md-nav__icon md-icon"></span>
+    Streaming
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../api/streaming/context/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Context
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../api/streaming/events/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Events
+  </span>
+      </a>
+    </li>
+          </ul>
+        </nav>
+    </li>
+          </ul>
+        </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+          <div class="md-nav__link md-nav__container">
+            <a href="../../examples/" class="md-nav__link ">
+  <span class="md-ellipsis">
+    Examples
+  </span>
+            </a>
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="0">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+          </div>
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+    Examples
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../examples/basic-chat/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Basic Chat
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../examples/multi-robot-network/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Multi-Robot Network
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../examples/tool-usage/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Tool Usage
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../examples/mcp-server/" class="md-nav__link">
+  <span class="md-ellipsis">
+    MCP Server
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../examples/rails-application/" class="md-nav__link">
+  <span class="md-ellipsis">
+    Rails Application
+  </span>
+      </a>
+    </li>
+          </ul>
+        </nav>
+    </li>
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+<nav class="md-nav md-nav--secondary" aria-label="On this page">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      On this page
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+        <li class="md-nav__item">
+  <a href="#basic-robot" class="md-nav__link">
+    <span class="md-ellipsis">
+        Basic Robot
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#robot-properties" class="md-nav__link">
+    <span class="md-ellipsis">
+        Robot Properties
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Robot Properties">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#name" class="md-nav__link">
+    <span class="md-ellipsis">
+        Name
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#description" class="md-nav__link">
+    <span class="md-ellipsis">
+        Description
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#model" class="md-nav__link">
+    <span class="md-ellipsis">
+        Model
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#system-prompt" class="md-nav__link">
+    <span class="md-ellipsis">
+        System Prompt
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#template-files" class="md-nav__link">
+    <span class="md-ellipsis">
+        Template Files
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Template Files">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#template-format" class="md-nav__link">
+    <span class="md-ellipsis">
+        Template Format
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#front-matter-configuration" class="md-nav__link">
+    <span class="md-ellipsis">
+        Front Matter Configuration
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#self-contained-templates" class="md-nav__link">
+    <span class="md-ellipsis">
+        Self-Contained Templates
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#tools-in-front-matter" class="md-nav__link">
+    <span class="md-ellipsis">
+        Tools in Front Matter
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#mcp-in-front-matter" class="md-nav__link">
+    <span class="md-ellipsis">
+        MCP in Front Matter
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#template-with-system-prompt" class="md-nav__link">
+    <span class="md-ellipsis">
+        Template with System Prompt
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#composable-skills" class="md-nav__link">
+    <span class="md-ellipsis">
+        Composable Skills
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Composable Skills">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#why-skills" class="md-nav__link">
+    <span class="md-ellipsis">
+        Why Skills?
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#defining-a-skill" class="md-nav__link">
+    <span class="md-ellipsis">
+        Defining a Skill
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#using-skills-via-constructor" class="md-nav__link">
+    <span class="md-ellipsis">
+        Using Skills via Constructor
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#using-skills-via-front-matter" class="md-nav__link">
+    <span class="md-ellipsis">
+        Using Skills via Front Matter
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#nested-skills" class="md-nav__link">
+    <span class="md-ellipsis">
+        Nested Skills
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#cycle-detection" class="md-nav__link">
+    <span class="md-ellipsis">
+        Cycle Detection
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#config-cascade" class="md-nav__link">
+    <span class="md-ellipsis">
+        Config Cascade
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#skills-without-a-main-template" class="md-nav__link">
+    <span class="md-ellipsis">
+        Skills Without a Main Template
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#shared-context" class="md-nav__link">
+    <span class="md-ellipsis">
+        Shared Context
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#adding-tools" class="md-nav__link">
+    <span class="md-ellipsis">
+        Adding Tools
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#mcp-configuration" class="md-nav__link">
+    <span class="md-ellipsis">
+        MCP Configuration
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#chaining-configuration" class="md-nav__link">
+    <span class="md-ellipsis">
+        Chaining Configuration
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Chaining Configuration">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#available-chain-methods" class="md-nav__link">
+    <span class="md-ellipsis">
+        Available Chain Methods
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#running-robots" class="md-nav__link">
+    <span class="md-ellipsis">
+        Running Robots
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Running Robots">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#standalone" class="md-nav__link">
+    <span class="md-ellipsis">
+        Standalone
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#with-runtime-memory" class="md-nav__link">
+    <span class="md-ellipsis">
+        With Runtime Memory
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#in-a-network" class="md-nav__link">
+    <span class="md-ellipsis">
+        In a Network
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#with-streaming" class="md-nav__link">
+    <span class="md-ellipsis">
+        With Streaming
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#robot-patterns" class="md-nav__link">
+    <span class="md-ellipsis">
+        Robot Patterns
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Robot Patterns">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#classifier-robot" class="md-nav__link">
+    <span class="md-ellipsis">
+        Classifier Robot
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#specialist-robot" class="md-nav__link">
+    <span class="md-ellipsis">
+        Specialist Robot
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#summarizer-robot" class="md-nav__link">
+    <span class="md-ellipsis">
+        Summarizer Robot
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#bus-connected-robot" class="md-nav__link">
+    <span class="md-ellipsis">
+        Bus-Connected Robot
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#spawning-robots-dynamically" class="md-nav__link">
+    <span class="md-ellipsis">
+        Spawning Robots Dynamically
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#configuration" class="md-nav__link">
+    <span class="md-ellipsis">
+        Configuration
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#best-practices" class="md-nav__link">
+    <span class="md-ellipsis">
+        Best Practices
+    </span>
+  </a>
+    <nav class="md-nav" aria-label="Best Practices">
+      <ul class="md-nav__list">
+          <li class="md-nav__item">
+  <a href="#1-clear-focused-prompts" class="md-nav__link">
+    <span class="md-ellipsis">
+        1. Clear, Focused Prompts
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#2-compose-behaviors-with-skills" class="md-nav__link">
+    <span class="md-ellipsis">
+        2. Compose Behaviors with Skills
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#3-use-templates-for-reusable-prompts" class="md-nav__link">
+    <span class="md-ellipsis">
+        3. Use Templates for Reusable Prompts
+    </span>
+  </a>
+</li>
+          <li class="md-nav__item">
+  <a href="#4-handle-tool-errors-gracefully" class="md-nav__link">
+    <span class="md-ellipsis">
+        4. Handle Tool Errors Gracefully
+    </span>
+  </a>
+</li>
+      </ul>
+    </nav>
+</li>
+        <li class="md-nav__item">
+  <a href="#next-steps" class="md-nav__link">
+    <span class="md-ellipsis">
+        Next Steps
+    </span>
+  </a>
+</li>
+    </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+    <a href="https://github.com/madbomber/robot_lab/edit/main/docs/guides/building-robots.md" title="Edit this page" class="md-content__button md-icon" rel="edit">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg>
+    </a>
+    <a href="https://github.com/madbomber/robot_lab/raw/main/docs/guides/building-robots.md" title="View source of this page" class="md-content__button md-icon">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 18c.56 0 1 .44 1 1s-.44 1-1 1-1-.44-1-1 .44-1 1-1m0-3c-2.73 0-5.06 1.66-6 4 .94 2.34 3.27 4 6 4s5.06-1.66 6-4c-.94-2.34-3.27-4-6-4m0 6.5a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5M9.27 20H6V4h7v5h5v4.07c.7.08 1.36.25 2 .49V8l-6-6H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h4.5a8.2 8.2 0 0 1-1.23-2"/></svg>
+    </a>
+<h1 id="building-robots">Building Robots<a class="headerlink" href="#building-robots" title="Permanent link">&para;</a></h1>
+<p>This guide covers everything you need to know about creating robots in RobotLab.</p>
+<h2 id="basic-robot">Basic Robot<a class="headerlink" href="#basic-robot" title="Permanent link">&para;</a></h2>
+<p>Create a robot using the <code>RobotLab.build</code> factory method with keyword arguments:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;assistant&quot;</span><span class="p">,</span>
+</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You are a helpful assistant.&quot;</span>
+</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="p">)</span>
+</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>
+</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;Hello!&quot;</span><span class="p">)</span>
+</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="nb">puts</span><span class="w"> </span><span class="n">result</span><span class="o">.</span><span class="n">last_text_content</span>
+</span></code></pre></div>
+<h2 id="robot-properties">Robot Properties<a class="headerlink" href="#robot-properties" title="Permanent link">&para;</a></h2>
+<h3 id="name">Name<a class="headerlink" href="#name" title="Permanent link">&para;</a></h3>
+<p>A unique identifier used for routing and logging. If omitted, an auto-generated name is used:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;support_agent&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;...&quot;</span><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="description">Description<a class="headerlink" href="#description" title="Permanent link">&para;</a></h3>
+<p>Describes what the robot does (useful for routing decisions):</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;support_agent&quot;</span><span class="p">,</span>
+</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="w">  </span><span class="ss">description</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Handles customer support inquiries about orders and refunds&quot;</span><span class="p">,</span>
+</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;...&quot;</span>
+</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="model">Model<a class="headerlink" href="#model" title="Permanent link">&para;</a></h3>
+<p>The LLM model to use. Defaults to the value in <code>RobotLab.config.ruby_llm.model</code>:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;writer&quot;</span><span class="p">,</span>
+</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="w">  </span><span class="ss">model</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;claude-sonnet-4&quot;</span><span class="p">,</span>
+</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You are a creative writer.&quot;</span>
+</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="system-prompt">System Prompt<a class="headerlink" href="#system-prompt" title="Permanent link">&para;</a></h3>
+<p>An inline string that defines the robot's personality and behavior:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;support&quot;</span><span class="p">,</span>
+</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="o">&lt;&lt;~</span><span class="dl">PROMPT</span>
+</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="sh">    You are a customer support specialist for TechCo.</span>
+</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a>
+</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="sh">    Your responsibilities:</span>
+</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="sh">    - Answer questions about products and services</span>
+</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="sh">    - Help resolve order issues</span>
+</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="sh">    - Provide friendly, professional assistance</span>
+</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a>
+</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="sh">    Always be polite and acknowledge the customer&#39;s concerns.</span>
+</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="dl">  PROMPT</span>
+</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="p">)</span>
+</span></code></pre></div>
+<h2 id="template-files">Template Files<a class="headerlink" href="#template-files" title="Permanent link">&para;</a></h2>
+<p>Templates are <code>.md</code> files managed by <a href="https://github.com/MadBomber/prompt_manager">prompt_manager</a>. Reference a template by symbol; RobotLab resolves it through the configured template path.</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="c1"># Reference template by symbol (loads prompts/support.md)</span>
+</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;support&quot;</span><span class="p">,</span>
+</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="w">  </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:support</span><span class="p">,</span>
+</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="w">  </span><span class="ss">context</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">company</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;TechCo&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">tone</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;friendly&quot;</span><span class="w"> </span><span class="p">}</span>
+</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="template-format">Template Format<a class="headerlink" href="#template-format" title="Permanent link">&para;</a></h3>
+<p>Templates use <code>.md</code> files with YAML front matter:</p>
+<div class="language-markdown highlight"><span class="filename">prompts/support.md</span><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>---
+</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>description: Customer support assistant
+</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>parameters:
+</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a>  company: &quot;Acme&quot;
+</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a>  tone: &quot;professional&quot;
+</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a>model: claude-sonnet-4
+</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="gu">temperature: 0.7</span>
+</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="gu">---</span>
+</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a>You are a support agent for &lt;%= company %&gt;.
+</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a>Your tone should be &lt;%= tone %&gt;.
+</span></code></pre></div>
+<h3 id="front-matter-configuration">Front Matter Configuration<a class="headerlink" href="#front-matter-configuration" title="Permanent link">&para;</a></h3>
+<p>The following YAML front matter keys are applied to the robot's chat automatically:</p>
+<p><strong>LLM Configuration:</strong></p>
+<table>
+<thead>
+<tr>
+<th>Key</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>model</code></td>
+<td>Override the LLM model</td>
+</tr>
+<tr>
+<td><code>temperature</code></td>
+<td>Controls randomness (0.0 - 1.0)</td>
+</tr>
+<tr>
+<td><code>top_p</code></td>
+<td>Nucleus sampling threshold</td>
+</tr>
+<tr>
+<td><code>top_k</code></td>
+<td>Top-k sampling</td>
+</tr>
+<tr>
+<td><code>max_tokens</code></td>
+<td>Maximum tokens in response</td>
+</tr>
+<tr>
+<td><code>presence_penalty</code></td>
+<td>Penalize based on presence</td>
+</tr>
+<tr>
+<td><code>frequency_penalty</code></td>
+<td>Penalize based on frequency</td>
+</tr>
+<tr>
+<td><code>stop</code></td>
+<td>Stop sequences</td>
+</tr>
+</tbody>
+</table>
+<p><strong>Robot Identity and Capabilities:</strong></p>
+<table>
+<thead>
+<tr>
+<th>Key</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>robot_name</code></td>
+<td>Override the robot's name (when constructor uses the default)</td>
+</tr>
+<tr>
+<td><code>description</code></td>
+<td>Human-readable description of the robot</td>
+</tr>
+<tr>
+<td><code>tools</code></td>
+<td>Array of tool class names (resolved via <code>Object.const_get</code>)</td>
+</tr>
+<tr>
+<td><code>mcp</code></td>
+<td>Array of MCP server configurations</td>
+</tr>
+<tr>
+<td><code>skills</code></td>
+<td>Array of skill template symbols to prepend (see <a href="#composable-skills">Composable Skills</a>)</td>
+</tr>
+</tbody>
+</table>
+<p>Constructor-provided values always take precedence over frontmatter values.</p>
+<h3 id="self-contained-templates">Self-Contained Templates<a class="headerlink" href="#self-contained-templates" title="Permanent link">&para;</a></h3>
+<p>Templates can declare everything a robot needs — identity, tools, MCP servers, and LLM config — making the <code>.md</code> file a complete robot definition:</p>
+<div class="language-markdown highlight"><span class="filename">prompts/github_assistant.md</span><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>---
+</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>description: GitHub assistant with MCP tool access
+</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a>robot_name: github_bot
+</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a>mcp:
+</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="w">  </span><span class="k">-</span><span class="w"> </span>name: github
+</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a>    transport: stdio
+</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a>    command: npx
+</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a>    args: [&quot;-y&quot;, &quot;@modelcontextprotocol/server-github&quot;]
+</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a>model: claude-sonnet-4
+</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="gu">temperature: 0.3</span>
+</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="gu">---</span>
+</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a>You are a helpful GitHub assistant with access to GitHub tools via MCP.
+</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a>Use the available tools to help answer questions about GitHub repositories.
+</span></code></pre></div>
+<p>Build the robot with minimal constructor arguments:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="c1"># Template provides name, description, MCP config, model, and temperature</span>
+</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:github_assistant</span><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="tools-in-front-matter">Tools in Front Matter<a class="headerlink" href="#tools-in-front-matter" title="Permanent link">&para;</a></h3>
+<p>Declare tool classes by name in the <code>tools:</code> key. RobotLab resolves each string to a Ruby constant and instantiates it:</p>
+<div class="language-markdown highlight"><span class="filename">prompts/order_support.md</span><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>---
+</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>description: Order support specialist
+</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a>tools:
+</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w">  </span><span class="k">-</span><span class="w"> </span>OrderLookup
+</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="gu">  - RefundProcessor</span>
+</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="gu">---</span>
+</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a>You help customers with order inquiries and refunds.
+</span></code></pre></div>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="c1"># Tools are loaded from frontmatter — no local_tools: needed</span>
+</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:order_support</span><span class="p">)</span>
+</span></code></pre></div>
+<p>Tool classes must be defined and loaded before the robot is built. If a tool name cannot be resolved, it is skipped with a warning.</p>
+<p>Constructor <code>local_tools:</code> overrides frontmatter <code>tools:</code> when provided:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="c1"># Constructor tools take precedence over frontmatter tools</span>
+</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="w">  </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:order_support</span><span class="p">,</span>
+</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="w">  </span><span class="ss">local_tools</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="no">OrderLookup</span><span class="o">]</span><span class="w">  </span><span class="c1"># Only OrderLookup, not RefundProcessor</span>
+</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="mcp-in-front-matter">MCP in Front Matter<a class="headerlink" href="#mcp-in-front-matter" title="Permanent link">&para;</a></h3>
+<p>Declare MCP server configurations directly in the template:</p>
+<div class="language-markdown highlight"><span class="filename">prompts/developer.md</span><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>---
+</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a>description: Developer assistant with filesystem access
+</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a>mcp:
+</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="w">  </span><span class="k">-</span><span class="w"> </span>name: filesystem
+</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a>    transport: stdio
+</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a>    command: mcp-server-filesystem
+</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="gu">    args: [&quot;--root&quot;, &quot;/home/user/projects&quot;]</span>
+</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a><span class="gu">---</span>
+</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a>You are a developer assistant with filesystem access.
+</span></code></pre></div>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:developer</span><span class="p">)</span>
+</span></code></pre></div>
+<p>Constructor <code>mcp:</code> overrides frontmatter <code>mcp:</code> when provided.</p>
+<h3 id="template-with-system-prompt">Template with System Prompt<a class="headerlink" href="#template-with-system-prompt" title="Permanent link">&para;</a></h3>
+<p>You can combine a template and an inline system prompt. Both are applied to the chat -- the template first, then the system prompt is appended as additional instructions:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;support&quot;</span><span class="p">,</span>
+</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="w">  </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:support</span><span class="p">,</span>
+</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="w">  </span><span class="ss">context</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">company</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;TechCo&quot;</span><span class="w"> </span><span class="p">},</span>
+</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Always respond in Spanish.&quot;</span>
+</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="p">)</span>
+</span></code></pre></div>
+<h2 id="composable-skills">Composable Skills<a class="headerlink" href="#composable-skills" title="Permanent link">&para;</a></h2>
+<p>Skills let you compose robot behaviors from reusable templates without creating a dedicated template for every combination. A skill is just a regular template whose prompt body gets prepended before the main template's body.</p>
+<h3 id="why-skills">Why Skills?<a class="headerlink" href="#why-skills" title="Permanent link">&para;</a></h3>
+<p>Consider a support agent that needs to:</p>
+<ul>
+<li>Ask clarifying questions before acting</li>
+<li>Detect customer sentiment</li>
+<li>Respond in structured JSON</li>
+</ul>
+<p>Without skills, you'd create a single monolithic template or copy-paste shared instructions across templates. With skills, each behavior is a standalone template that can be mixed into any robot.</p>
+<h3 id="defining-a-skill">Defining a Skill<a class="headerlink" href="#defining-a-skill" title="Permanent link">&para;</a></h3>
+<p>A skill is a standard <code>.md</code> template file. There is no special syntax — any template can be used as a skill:</p>
+<div class="language-markdown highlight"><span class="filename">prompts/clarifier.md</span><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>---
+</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="gu">description: Ask clarifying questions before acting</span>
+</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="gu">---</span>
+</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a>Before answering, consider whether the user&#39;s request is ambiguous.
+</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a>If so, ask one focused clarifying question before proceeding.
+</span></code></pre></div>
+<div class="language-markdown highlight"><span class="filename">prompts/json_responder.md</span><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>---
+</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a>description: Respond in structured JSON
+</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="gu">temperature: 0.2</span>
+</span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a><span class="gu">---</span>
+</span><span id="__span-16-5"><a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a>Always respond with valid JSON. Use this structure:
+</span><span id="__span-16-6"><a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a>{&quot;answer&quot;: &quot;...&quot;, &quot;confidence&quot;: 0.0-1.0, &quot;sources&quot;: [...]}
+</span></code></pre></div>
+<h3 id="using-skills-via-constructor">Using Skills via Constructor<a class="headerlink" href="#using-skills-via-constructor" title="Permanent link">&para;</a></h3>
+<p>Pass <code>skills:</code> as a symbol or array of symbols:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="c1"># Single skill</span>
+</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;bot&quot;</span><span class="p">,</span>
+</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="w">  </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:support</span><span class="p">,</span>
+</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a><span class="w">  </span><span class="ss">skills</span><span class="p">:</span><span class="w"> </span><span class="ss">:clarifier</span>
+</span><span id="__span-17-6"><a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a><span class="p">)</span>
+</span><span id="__span-17-7"><a id="__codelineno-17-7" name="__codelineno-17-7" href="#__codelineno-17-7"></a>
+</span><span id="__span-17-8"><a id="__codelineno-17-8" name="__codelineno-17-8" href="#__codelineno-17-8"></a><span class="c1"># Multiple skills</span>
+</span><span id="__span-17-9"><a id="__codelineno-17-9" name="__codelineno-17-9" href="#__codelineno-17-9"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-17-10"><a id="__codelineno-17-10" name="__codelineno-17-10" href="#__codelineno-17-10"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;bot&quot;</span><span class="p">,</span>
+</span><span id="__span-17-11"><a id="__codelineno-17-11" name="__codelineno-17-11" href="#__codelineno-17-11"></a><span class="w">  </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:support</span><span class="p">,</span>
+</span><span id="__span-17-12"><a id="__codelineno-17-12" name="__codelineno-17-12" href="#__codelineno-17-12"></a><span class="w">  </span><span class="ss">skills</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="ss">:clarifier</span><span class="p">,</span><span class="w"> </span><span class="ss">:json_responder</span><span class="o">]</span><span class="p">,</span>
+</span><span id="__span-17-13"><a id="__codelineno-17-13" name="__codelineno-17-13" href="#__codelineno-17-13"></a><span class="w">  </span><span class="ss">context</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">company</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Acme Corp&quot;</span><span class="w"> </span><span class="p">}</span>
+</span><span id="__span-17-14"><a id="__codelineno-17-14" name="__codelineno-17-14" href="#__codelineno-17-14"></a><span class="p">)</span>
+</span></code></pre></div>
+<p>The resulting system prompt is composed in order: clarifier body, then json_responder body, then the main support template body.</p>
+<h3 id="using-skills-via-front-matter">Using Skills via Front Matter<a class="headerlink" href="#using-skills-via-front-matter" title="Permanent link">&para;</a></h3>
+<p>Templates can declare skills directly in their front matter:</p>
+<div class="language-markdown highlight"><span class="filename">prompts/smart_support.md</span><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>---
+</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a>description: Support agent with built-in skills
+</span><span id="__span-18-3"><a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a>skills:
+</span><span id="__span-18-4"><a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a><span class="w">  </span><span class="k">-</span><span class="w"> </span>clarifier
+</span><span id="__span-18-5"><a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a><span class="w">  </span><span class="k">-</span><span class="w"> </span>json_responder
+</span><span id="__span-18-6"><a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a>parameters:
+</span><span id="__span-18-7"><a id="__codelineno-18-7" name="__codelineno-18-7" href="#__codelineno-18-7"></a><span class="gu">  company: null</span>
+</span><span id="__span-18-8"><a id="__codelineno-18-8" name="__codelineno-18-8" href="#__codelineno-18-8"></a><span class="gu">---</span>
+</span><span id="__span-18-9"><a id="__codelineno-18-9" name="__codelineno-18-9" href="#__codelineno-18-9"></a>You are a support agent for &lt;%= company %&gt;.
+</span><span id="__span-18-10"><a id="__codelineno-18-10" name="__codelineno-18-10" href="#__codelineno-18-10"></a>Help customers with their inquiries.
+</span></code></pre></div>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a><span class="c1"># Skills are loaded from front matter automatically</span>
+</span><span id="__span-19-2"><a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-19-3"><a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a><span class="w">  </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:smart_support</span><span class="p">,</span>
+</span><span id="__span-19-4"><a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a><span class="w">  </span><span class="ss">context</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">company</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Acme Corp&quot;</span><span class="w"> </span><span class="p">}</span>
+</span><span id="__span-19-5"><a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a><span class="p">)</span>
+</span></code></pre></div>
+<p>Constructor <code>skills:</code> and front matter <code>skills:</code> are combined — constructor skills are processed first, then front matter skills.</p>
+<h3 id="nested-skills">Nested Skills<a class="headerlink" href="#nested-skills" title="Permanent link">&para;</a></h3>
+<p>Skills can reference other skills, enabling layered composition:</p>
+<div class="language-markdown highlight"><span class="filename">prompts/safety.md</span><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>---
+</span><span id="__span-20-2"><a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a>description: Safety guidelines
+</span><span id="__span-20-3"><a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a>skills:
+</span><span id="__span-20-4"><a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a><span class="w">  </span><span class="k">-</span><span class="w"> </span>content_filter
+</span><span id="__span-20-5"><a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a><span class="gu">  - pii_redactor</span>
+</span><span id="__span-20-6"><a id="__codelineno-20-6" name="__codelineno-20-6" href="#__codelineno-20-6"></a><span class="gu">---</span>
+</span><span id="__span-20-7"><a id="__codelineno-20-7" name="__codelineno-20-7" href="#__codelineno-20-7"></a>Follow all safety guidelines when responding.
+</span></code></pre></div>
+<p>Nested skills are expanded depth-first. For the example above, the prompt order would be: content_filter, pii_redactor, safety, then the main template.</p>
+<h3 id="cycle-detection">Cycle Detection<a class="headerlink" href="#cycle-detection" title="Permanent link">&para;</a></h3>
+<p>If skills form a cycle (A references B, B references A), RobotLab detects it automatically, logs a warning, and skips the duplicate. This prevents infinite loops.</p>
+<h3 id="config-cascade">Config Cascade<a class="headerlink" href="#config-cascade" title="Permanent link">&para;</a></h3>
+<p>Skills can include LLM configuration in their front matter. Config cascades in processing order — later values override earlier ones:</p>
+<div class="language-markdown highlight"><span class="filename">prompts/creative_mode.md</span><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>---
+</span><span id="__span-21-2"><a id="__codelineno-21-2" name="__codelineno-21-2" href="#__codelineno-21-2"></a>description: Enable creative responses
+</span><span id="__span-21-3"><a id="__codelineno-21-3" name="__codelineno-21-3" href="#__codelineno-21-3"></a>temperature: 0.9
+</span><span id="__span-21-4"><a id="__codelineno-21-4" name="__codelineno-21-4" href="#__codelineno-21-4"></a><span class="gu">top_p: 0.95</span>
+</span><span id="__span-21-5"><a id="__codelineno-21-5" name="__codelineno-21-5" href="#__codelineno-21-5"></a><span class="gu">---</span>
+</span><span id="__span-21-6"><a id="__codelineno-21-6" name="__codelineno-21-6" href="#__codelineno-21-6"></a>Be creative and imaginative in your responses.
+</span></code></pre></div>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-22-2"><a id="__codelineno-22-2" name="__codelineno-22-2" href="#__codelineno-22-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;writer&quot;</span><span class="p">,</span>
+</span><span id="__span-22-3"><a id="__codelineno-22-3" name="__codelineno-22-3" href="#__codelineno-22-3"></a><span class="w">  </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:article_writer</span><span class="p">,</span>
+</span><span id="__span-22-4"><a id="__codelineno-22-4" name="__codelineno-22-4" href="#__codelineno-22-4"></a><span class="w">  </span><span class="ss">skills</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="ss">:creative_mode</span><span class="o">]</span>
+</span><span id="__span-22-5"><a id="__codelineno-22-5" name="__codelineno-22-5" href="#__codelineno-22-5"></a><span class="p">)</span>
+</span><span id="__span-22-6"><a id="__codelineno-22-6" name="__codelineno-22-6" href="#__codelineno-22-6"></a><span class="c1"># temperature is 0.9 from the skill (unless the main template or constructor overrides it)</span>
+</span></code></pre></div>
+<p>The precedence order (highest wins):</p>
+<ol>
+<li>Constructor kwargs (<code>temperature: 0.3</code>)</li>
+<li>Main template front matter</li>
+<li>Later skills override earlier skills</li>
+<li>First skill in the list</li>
+</ol>
+<h3 id="skills-without-a-main-template">Skills Without a Main Template<a class="headerlink" href="#skills-without-a-main-template" title="Permanent link">&para;</a></h3>
+<p>Skills work without a main template — useful for quick composition:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-23-1"><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-23-2"><a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;safe_bot&quot;</span><span class="p">,</span>
+</span><span id="__span-23-3"><a id="__codelineno-23-3" name="__codelineno-23-3" href="#__codelineno-23-3"></a><span class="w">  </span><span class="ss">skills</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="ss">:safety</span><span class="p">,</span><span class="w"> </span><span class="ss">:json_responder</span><span class="o">]</span><span class="p">,</span>
+</span><span id="__span-23-4"><a id="__codelineno-23-4" name="__codelineno-23-4" href="#__codelineno-23-4"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You answer questions about our product.&quot;</span>
+</span><span id="__span-23-5"><a id="__codelineno-23-5" name="__codelineno-23-5" href="#__codelineno-23-5"></a><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="shared-context">Shared Context<a class="headerlink" href="#shared-context" title="Permanent link">&para;</a></h3>
+<p>All skills and the main template render with the same <code>context:</code> hash. Define parameters in each skill's front matter and pass values through the shared context:</p>
+<div class="language-markdown highlight"><span class="filename">prompts/branded.md</span><pre><span></span><code><span id="__span-24-1"><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a>---
+</span><span id="__span-24-2"><a id="__codelineno-24-2" name="__codelineno-24-2" href="#__codelineno-24-2"></a>description: Brand-aware responses
+</span><span id="__span-24-3"><a id="__codelineno-24-3" name="__codelineno-24-3" href="#__codelineno-24-3"></a>parameters:
+</span><span id="__span-24-4"><a id="__codelineno-24-4" name="__codelineno-24-4" href="#__codelineno-24-4"></a><span class="gu">  company_name: null</span>
+</span><span id="__span-24-5"><a id="__codelineno-24-5" name="__codelineno-24-5" href="#__codelineno-24-5"></a><span class="gu">---</span>
+</span><span id="__span-24-6"><a id="__codelineno-24-6" name="__codelineno-24-6" href="#__codelineno-24-6"></a>You represent &lt;%= company_name %&gt;. Always maintain brand voice.
+</span></code></pre></div>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-25-1"><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-25-2"><a id="__codelineno-25-2" name="__codelineno-25-2" href="#__codelineno-25-2"></a><span class="w">  </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:support</span><span class="p">,</span>
+</span><span id="__span-25-3"><a id="__codelineno-25-3" name="__codelineno-25-3" href="#__codelineno-25-3"></a><span class="w">  </span><span class="ss">skills</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="ss">:branded</span><span class="o">]</span><span class="p">,</span>
+</span><span id="__span-25-4"><a id="__codelineno-25-4" name="__codelineno-25-4" href="#__codelineno-25-4"></a><span class="w">  </span><span class="ss">context</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">company_name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Acme Corp&quot;</span><span class="w"> </span><span class="p">}</span><span class="w">  </span><span class="c1"># shared with all skills</span>
+</span><span id="__span-25-5"><a id="__codelineno-25-5" name="__codelineno-25-5" href="#__codelineno-25-5"></a><span class="p">)</span>
+</span></code></pre></div>
+<h2 id="adding-tools">Adding Tools<a class="headerlink" href="#adding-tools" title="Permanent link">&para;</a></h2>
+<p>Give robots capabilities via the <code>local_tools:</code> parameter. Tools can be <code>RubyLLM::Tool</code> subclasses or <code>RobotLab::Tool</code> instances:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-26-1"><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-26-2"><a id="__codelineno-26-2" name="__codelineno-26-2" href="#__codelineno-26-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;order_assistant&quot;</span><span class="p">,</span>
+</span><span id="__span-26-3"><a id="__codelineno-26-3" name="__codelineno-26-3" href="#__codelineno-26-3"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You help customers with orders.&quot;</span><span class="p">,</span>
+</span><span id="__span-26-4"><a id="__codelineno-26-4" name="__codelineno-26-4" href="#__codelineno-26-4"></a><span class="w">  </span><span class="ss">local_tools</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="no">OrderLookup</span><span class="p">,</span><span class="w"> </span><span class="no">InventoryCheck</span><span class="o">]</span>
+</span><span id="__span-26-5"><a id="__codelineno-26-5" name="__codelineno-26-5" href="#__codelineno-26-5"></a><span class="p">)</span>
+</span></code></pre></div>
+<p>See the <a href="../using-tools/">Using Tools</a> guide for details on defining tools.</p>
+<h2 id="mcp-configuration">MCP Configuration<a class="headerlink" href="#mcp-configuration" title="Permanent link">&para;</a></h2>
+<p>Connect to MCP (Model Context Protocol) servers via the <code>mcp:</code> parameter:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-27-1"><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-27-2"><a id="__codelineno-27-2" name="__codelineno-27-2" href="#__codelineno-27-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;coder&quot;</span><span class="p">,</span>
+</span><span id="__span-27-3"><a id="__codelineno-27-3" name="__codelineno-27-3" href="#__codelineno-27-3"></a><span class="w">  </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:developer</span><span class="p">,</span>
+</span><span id="__span-27-4"><a id="__codelineno-27-4" name="__codelineno-27-4" href="#__codelineno-27-4"></a><span class="w">  </span><span class="ss">mcp</span><span class="p">:</span><span class="w"> </span><span class="o">[</span>
+</span><span id="__span-27-5"><a id="__codelineno-27-5" name="__codelineno-27-5" href="#__codelineno-27-5"></a><span class="w">    </span><span class="p">{</span>
+</span><span id="__span-27-6"><a id="__codelineno-27-6" name="__codelineno-27-6" href="#__codelineno-27-6"></a><span class="w">      </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;filesystem&quot;</span><span class="p">,</span>
+</span><span id="__span-27-7"><a id="__codelineno-27-7" name="__codelineno-27-7" href="#__codelineno-27-7"></a><span class="w">      </span><span class="ss">transport</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;stdio&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">command</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;mcp-server-fs&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">args</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="s2">&quot;--root&quot;</span><span class="p">,</span><span class="w"> </span><span class="s2">&quot;/data&quot;</span><span class="o">]</span><span class="w"> </span><span class="p">}</span>
+</span><span id="__span-27-8"><a id="__codelineno-27-8" name="__codelineno-27-8" href="#__codelineno-27-8"></a><span class="w">    </span><span class="p">}</span>
+</span><span id="__span-27-9"><a id="__codelineno-27-9" name="__codelineno-27-9" href="#__codelineno-27-9"></a><span class="w">  </span><span class="o">]</span>
+</span><span id="__span-27-10"><a id="__codelineno-27-10" name="__codelineno-27-10" href="#__codelineno-27-10"></a><span class="p">)</span>
+</span></code></pre></div>
+<p>MCP configuration supports hierarchical resolution:</p>
+<table>
+<thead>
+<tr>
+<th>Value</th>
+<th>Behavior</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>:none</code></td>
+<td>No MCP servers (default)</td>
+</tr>
+<tr>
+<td><code>:inherit</code></td>
+<td>Use parent network/config MCP servers</td>
+</tr>
+<tr>
+<td><code>[...]</code></td>
+<td>Explicit array of server configurations</td>
+</tr>
+</tbody>
+</table>
+<p>See the <a href="../mcp-integration/">MCP Integration</a> guide for transport types and advanced patterns.</p>
+<h2 id="chaining-configuration">Chaining Configuration<a class="headerlink" href="#chaining-configuration" title="Permanent link">&para;</a></h2>
+<p>Robots support <code>with_*</code> method chaining for runtime reconfiguration. Each method returns <code>self</code> for fluent usage:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-28-1"><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;bot&quot;</span><span class="p">)</span>
+</span><span id="__span-28-2"><a id="__codelineno-28-2" name="__codelineno-28-2" href="#__codelineno-28-2"></a>
+</span><span id="__span-28-3"><a id="__codelineno-28-3" name="__codelineno-28-3" href="#__codelineno-28-3"></a><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">robot</span>
+</span><span id="__span-28-4"><a id="__codelineno-28-4" name="__codelineno-28-4" href="#__codelineno-28-4"></a><span class="w">  </span><span class="o">.</span><span class="n">with_instructions</span><span class="p">(</span><span class="s2">&quot;Be concise and direct.&quot;</span><span class="p">)</span>
+</span><span id="__span-28-5"><a id="__codelineno-28-5" name="__codelineno-28-5" href="#__codelineno-28-5"></a><span class="w">  </span><span class="o">.</span><span class="n">with_temperature</span><span class="p">(</span><span class="mi">0</span><span class="o">.</span><span class="mi">9</span><span class="p">)</span>
+</span><span id="__span-28-6"><a id="__codelineno-28-6" name="__codelineno-28-6" href="#__codelineno-28-6"></a><span class="w">  </span><span class="o">.</span><span class="n">with_model</span><span class="p">(</span><span class="s2">&quot;claude-sonnet-4&quot;</span><span class="p">)</span>
+</span><span id="__span-28-7"><a id="__codelineno-28-7" name="__codelineno-28-7" href="#__codelineno-28-7"></a><span class="w">  </span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;Summarize quantum computing in one sentence.&quot;</span><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="available-chain-methods">Available Chain Methods<a class="headerlink" href="#available-chain-methods" title="Permanent link">&para;</a></h3>
+<table>
+<thead>
+<tr>
+<th>Method</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>with_model(id)</code></td>
+<td>Change the LLM model</td>
+</tr>
+<tr>
+<td><code>with_instructions(text)</code></td>
+<td>Set system instructions</td>
+</tr>
+<tr>
+<td><code>with_temperature(val)</code></td>
+<td>Set temperature</td>
+</tr>
+<tr>
+<td><code>with_top_p(val)</code></td>
+<td>Set nucleus sampling</td>
+</tr>
+<tr>
+<td><code>with_top_k(val)</code></td>
+<td>Set top-k sampling</td>
+</tr>
+<tr>
+<td><code>with_max_tokens(val)</code></td>
+<td>Set max output tokens</td>
+</tr>
+<tr>
+<td><code>with_presence_penalty(val)</code></td>
+<td>Set presence penalty</td>
+</tr>
+<tr>
+<td><code>with_frequency_penalty(val)</code></td>
+<td>Set frequency penalty</td>
+</tr>
+<tr>
+<td><code>with_stop(sequences)</code></td>
+<td>Set stop sequences</td>
+</tr>
+<tr>
+<td><code>with_tool(tool)</code></td>
+<td>Add a single tool</td>
+</tr>
+<tr>
+<td><code>with_tools(*tools)</code></td>
+<td>Add multiple tools</td>
+</tr>
+<tr>
+<td><code>with_template(id, **ctx)</code></td>
+<td>Apply a prompt template</td>
+</tr>
+<tr>
+<td><code>with_schema(schema)</code></td>
+<td>Set structured output schema</td>
+</tr>
+<tr>
+<td><code>with_thinking(config)</code></td>
+<td>Enable extended thinking</td>
+</tr>
+<tr>
+<td><code>with_bus(bus)</code></td>
+<td>Connect to a message bus (creates one if nil)</td>
+</tr>
+</tbody>
+</table>
+<h2 id="running-robots">Running Robots<a class="headerlink" href="#running-robots" title="Permanent link">&para;</a></h2>
+<h3 id="standalone">Standalone<a class="headerlink" href="#standalone" title="Permanent link">&para;</a></h3>
+<p>Run a robot directly with a string message:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-29-1"><a id="__codelineno-29-1" name="__codelineno-29-1" href="#__codelineno-29-1"></a><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;Hello!&quot;</span><span class="p">)</span>
+</span><span id="__span-29-2"><a id="__codelineno-29-2" name="__codelineno-29-2" href="#__codelineno-29-2"></a><span class="nb">puts</span><span class="w"> </span><span class="n">result</span><span class="o">.</span><span class="n">last_text_content</span>
+</span></code></pre></div>
+<p>The <code>run</code> method returns a <code>RobotResult</code> with:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-30-1"><a id="__codelineno-30-1" name="__codelineno-30-1" href="#__codelineno-30-1"></a><span class="n">result</span><span class="o">.</span><span class="n">last_text_content</span><span class="w">  </span><span class="c1"># =&gt; &quot;Hi there! How can I help?&quot;</span>
+</span><span id="__span-30-2"><a id="__codelineno-30-2" name="__codelineno-30-2" href="#__codelineno-30-2"></a><span class="n">result</span><span class="o">.</span><span class="n">output</span><span class="w">             </span><span class="c1"># =&gt; Array of output messages</span>
+</span><span id="__span-30-3"><a id="__codelineno-30-3" name="__codelineno-30-3" href="#__codelineno-30-3"></a><span class="n">result</span><span class="o">.</span><span class="n">tool_calls</span><span class="w">         </span><span class="c1"># =&gt; Array of tool call results</span>
+</span><span id="__span-30-4"><a id="__codelineno-30-4" name="__codelineno-30-4" href="#__codelineno-30-4"></a><span class="n">result</span><span class="o">.</span><span class="n">robot_name</span><span class="w">         </span><span class="c1"># =&gt; &quot;assistant&quot;</span>
+</span><span id="__span-30-5"><a id="__codelineno-30-5" name="__codelineno-30-5" href="#__codelineno-30-5"></a><span class="n">result</span><span class="o">.</span><span class="n">stop_reason</span><span class="w">        </span><span class="c1"># =&gt; stop reason from the LLM</span>
+</span></code></pre></div>
+<h3 id="with-runtime-memory">With Runtime Memory<a class="headerlink" href="#with-runtime-memory" title="Permanent link">&para;</a></h3>
+<p>Inject memory values for a single run:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-31-1"><a id="__codelineno-31-1" name="__codelineno-31-1" href="#__codelineno-31-1"></a><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;What&#39;s my account status?&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">memory</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">user_id</span><span class="p">:</span><span class="w"> </span><span class="mi">123</span><span class="w"> </span><span class="p">})</span>
+</span></code></pre></div>
+<h3 id="in-a-network">In a Network<a class="headerlink" href="#in-a-network" title="Permanent link">&para;</a></h3>
+<p>Run through a network for orchestration:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-32-1"><a id="__codelineno-32-1" name="__codelineno-32-1" href="#__codelineno-32-1"></a><span class="n">network</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">create_network</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;pipeline&quot;</span><span class="p">)</span><span class="w"> </span><span class="k">do</span>
+</span><span id="__span-32-2"><a id="__codelineno-32-2" name="__codelineno-32-2" href="#__codelineno-32-2"></a><span class="w">  </span><span class="n">task</span><span class="w"> </span><span class="ss">:assistant</span><span class="p">,</span><span class="w"> </span><span class="n">robot</span><span class="p">,</span><span class="w"> </span><span class="ss">depends_on</span><span class="p">:</span><span class="w"> </span><span class="ss">:none</span>
+</span><span id="__span-32-3"><a id="__codelineno-32-3" name="__codelineno-32-3" href="#__codelineno-32-3"></a><span class="k">end</span>
+</span><span id="__span-32-4"><a id="__codelineno-32-4" name="__codelineno-32-4" href="#__codelineno-32-4"></a>
+</span><span id="__span-32-5"><a id="__codelineno-32-5" name="__codelineno-32-5" href="#__codelineno-32-5"></a><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">network</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="ss">message</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Hello!&quot;</span><span class="p">)</span>
+</span><span id="__span-32-6"><a id="__codelineno-32-6" name="__codelineno-32-6" href="#__codelineno-32-6"></a><span class="nb">puts</span><span class="w"> </span><span class="n">result</span><span class="o">.</span><span class="n">value</span><span class="o">.</span><span class="n">last_text_content</span>
+</span></code></pre></div>
+<h3 id="with-streaming">With Streaming<a class="headerlink" href="#with-streaming" title="Permanent link">&para;</a></h3>
+<p>Stream LLM content in real-time using a stored callback, a per-call block, or both. Each receives a <a href="https://rubyllm.com/streaming/#basic-streaming"><code>RubyLLM::Chunk</code></a> object — use <code>chunk.content</code> for the text delta. Chunks also carry <code>model_id</code>, <code>tool_calls</code>, <code>thinking</code>, and token usage on the final chunk. See the <a href="../../api/core/robot/#streaming">Streaming API reference</a> for the full chunk interface.</p>
+<p><strong>Stored callback</strong> — wired at build time, fires on every <code>run()</code>:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-33-1"><a id="__codelineno-33-1" name="__codelineno-33-1" href="#__codelineno-33-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-33-2"><a id="__codelineno-33-2" name="__codelineno-33-2" href="#__codelineno-33-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;assistant&quot;</span><span class="p">,</span>
+</span><span id="__span-33-3"><a id="__codelineno-33-3" name="__codelineno-33-3" href="#__codelineno-33-3"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You are helpful.&quot;</span><span class="p">,</span>
+</span><span id="__span-33-4"><a id="__codelineno-33-4" name="__codelineno-33-4" href="#__codelineno-33-4"></a><span class="w">  </span><span class="ss">on_content</span><span class="p">:</span><span class="w"> </span><span class="o">-&gt;</span><span class="p">(</span><span class="n">chunk</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nb">print</span><span class="w"> </span><span class="n">chunk</span><span class="o">.</span><span class="n">content</span><span class="w"> </span><span class="p">}</span>
+</span><span id="__span-33-5"><a id="__codelineno-33-5" name="__codelineno-33-5" href="#__codelineno-33-5"></a><span class="p">)</span>
+</span><span id="__span-33-6"><a id="__codelineno-33-6" name="__codelineno-33-6" href="#__codelineno-33-6"></a><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;Tell me a story&quot;</span><span class="p">)</span><span class="w">  </span><span class="c1"># streams automatically</span>
+</span></code></pre></div>
+<p><strong>Per-call block</strong> — passed to <code>run()</code>:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-34-1"><a id="__codelineno-34-1" name="__codelineno-34-1" href="#__codelineno-34-1"></a><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;Tell me a story&quot;</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="o">|</span><span class="n">chunk</span><span class="o">|</span><span class="w"> </span><span class="nb">print</span><span class="w"> </span><span class="n">chunk</span><span class="o">.</span><span class="n">content</span><span class="w"> </span><span class="p">}</span>
+</span></code></pre></div>
+<p><strong>Both together</strong> — stored fires first, then the block:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-35-1"><a id="__codelineno-35-1" name="__codelineno-35-1" href="#__codelineno-35-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-35-2"><a id="__codelineno-35-2" name="__codelineno-35-2" href="#__codelineno-35-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;assistant&quot;</span><span class="p">,</span>
+</span><span id="__span-35-3"><a id="__codelineno-35-3" name="__codelineno-35-3" href="#__codelineno-35-3"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You are helpful.&quot;</span><span class="p">,</span>
+</span><span id="__span-35-4"><a id="__codelineno-35-4" name="__codelineno-35-4" href="#__codelineno-35-4"></a><span class="w">  </span><span class="ss">on_content</span><span class="p">:</span><span class="w"> </span><span class="o">-&gt;</span><span class="p">(</span><span class="n">chunk</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">log_chunk</span><span class="p">(</span><span class="n">chunk</span><span class="o">.</span><span class="n">content</span><span class="p">)</span><span class="w"> </span><span class="p">}</span>
+</span><span id="__span-35-5"><a id="__codelineno-35-5" name="__codelineno-35-5" href="#__codelineno-35-5"></a><span class="p">)</span>
+</span><span id="__span-35-6"><a id="__codelineno-35-6" name="__codelineno-35-6" href="#__codelineno-35-6"></a><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;Tell me a story&quot;</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="o">|</span><span class="n">chunk</span><span class="o">|</span><span class="w"> </span><span class="n">stream_to_client</span><span class="p">(</span><span class="n">chunk</span><span class="o">.</span><span class="n">content</span><span class="p">)</span><span class="w"> </span><span class="p">}</span>
+</span></code></pre></div>
+<p>The <code>on_content</code> callback participates in the RunConfig cascade, so it can be set at the config level and inherited by robots:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-36-1"><a id="__codelineno-36-1" name="__codelineno-36-1" href="#__codelineno-36-1"></a><span class="n">config</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">::</span><span class="no">RunConfig</span><span class="o">.</span><span class="n">new</span><span class="p">(</span>
+</span><span id="__span-36-2"><a id="__codelineno-36-2" name="__codelineno-36-2" href="#__codelineno-36-2"></a><span class="w">  </span><span class="ss">on_content</span><span class="p">:</span><span class="w"> </span><span class="o">-&gt;</span><span class="p">(</span><span class="n">chunk</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">broadcast</span><span class="p">(</span><span class="n">chunk</span><span class="o">.</span><span class="n">content</span><span class="p">)</span><span class="w"> </span><span class="p">}</span>
+</span><span id="__span-36-3"><a id="__codelineno-36-3" name="__codelineno-36-3" href="#__codelineno-36-3"></a><span class="p">)</span>
+</span><span id="__span-36-4"><a id="__codelineno-36-4" name="__codelineno-36-4" href="#__codelineno-36-4"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;bot&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;...&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">config</span><span class="p">:</span><span class="w"> </span><span class="n">config</span><span class="p">)</span>
+</span></code></pre></div>
+<p>You can also monitor tool activity via callbacks:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-37-1"><a id="__codelineno-37-1" name="__codelineno-37-1" href="#__codelineno-37-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-37-2"><a id="__codelineno-37-2" name="__codelineno-37-2" href="#__codelineno-37-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;assistant&quot;</span><span class="p">,</span>
+</span><span id="__span-37-3"><a id="__codelineno-37-3" name="__codelineno-37-3" href="#__codelineno-37-3"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;...&quot;</span><span class="p">,</span>
+</span><span id="__span-37-4"><a id="__codelineno-37-4" name="__codelineno-37-4" href="#__codelineno-37-4"></a><span class="w">  </span><span class="ss">on_tool_call</span><span class="p">:</span><span class="w"> </span><span class="o">-&gt;</span><span class="p">(</span><span class="n">tool_call</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nb">puts</span><span class="w"> </span><span class="s2">&quot;Calling: </span><span class="si">#{</span><span class="n">tool_call</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span><span class="p">},</span>
+</span><span id="__span-37-5"><a id="__codelineno-37-5" name="__codelineno-37-5" href="#__codelineno-37-5"></a><span class="w">  </span><span class="ss">on_tool_result</span><span class="p">:</span><span class="w"> </span><span class="o">-&gt;</span><span class="p">(</span><span class="n">result</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nb">puts</span><span class="w"> </span><span class="s2">&quot;Result: </span><span class="si">#{</span><span class="n">result</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span><span class="p">}</span>
+</span><span id="__span-37-6"><a id="__codelineno-37-6" name="__codelineno-37-6" href="#__codelineno-37-6"></a><span class="p">)</span>
+</span></code></pre></div>
+<h2 id="robot-patterns">Robot Patterns<a class="headerlink" href="#robot-patterns" title="Permanent link">&para;</a></h2>
+<h3 id="classifier-robot">Classifier Robot<a class="headerlink" href="#classifier-robot" title="Permanent link">&para;</a></h3>
+<p>Route requests to specialized handlers. Subclass <code>RobotLab::Robot</code> and override <code>call</code> for custom pipeline behavior:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-38-1"><a id="__codelineno-38-1" name="__codelineno-38-1" href="#__codelineno-38-1"></a><span class="k">class</span><span class="w"> </span><span class="nc">ClassifierRobot</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">::</span><span class="no">Robot</span>
+</span><span id="__span-38-2"><a id="__codelineno-38-2" name="__codelineno-38-2" href="#__codelineno-38-2"></a><span class="w">  </span><span class="k">def</span><span class="w"> </span><span class="nf">call</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
+</span><span id="__span-38-3"><a id="__codelineno-38-3" name="__codelineno-38-3" href="#__codelineno-38-3"></a><span class="w">    </span><span class="n">context</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">extract_run_context</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
+</span><span id="__span-38-4"><a id="__codelineno-38-4" name="__codelineno-38-4" href="#__codelineno-38-4"></a><span class="w">    </span><span class="n">message</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">context</span><span class="o">.</span><span class="n">delete</span><span class="p">(</span><span class="ss">:message</span><span class="p">)</span>
+</span><span id="__span-38-5"><a id="__codelineno-38-5" name="__codelineno-38-5" href="#__codelineno-38-5"></a><span class="w">    </span><span class="n">robot_result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">run</span><span class="p">(</span><span class="n">message</span><span class="p">,</span><span class="w"> </span><span class="o">**</span><span class="n">context</span><span class="p">)</span>
+</span><span id="__span-38-6"><a id="__codelineno-38-6" name="__codelineno-38-6" href="#__codelineno-38-6"></a>
+</span><span id="__span-38-7"><a id="__codelineno-38-7" name="__codelineno-38-7" href="#__codelineno-38-7"></a><span class="w">    </span><span class="n">new_result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">result</span>
+</span><span id="__span-38-8"><a id="__codelineno-38-8" name="__codelineno-38-8" href="#__codelineno-38-8"></a><span class="w">      </span><span class="o">.</span><span class="n">with_context</span><span class="p">(</span><span class="vi">@name</span><span class="o">.</span><span class="n">to_sym</span><span class="p">,</span><span class="w"> </span><span class="n">robot_result</span><span class="p">)</span>
+</span><span id="__span-38-9"><a id="__codelineno-38-9" name="__codelineno-38-9" href="#__codelineno-38-9"></a><span class="w">      </span><span class="o">.</span><span class="n">continue</span><span class="p">(</span><span class="n">robot_result</span><span class="p">)</span>
+</span><span id="__span-38-10"><a id="__codelineno-38-10" name="__codelineno-38-10" href="#__codelineno-38-10"></a>
+</span><span id="__span-38-11"><a id="__codelineno-38-11" name="__codelineno-38-11" href="#__codelineno-38-11"></a><span class="w">    </span><span class="n">category</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">robot_result</span><span class="o">.</span><span class="n">last_text_content</span><span class="o">.</span><span class="n">to_s</span><span class="o">.</span><span class="n">strip</span><span class="o">.</span><span class="n">downcase</span>
+</span><span id="__span-38-12"><a id="__codelineno-38-12" name="__codelineno-38-12" href="#__codelineno-38-12"></a>
+</span><span id="__span-38-13"><a id="__codelineno-38-13" name="__codelineno-38-13" href="#__codelineno-38-13"></a><span class="w">    </span><span class="k">case</span><span class="w"> </span><span class="n">category</span>
+</span><span id="__span-38-14"><a id="__codelineno-38-14" name="__codelineno-38-14" href="#__codelineno-38-14"></a><span class="w">    </span><span class="k">when</span><span class="w"> </span><span class="sr">/billing/</span><span class="w"> </span><span class="k">then</span><span class="w"> </span><span class="n">new_result</span><span class="o">.</span><span class="n">activate</span><span class="p">(</span><span class="ss">:billing</span><span class="p">)</span>
+</span><span id="__span-38-15"><a id="__codelineno-38-15" name="__codelineno-38-15" href="#__codelineno-38-15"></a><span class="w">    </span><span class="k">when</span><span class="w"> </span><span class="sr">/technical/</span><span class="w"> </span><span class="k">then</span><span class="w"> </span><span class="n">new_result</span><span class="o">.</span><span class="n">activate</span><span class="p">(</span><span class="ss">:technical</span><span class="p">)</span>
+</span><span id="__span-38-16"><a id="__codelineno-38-16" name="__codelineno-38-16" href="#__codelineno-38-16"></a><span class="w">    </span><span class="k">else</span><span class="w"> </span><span class="n">new_result</span><span class="o">.</span><span class="n">activate</span><span class="p">(</span><span class="ss">:general</span><span class="p">)</span>
+</span><span id="__span-38-17"><a id="__codelineno-38-17" name="__codelineno-38-17" href="#__codelineno-38-17"></a><span class="w">    </span><span class="k">end</span>
+</span><span id="__span-38-18"><a id="__codelineno-38-18" name="__codelineno-38-18" href="#__codelineno-38-18"></a><span class="w">  </span><span class="k">end</span>
+</span><span id="__span-38-19"><a id="__codelineno-38-19" name="__codelineno-38-19" href="#__codelineno-38-19"></a><span class="k">end</span>
+</span><span id="__span-38-20"><a id="__codelineno-38-20" name="__codelineno-38-20" href="#__codelineno-38-20"></a>
+</span><span id="__span-38-21"><a id="__codelineno-38-21" name="__codelineno-38-21" href="#__codelineno-38-21"></a><span class="n">classifier</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">ClassifierRobot</span><span class="o">.</span><span class="n">new</span><span class="p">(</span>
+</span><span id="__span-38-22"><a id="__codelineno-38-22" name="__codelineno-38-22" href="#__codelineno-38-22"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;classifier&quot;</span><span class="p">,</span>
+</span><span id="__span-38-23"><a id="__codelineno-38-23" name="__codelineno-38-23" href="#__codelineno-38-23"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="o">&lt;&lt;~</span><span class="dl">PROMPT</span>
+</span><span id="__span-38-24"><a id="__codelineno-38-24" name="__codelineno-38-24" href="#__codelineno-38-24"></a><span class="sh">    Classify the user&#39;s message into exactly one category:</span>
+</span><span id="__span-38-25"><a id="__codelineno-38-25" name="__codelineno-38-25" href="#__codelineno-38-25"></a><span class="sh">    - billing</span>
+</span><span id="__span-38-26"><a id="__codelineno-38-26" name="__codelineno-38-26" href="#__codelineno-38-26"></a><span class="sh">    - technical</span>
+</span><span id="__span-38-27"><a id="__codelineno-38-27" name="__codelineno-38-27" href="#__codelineno-38-27"></a><span class="sh">    - general</span>
+</span><span id="__span-38-28"><a id="__codelineno-38-28" name="__codelineno-38-28" href="#__codelineno-38-28"></a><span class="sh">    Respond with only the category name, nothing else.</span>
+</span><span id="__span-38-29"><a id="__codelineno-38-29" name="__codelineno-38-29" href="#__codelineno-38-29"></a><span class="dl">  PROMPT</span>
+</span><span id="__span-38-30"><a id="__codelineno-38-30" name="__codelineno-38-30" href="#__codelineno-38-30"></a><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="specialist-robot">Specialist Robot<a class="headerlink" href="#specialist-robot" title="Permanent link">&para;</a></h3>
+<p>Handle specific domains with template and tools:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-39-1"><a id="__codelineno-39-1" name="__codelineno-39-1" href="#__codelineno-39-1"></a><span class="n">billing_specialist</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-39-2"><a id="__codelineno-39-2" name="__codelineno-39-2" href="#__codelineno-39-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;billing_specialist&quot;</span><span class="p">,</span>
+</span><span id="__span-39-3"><a id="__codelineno-39-3" name="__codelineno-39-3" href="#__codelineno-39-3"></a><span class="w">  </span><span class="ss">description</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Handles billing and payment inquiries&quot;</span><span class="p">,</span>
+</span><span id="__span-39-4"><a id="__codelineno-39-4" name="__codelineno-39-4" href="#__codelineno-39-4"></a><span class="w">  </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:billing</span><span class="p">,</span>
+</span><span id="__span-39-5"><a id="__codelineno-39-5" name="__codelineno-39-5" href="#__codelineno-39-5"></a><span class="w">  </span><span class="ss">context</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">department</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;billing&quot;</span><span class="w"> </span><span class="p">},</span>
+</span><span id="__span-39-6"><a id="__codelineno-39-6" name="__codelineno-39-6" href="#__codelineno-39-6"></a><span class="w">  </span><span class="ss">local_tools</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="no">InvoiceLookup</span><span class="p">,</span><span class="w"> </span><span class="no">RefundProcessor</span><span class="o">]</span>
+</span><span id="__span-39-7"><a id="__codelineno-39-7" name="__codelineno-39-7" href="#__codelineno-39-7"></a><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="summarizer-robot">Summarizer Robot<a class="headerlink" href="#summarizer-robot" title="Permanent link">&para;</a></h3>
+<p>Condense information:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-40-1"><a id="__codelineno-40-1" name="__codelineno-40-1" href="#__codelineno-40-1"></a><span class="n">summarizer</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-40-2"><a id="__codelineno-40-2" name="__codelineno-40-2" href="#__codelineno-40-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;summarizer&quot;</span><span class="p">,</span>
+</span><span id="__span-40-3"><a id="__codelineno-40-3" name="__codelineno-40-3" href="#__codelineno-40-3"></a><span class="w">  </span><span class="ss">description</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Summarizes conversations and documents&quot;</span><span class="p">,</span>
+</span><span id="__span-40-4"><a id="__codelineno-40-4" name="__codelineno-40-4" href="#__codelineno-40-4"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="o">&lt;&lt;~</span><span class="dl">PROMPT</span>
+</span><span id="__span-40-5"><a id="__codelineno-40-5" name="__codelineno-40-5" href="#__codelineno-40-5"></a><span class="sh">    Create concise summaries of the provided content.</span>
+</span><span id="__span-40-6"><a id="__codelineno-40-6" name="__codelineno-40-6" href="#__codelineno-40-6"></a><span class="sh">    Focus on key points and actionable items.</span>
+</span><span id="__span-40-7"><a id="__codelineno-40-7" name="__codelineno-40-7" href="#__codelineno-40-7"></a><span class="sh">    Use bullet points for clarity.</span>
+</span><span id="__span-40-8"><a id="__codelineno-40-8" name="__codelineno-40-8" href="#__codelineno-40-8"></a><span class="dl">  PROMPT</span>
+</span><span id="__span-40-9"><a id="__codelineno-40-9" name="__codelineno-40-9" href="#__codelineno-40-9"></a><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="bus-connected-robot">Bus-Connected Robot<a class="headerlink" href="#bus-connected-robot" title="Permanent link">&para;</a></h3>
+<p>Enable bidirectional communication between robots using a message bus. This pattern supports negotiation loops and convergence:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-41-1"><a id="__codelineno-41-1" name="__codelineno-41-1" href="#__codelineno-41-1"></a><span class="n">bus</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">TypedBus</span><span class="o">::</span><span class="no">MessageBus</span><span class="o">.</span><span class="n">new</span>
+</span><span id="__span-41-2"><a id="__codelineno-41-2" name="__codelineno-41-2" href="#__codelineno-41-2"></a>
+</span><span id="__span-41-3"><a id="__codelineno-41-3" name="__codelineno-41-3" href="#__codelineno-41-3"></a><span class="k">class</span><span class="w"> </span><span class="nc">Comedian</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">::</span><span class="no">Robot</span>
+</span><span id="__span-41-4"><a id="__codelineno-41-4" name="__codelineno-41-4" href="#__codelineno-41-4"></a><span class="w">  </span><span class="k">def</span><span class="w"> </span><span class="nf">initialize</span><span class="p">(</span><span class="ss">bus</span><span class="p">:)</span>
+</span><span id="__span-41-5"><a id="__codelineno-41-5" name="__codelineno-41-5" href="#__codelineno-41-5"></a><span class="w">    </span><span class="k">super</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;bob&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:comedian</span><span class="p">,</span><span class="w"> </span><span class="ss">bus</span><span class="p">:</span><span class="w"> </span><span class="n">bus</span><span class="p">)</span>
+</span><span id="__span-41-6"><a id="__codelineno-41-6" name="__codelineno-41-6" href="#__codelineno-41-6"></a><span class="w">    </span><span class="n">on_message</span><span class="w"> </span><span class="k">do</span><span class="w"> </span><span class="o">|</span><span class="n">message</span><span class="o">|</span>
+</span><span id="__span-41-7"><a id="__codelineno-41-7" name="__codelineno-41-7" href="#__codelineno-41-7"></a><span class="w">      </span><span class="n">joke</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">run</span><span class="p">(</span><span class="n">message</span><span class="o">.</span><span class="n">content</span><span class="o">.</span><span class="n">to_s</span><span class="p">)</span><span class="o">.</span><span class="n">last_text_content</span><span class="o">.</span><span class="n">strip</span>
+</span><span id="__span-41-8"><a id="__codelineno-41-8" name="__codelineno-41-8" href="#__codelineno-41-8"></a><span class="w">      </span><span class="n">send_reply</span><span class="p">(</span><span class="ss">to</span><span class="p">:</span><span class="w"> </span><span class="n">message</span><span class="o">.</span><span class="n">from</span><span class="o">.</span><span class="n">to_sym</span><span class="p">,</span><span class="w"> </span><span class="ss">content</span><span class="p">:</span><span class="w"> </span><span class="n">joke</span><span class="p">,</span><span class="w"> </span><span class="ss">in_reply_to</span><span class="p">:</span><span class="w"> </span><span class="n">message</span><span class="o">.</span><span class="n">key</span><span class="p">)</span>
+</span><span id="__span-41-9"><a id="__codelineno-41-9" name="__codelineno-41-9" href="#__codelineno-41-9"></a><span class="w">    </span><span class="k">end</span>
+</span><span id="__span-41-10"><a id="__codelineno-41-10" name="__codelineno-41-10" href="#__codelineno-41-10"></a><span class="w">  </span><span class="k">end</span>
+</span><span id="__span-41-11"><a id="__codelineno-41-11" name="__codelineno-41-11" href="#__codelineno-41-11"></a><span class="k">end</span>
+</span><span id="__span-41-12"><a id="__codelineno-41-12" name="__codelineno-41-12" href="#__codelineno-41-12"></a>
+</span><span id="__span-41-13"><a id="__codelineno-41-13" name="__codelineno-41-13" href="#__codelineno-41-13"></a><span class="k">class</span><span class="w"> </span><span class="nc">ComedyCritic</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">::</span><span class="no">Robot</span>
+</span><span id="__span-41-14"><a id="__codelineno-41-14" name="__codelineno-41-14" href="#__codelineno-41-14"></a><span class="w">  </span><span class="k">def</span><span class="w"> </span><span class="nf">initialize</span><span class="p">(</span><span class="ss">bus</span><span class="p">:)</span>
+</span><span id="__span-41-15"><a id="__codelineno-41-15" name="__codelineno-41-15" href="#__codelineno-41-15"></a><span class="w">    </span><span class="k">super</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;alice&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:comedy_critic</span><span class="p">,</span><span class="w"> </span><span class="ss">bus</span><span class="p">:</span><span class="w"> </span><span class="n">bus</span><span class="p">)</span>
+</span><span id="__span-41-16"><a id="__codelineno-41-16" name="__codelineno-41-16" href="#__codelineno-41-16"></a><span class="w">    </span><span class="vi">@accepted</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kp">false</span>
+</span><span id="__span-41-17"><a id="__codelineno-41-17" name="__codelineno-41-17" href="#__codelineno-41-17"></a><span class="w">    </span><span class="n">on_message</span><span class="w"> </span><span class="k">do</span><span class="w"> </span><span class="o">|</span><span class="n">message</span><span class="o">|</span>
+</span><span id="__span-41-18"><a id="__codelineno-41-18" name="__codelineno-41-18" href="#__codelineno-41-18"></a><span class="w">      </span><span class="n">verdict</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;Evaluate: </span><span class="si">#{</span><span class="n">message</span><span class="o">.</span><span class="n">content</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">last_text_content</span><span class="o">.</span><span class="n">strip</span>
+</span><span id="__span-41-19"><a id="__codelineno-41-19" name="__codelineno-41-19" href="#__codelineno-41-19"></a><span class="w">      </span><span class="vi">@accepted</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">verdict</span><span class="o">.</span><span class="n">start_with?</span><span class="p">(</span><span class="s2">&quot;FUNNY&quot;</span><span class="p">)</span>
+</span><span id="__span-41-20"><a id="__codelineno-41-20" name="__codelineno-41-20" href="#__codelineno-41-20"></a><span class="w">      </span><span class="n">send_message</span><span class="p">(</span><span class="ss">to</span><span class="p">:</span><span class="w"> </span><span class="ss">:bob</span><span class="p">,</span><span class="w"> </span><span class="ss">content</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Try again.&quot;</span><span class="p">)</span><span class="w"> </span><span class="k">unless</span><span class="w"> </span><span class="vi">@accepted</span>
+</span><span id="__span-41-21"><a id="__codelineno-41-21" name="__codelineno-41-21" href="#__codelineno-41-21"></a><span class="w">    </span><span class="k">end</span>
+</span><span id="__span-41-22"><a id="__codelineno-41-22" name="__codelineno-41-22" href="#__codelineno-41-22"></a><span class="w">  </span><span class="k">end</span>
+</span><span id="__span-41-23"><a id="__codelineno-41-23" name="__codelineno-41-23" href="#__codelineno-41-23"></a><span class="w">  </span><span class="kp">attr_reader</span><span class="w"> </span><span class="ss">:accepted</span>
+</span><span id="__span-41-24"><a id="__codelineno-41-24" name="__codelineno-41-24" href="#__codelineno-41-24"></a><span class="k">end</span>
+</span><span id="__span-41-25"><a id="__codelineno-41-25" name="__codelineno-41-25" href="#__codelineno-41-25"></a>
+</span><span id="__span-41-26"><a id="__codelineno-41-26" name="__codelineno-41-26" href="#__codelineno-41-26"></a><span class="n">bob</span><span class="w">   </span><span class="o">=</span><span class="w"> </span><span class="no">Comedian</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="ss">bus</span><span class="p">:</span><span class="w"> </span><span class="n">bus</span><span class="p">)</span>
+</span><span id="__span-41-27"><a id="__codelineno-41-27" name="__codelineno-41-27" href="#__codelineno-41-27"></a><span class="n">alice</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">ComedyCritic</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="ss">bus</span><span class="p">:</span><span class="w"> </span><span class="n">bus</span><span class="p">)</span>
+</span><span id="__span-41-28"><a id="__codelineno-41-28" name="__codelineno-41-28" href="#__codelineno-41-28"></a><span class="n">alice</span><span class="o">.</span><span class="n">send_message</span><span class="p">(</span><span class="ss">to</span><span class="p">:</span><span class="w"> </span><span class="ss">:bob</span><span class="p">,</span><span class="w"> </span><span class="ss">content</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Tell me a funny robot joke.&quot;</span><span class="p">)</span>
+</span></code></pre></div>
+<p>The <code>on_message</code> block arity controls delivery handling:
+- <strong>1 argument</strong> <code>|message|</code> — auto-acknowledges before calling
+- <strong>2 arguments</strong> <code>|delivery, message|</code> — manual <code>delivery.ack!</code> / <code>delivery.nack!</code></p>
+<p>See <a href="../../architecture/core-concepts/#message-bus">Message Bus</a> for details.</p>
+<h3 id="spawning-robots-dynamically">Spawning Robots Dynamically<a class="headerlink" href="#spawning-robots-dynamically" title="Permanent link">&para;</a></h3>
+<p>Create new robots at runtime using <code>spawn</code>. The bus is created lazily — no upfront wiring required:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-42-1"><a id="__codelineno-42-1" name="__codelineno-42-1" href="#__codelineno-42-1"></a><span class="k">class</span><span class="w"> </span><span class="nc">Dispatcher</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">::</span><span class="no">Robot</span>
+</span><span id="__span-42-2"><a id="__codelineno-42-2" name="__codelineno-42-2" href="#__codelineno-42-2"></a><span class="w">  </span><span class="kp">attr_reader</span><span class="w"> </span><span class="ss">:spawned</span>
+</span><span id="__span-42-3"><a id="__codelineno-42-3" name="__codelineno-42-3" href="#__codelineno-42-3"></a>
+</span><span id="__span-42-4"><a id="__codelineno-42-4" name="__codelineno-42-4" href="#__codelineno-42-4"></a><span class="w">  </span><span class="k">def</span><span class="w"> </span><span class="nf">initialize</span><span class="p">(</span><span class="ss">bus</span><span class="p">:</span><span class="w"> </span><span class="kp">nil</span><span class="p">)</span>
+</span><span id="__span-42-5"><a id="__codelineno-42-5" name="__codelineno-42-5" href="#__codelineno-42-5"></a><span class="w">    </span><span class="k">super</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;dispatcher&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:dispatcher</span><span class="p">,</span><span class="w"> </span><span class="ss">bus</span><span class="p">:</span><span class="w"> </span><span class="n">bus</span><span class="p">)</span>
+</span><span id="__span-42-6"><a id="__codelineno-42-6" name="__codelineno-42-6" href="#__codelineno-42-6"></a><span class="w">    </span><span class="vi">@spawned</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{}</span>
+</span><span id="__span-42-7"><a id="__codelineno-42-7" name="__codelineno-42-7" href="#__codelineno-42-7"></a>
+</span><span id="__span-42-8"><a id="__codelineno-42-8" name="__codelineno-42-8" href="#__codelineno-42-8"></a><span class="w">    </span><span class="n">on_message</span><span class="w"> </span><span class="k">do</span><span class="w"> </span><span class="o">|</span><span class="n">message</span><span class="o">|</span>
+</span><span id="__span-42-9"><a id="__codelineno-42-9" name="__codelineno-42-9" href="#__codelineno-42-9"></a><span class="w">      </span><span class="nb">puts</span><span class="w"> </span><span class="s2">&quot;</span><span class="si">#{</span><span class="n">message</span><span class="o">.</span><span class="n">from</span><span class="si">}</span><span class="s2"> replied: </span><span class="si">#{</span><span class="n">message</span><span class="o">.</span><span class="n">content</span><span class="o">.</span><span class="n">to_s</span><span class="o">.</span><span class="n">lines</span><span class="o">.</span><span class="n">first</span><span class="o">&amp;.</span><span class="n">strip</span><span class="si">}</span><span class="s2">&quot;</span>
+</span><span id="__span-42-10"><a id="__codelineno-42-10" name="__codelineno-42-10" href="#__codelineno-42-10"></a><span class="w">    </span><span class="k">end</span>
+</span><span id="__span-42-11"><a id="__codelineno-42-11" name="__codelineno-42-11" href="#__codelineno-42-11"></a><span class="w">  </span><span class="k">end</span>
+</span><span id="__span-42-12"><a id="__codelineno-42-12" name="__codelineno-42-12" href="#__codelineno-42-12"></a>
+</span><span id="__span-42-13"><a id="__codelineno-42-13" name="__codelineno-42-13" href="#__codelineno-42-13"></a><span class="w">  </span><span class="k">def</span><span class="w"> </span><span class="nf">dispatch</span><span class="p">(</span><span class="n">question</span><span class="p">)</span>
+</span><span id="__span-42-14"><a id="__codelineno-42-14" name="__codelineno-42-14" href="#__codelineno-42-14"></a><span class="w">    </span><span class="c1"># Ask LLM what specialist to create</span>
+</span><span id="__span-42-15"><a id="__codelineno-42-15" name="__codelineno-42-15" href="#__codelineno-42-15"></a><span class="w">    </span><span class="n">plan</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">run</span><span class="p">(</span><span class="n">question</span><span class="p">)</span><span class="o">.</span><span class="n">last_text_content</span><span class="o">.</span><span class="n">strip</span>
+</span><span id="__span-42-16"><a id="__codelineno-42-16" name="__codelineno-42-16" href="#__codelineno-42-16"></a><span class="w">    </span><span class="n">role</span><span class="p">,</span><span class="w"> </span><span class="n">instruction</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">plan</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">)</span>
+</span><span id="__span-42-17"><a id="__codelineno-42-17" name="__codelineno-42-17" href="#__codelineno-42-17"></a><span class="w">    </span><span class="n">role</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">role</span><span class="o">.</span><span class="n">strip</span><span class="o">.</span><span class="n">downcase</span><span class="o">.</span><span class="n">gsub</span><span class="p">(</span><span class="sr">/\s+/</span><span class="p">,</span><span class="w"> </span><span class="s2">&quot;_&quot;</span><span class="p">)</span>
+</span><span id="__span-42-18"><a id="__codelineno-42-18" name="__codelineno-42-18" href="#__codelineno-42-18"></a>
+</span><span id="__span-42-19"><a id="__codelineno-42-19" name="__codelineno-42-19" href="#__codelineno-42-19"></a><span class="w">    </span><span class="c1"># Spawn (or reuse) a specialist</span>
+</span><span id="__span-42-20"><a id="__codelineno-42-20" name="__codelineno-42-20" href="#__codelineno-42-20"></a><span class="w">    </span><span class="n">specialist</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="vi">@spawned</span><span class="o">[</span><span class="n">role</span><span class="o">]</span><span class="w"> </span><span class="o">||=</span><span class="w"> </span><span class="n">spawn</span><span class="p">(</span>
+</span><span id="__span-42-21"><a id="__codelineno-42-21" name="__codelineno-42-21" href="#__codelineno-42-21"></a><span class="w">      </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="n">role</span><span class="p">,</span>
+</span><span id="__span-42-22"><a id="__codelineno-42-22" name="__codelineno-42-22" href="#__codelineno-42-22"></a><span class="w">      </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="n">instruction</span><span class="o">&amp;.</span><span class="n">strip</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="s2">&quot;You are a helpful </span><span class="si">#{</span><span class="n">role</span><span class="si">}</span><span class="s2">.&quot;</span>
+</span><span id="__span-42-23"><a id="__codelineno-42-23" name="__codelineno-42-23" href="#__codelineno-42-23"></a><span class="w">    </span><span class="p">)</span>
+</span><span id="__span-42-24"><a id="__codelineno-42-24" name="__codelineno-42-24" href="#__codelineno-42-24"></a>
+</span><span id="__span-42-25"><a id="__codelineno-42-25" name="__codelineno-42-25" href="#__codelineno-42-25"></a><span class="w">    </span><span class="c1"># Have the specialist answer and reply</span>
+</span><span id="__span-42-26"><a id="__codelineno-42-26" name="__codelineno-42-26" href="#__codelineno-42-26"></a><span class="w">    </span><span class="n">answer</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">specialist</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">question</span><span class="p">)</span><span class="o">.</span><span class="n">last_text_content</span><span class="o">.</span><span class="n">strip</span>
+</span><span id="__span-42-27"><a id="__codelineno-42-27" name="__codelineno-42-27" href="#__codelineno-42-27"></a><span class="w">    </span><span class="n">specialist</span><span class="o">.</span><span class="n">send_message</span><span class="p">(</span><span class="ss">to</span><span class="p">:</span><span class="w"> </span><span class="ss">:dispatcher</span><span class="p">,</span><span class="w"> </span><span class="ss">content</span><span class="p">:</span><span class="w"> </span><span class="n">answer</span><span class="p">)</span>
+</span><span id="__span-42-28"><a id="__codelineno-42-28" name="__codelineno-42-28" href="#__codelineno-42-28"></a><span class="w">  </span><span class="k">end</span>
+</span><span id="__span-42-29"><a id="__codelineno-42-29" name="__codelineno-42-29" href="#__codelineno-42-29"></a><span class="k">end</span>
+</span></code></pre></div>
+<p>Key features of <code>spawn</code>:</p>
+<ul>
+<li>Creates a child robot on the same bus as the parent</li>
+<li>Creates a bus lazily if the parent doesn't have one</li>
+<li>Spawned robots can immediately send and receive messages</li>
+<li>Multiple robots with the same name enable fan-out messaging</li>
+</ul>
+<p>Robots can also join a bus after creation:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-43-1"><a id="__codelineno-43-1" name="__codelineno-43-1" href="#__codelineno-43-1"></a><span class="n">bot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;latecomer&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Hello.&quot;</span><span class="p">)</span>
+</span><span id="__span-43-2"><a id="__codelineno-43-2" name="__codelineno-43-2" href="#__codelineno-43-2"></a><span class="n">bot</span><span class="o">.</span><span class="n">with_bus</span><span class="p">(</span><span class="n">existing_bus</span><span class="p">)</span><span class="w">  </span><span class="c1"># now connected and can send/receive messages</span>
+</span></code></pre></div>
+<h2 id="configuration">Configuration<a class="headerlink" href="#configuration" title="Permanent link">&para;</a></h2>
+<p>RobotLab uses <code>MywayConfig</code> for configuration. Access the config object directly -- there is no <code>RobotLab.configure</code> block:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-44-1"><a id="__codelineno-44-1" name="__codelineno-44-1" href="#__codelineno-44-1"></a><span class="no">RobotLab</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">ruby_llm</span><span class="o">.</span><span class="n">model</span><span class="w">           </span><span class="c1"># =&gt; &quot;claude-sonnet-4&quot;</span>
+</span><span id="__span-44-2"><a id="__codelineno-44-2" name="__codelineno-44-2" href="#__codelineno-44-2"></a><span class="no">RobotLab</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">ruby_llm</span><span class="o">.</span><span class="n">request_timeout</span><span class="w">  </span><span class="c1"># =&gt; 120</span>
+</span></code></pre></div>
+<p>Configuration is loaded from:</p>
+<ul>
+<li>Bundled defaults (<code>lib/robot_lab/config/defaults.yml</code>)</li>
+<li>Environment-specific overrides (development, test, production)</li>
+<li>XDG config files (<code>~/.config/robot_lab/config.yml</code>)</li>
+<li>Project config (<code>./config/robot_lab.yml</code>)</li>
+<li>Environment variables (<code>ROBOT_LAB_*</code> prefix)</li>
+</ul>
+<h2 id="best-practices">Best Practices<a class="headerlink" href="#best-practices" title="Permanent link">&para;</a></h2>
+<h3 id="1-clear-focused-prompts">1. Clear, Focused Prompts<a class="headerlink" href="#1-clear-focused-prompts" title="Permanent link">&para;</a></h3>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-45-1"><a id="__codelineno-45-1" name="__codelineno-45-1" href="#__codelineno-45-1"></a><span class="c1"># Good: Specific and focused</span>
+</span><span id="__span-45-2"><a id="__codelineno-45-2" name="__codelineno-45-2" href="#__codelineno-45-2"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-45-3"><a id="__codelineno-45-3" name="__codelineno-45-3" href="#__codelineno-45-3"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;reviewer&quot;</span><span class="p">,</span>
+</span><span id="__span-45-4"><a id="__codelineno-45-4" name="__codelineno-45-4" href="#__codelineno-45-4"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="o">&lt;&lt;~</span><span class="dl">PROMPT</span>
+</span><span id="__span-45-5"><a id="__codelineno-45-5" name="__codelineno-45-5" href="#__codelineno-45-5"></a><span class="sh">    You are a code reviewer. Review code for:</span>
+</span><span id="__span-45-6"><a id="__codelineno-45-6" name="__codelineno-45-6" href="#__codelineno-45-6"></a><span class="sh">    - Security vulnerabilities</span>
+</span><span id="__span-45-7"><a id="__codelineno-45-7" name="__codelineno-45-7" href="#__codelineno-45-7"></a><span class="sh">    - Performance issues</span>
+</span><span id="__span-45-8"><a id="__codelineno-45-8" name="__codelineno-45-8" href="#__codelineno-45-8"></a><span class="sh">    - Best practice violations</span>
+</span><span id="__span-45-9"><a id="__codelineno-45-9" name="__codelineno-45-9" href="#__codelineno-45-9"></a>
+</span><span id="__span-45-10"><a id="__codelineno-45-10" name="__codelineno-45-10" href="#__codelineno-45-10"></a><span class="sh">    Provide specific line numbers and suggestions.</span>
+</span><span id="__span-45-11"><a id="__codelineno-45-11" name="__codelineno-45-11" href="#__codelineno-45-11"></a><span class="dl">  PROMPT</span>
+</span><span id="__span-45-12"><a id="__codelineno-45-12" name="__codelineno-45-12" href="#__codelineno-45-12"></a><span class="p">)</span>
+</span><span id="__span-45-13"><a id="__codelineno-45-13" name="__codelineno-45-13" href="#__codelineno-45-13"></a>
+</span><span id="__span-45-14"><a id="__codelineno-45-14" name="__codelineno-45-14" href="#__codelineno-45-14"></a><span class="c1"># Bad: Vague and unfocused</span>
+</span><span id="__span-45-15"><a id="__codelineno-45-15" name="__codelineno-45-15" href="#__codelineno-45-15"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-45-16"><a id="__codelineno-45-16" name="__codelineno-45-16" href="#__codelineno-45-16"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;reviewer&quot;</span><span class="p">,</span>
+</span><span id="__span-45-17"><a id="__codelineno-45-17" name="__codelineno-45-17" href="#__codelineno-45-17"></a><span class="w">  </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You help with code stuff.&quot;</span>
+</span><span id="__span-45-18"><a id="__codelineno-45-18" name="__codelineno-45-18" href="#__codelineno-45-18"></a><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="2-compose-behaviors-with-skills">2. Compose Behaviors with Skills<a class="headerlink" href="#2-compose-behaviors-with-skills" title="Permanent link">&para;</a></h3>
+<p>Instead of creating monolithic templates, break behaviors into composable skills:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-46-1"><a id="__codelineno-46-1" name="__codelineno-46-1" href="#__codelineno-46-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-46-2"><a id="__codelineno-46-2" name="__codelineno-46-2" href="#__codelineno-46-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;support&quot;</span><span class="p">,</span>
+</span><span id="__span-46-3"><a id="__codelineno-46-3" name="__codelineno-46-3" href="#__codelineno-46-3"></a><span class="w">  </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:support</span><span class="p">,</span>
+</span><span id="__span-46-4"><a id="__codelineno-46-4" name="__codelineno-46-4" href="#__codelineno-46-4"></a><span class="w">  </span><span class="ss">skills</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="ss">:clarifier</span><span class="p">,</span><span class="w"> </span><span class="ss">:safety</span><span class="p">,</span><span class="w"> </span><span class="ss">:json_responder</span><span class="o">]</span>
+</span><span id="__span-46-5"><a id="__codelineno-46-5" name="__codelineno-46-5" href="#__codelineno-46-5"></a><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="3-use-templates-for-reusable-prompts">3. Use Templates for Reusable Prompts<a class="headerlink" href="#3-use-templates-for-reusable-prompts" title="Permanent link">&para;</a></h3>
+<p>Templates keep prompts in version-controlled files and allow parameterization:</p>
+<div class="language-ruby highlight"><pre><span></span><code><span id="__span-47-1"><a id="__codelineno-47-1" name="__codelineno-47-1" href="#__codelineno-47-1"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
+</span><span id="__span-47-2"><a id="__codelineno-47-2" name="__codelineno-47-2" href="#__codelineno-47-2"></a><span class="w">  </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;support&quot;</span><span class="p">,</span>
+</span><span id="__span-47-3"><a id="__codelineno-47-3" name="__codelineno-47-3" href="#__codelineno-47-3"></a><span class="w">  </span><span class="ss">template</span><span class="p">:</span><span class="w"> </span><span class="ss">:support</span><span class="p">,</span>
+</span><span id="__span-47-4"><a id="__codelineno-47-4" name="__codelineno-47-4" href="#__codelineno-47-4"></a><span class="w">  </span><span class="ss">context</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">company</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;TechCo&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">language</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;English&quot;</span><span class="w"> </span><span class="p">}</span>
+</span><span id="__span-47-5"><a id="__codelineno-47-5" name="__codelineno-47-5" href="#__codelineno-47-5"></a><span class="p">)</span>
+</span></code></pre></div>
+<h3 id="4-handle-tool-errors-gracefully">4. Handle Tool Errors Gracefully<a class="headerlink" href="#4-handle-tool-errors-gracefully" title="Permanent link">&para;</a></h3>
+<p><code>RobotLab::Tool</code> automatically catches exceptions and returns plain-text errors to the LLM. For domain-specific error handling, catch known exceptions in <code>execute</code> and return structured data. See <a href="../using-tools/#error-handling">Using Tools: Error Handling</a> for details.</p>
+<h2 id="next-steps">Next Steps<a class="headerlink" href="#next-steps" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="../creating-networks/">Creating Networks</a> - Orchestrate multiple robots</li>
+<li><a href="../../architecture/core-concepts/#message-bus">Message Bus</a> - Bidirectional robot communication</li>
+<li><a href="../../architecture/core-concepts/#dynamic-spawning">Dynamic Spawning</a> - Robots creating robots at runtime</li>
+<li><a href="../using-tools/">Using Tools</a> - Advanced tool patterns</li>
+<li><a href="../memory/">Memory Guide</a> - Share data between runs and robots</li>
+<li><a href="../../api/core/robot/">API Reference: Robot</a> - Complete API documentation</li>
+</ul>
+  <form class="md-feedback" name="feedback" hidden>
+    <fieldset>
+      <legend class="md-feedback__title">
+        Was this page helpful?
+      </legend>
+      <div class="md-feedback__inner">
+        <div class="md-feedback__list">
+            <button class="md-feedback__icon md-icon" type="submit" title="This page was helpful" data-md-value="1">
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 12a8 8 0 0 0-8-8 8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8m2 0a10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2a10 10 0 0 1 10 10M10 9.5c0 .8-.7 1.5-1.5 1.5S7 10.3 7 9.5 7.7 8 8.5 8s1.5.7 1.5 1.5m7 0c0 .8-.7 1.5-1.5 1.5S14 10.3 14 9.5 14.7 8 15.5 8s1.5.7 1.5 1.5m-5 7.73c-1.75 0-3.29-.73-4.19-1.81L9.23 14c.45.72 1.52 1.23 2.77 1.23s2.32-.51 2.77-1.23l1.42 1.42c-.9 1.08-2.44 1.81-4.19 1.81"/></svg>
+            </button>
+            <button class="md-feedback__icon md-icon" type="submit" title="This page could be improved" data-md-value="0">
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 12a8 8 0 0 0-8-8 8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8m2 0a10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2a10 10 0 0 1 10 10m-6.5-4c.8 0 1.5.7 1.5 1.5s-.7 1.5-1.5 1.5-1.5-.7-1.5-1.5.7-1.5 1.5-1.5M10 9.5c0 .8-.7 1.5-1.5 1.5S7 10.3 7 9.5 7.7 8 8.5 8s1.5.7 1.5 1.5m2 4.5c1.75 0 3.29.72 4.19 1.81l-1.42 1.42C14.32 16.5 13.25 16 12 16s-2.32.5-2.77 1.23l-1.42-1.42C8.71 14.72 10.25 14 12 14"/></svg>
+            </button>
+        </div>
+        <div class="md-feedback__note">
+            <div data-md-value="1" hidden>
+              Thanks for your feedback!
+            </div>
+            <div data-md-value="0" hidden>
+              Thanks for your feedback! Help us improve by creating an issue.
+            </div>
+        </div>
+      </div>
+    </fieldset>
+  </form>
+              </article>
+            </div>
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
+        </div>
+          <button type="button" class="md-top md-icon" data-md-component="top" hidden>
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
+  Back to top
+</button>
+      </main>
+        <footer class="md-footer">
+      <nav class="md-footer__inner md-grid" aria-label="Footer" >
+          <a href="../" class="md-footer__link md-footer__link--prev" aria-label="Previous: Guides">
+            <div class="md-footer__button md-icon">
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
+            </div>
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Previous
+              </span>
+              <div class="md-ellipsis">
+                Guides
+              </div>
+            </div>
+          </a>
+          <a href="../creating-networks/" class="md-footer__link md-footer__link--next" aria-label="Next: Creating Networks">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                Next
+              </span>
+              <div class="md-ellipsis">
+                Creating Networks
+              </div>
+            </div>
+            <div class="md-footer__button md-icon">
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11z"/></svg>
+            </div>
+          </a>
+      </nav>
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-copyright">
+    <div class="md-copyright__highlight">
+      Copyright &copy; 2025 Dewayne VanHoozer
+    </div>
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+</div>
+<div class="md-social">
+    <a href="https://github.com/madbomber/robot_lab" target="_blank" rel="noopener" title="RobotLab on GitHub" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
+    </a>
+    <a href="https://rubygems.org/gems/robot_lab" target="_blank" rel="noopener" title="RobotLab on RubyGems" class="md-social__link">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M116.7 33.8c4.5-6.1 11.7-9.8 19.3-9.8h240c7.6 0 14.8 3.6 19.3 9.8l112 152c6.8 9.2 6.1 21.9-1.5 30.4l-232 256c-4.5 5-11 7.9-17.8 7.9s-13.2-2.9-17.8-7.9l-232-256c-7.7-8.5-8.3-21.2-1.5-30.4zm38.5 39.8c-3.3 2.5-4.2 7-2.1 10.5l57.4 95.7L63.3 192c-4.1.3-7.3 3.8-7.3 8s3.2 7.6 7.3 8l192 16h1.3l192-16c4.1-.3 7.3-3.8 7.3-8s-3.2-7.6-7.3-8l-147.2-12.3 57.4-95.6c2.1-3.5 1.2-8.1-2.1-10.5s-7.9-2-10.7 1l-90 97.6-90.1-97.6c-2.8-3-7.4-3.4-10.7-1"/></svg>
+    </a>
+</div>
+    </div>
+  </div>
+</footer>
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+      <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.instant", "navigation.tracking", "navigation.tabs", "navigation.tabs.sticky", "navigation.path", "navigation.indexes", "navigation.top", "navigation.footer", "toc.follow", "search.suggest", "search.highlight", "search.share", "header.autohide", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.tooltips", "content.action.edit", "content.action.view"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
+  </body>
+</html>