docs: migrate examples to typed Tool<*, *> refs (#1015-#1017)
Lead all skill-allowlist examples with the typed `tools(handle)` form.
String-name `tools("...")` remains documented for built-in tools and
runtime-discovered MCP tools, with inline comments calling out why.
New "Typed tool refs" section in Skills-and-Knowledge.md (or new page,
your call) cross-linked from Best-Practices.md and Cookbook.md.
Tracks: agents-kt-11 #1017
docs: Swarm — new wiki page covering multi-agent JAR composition
- New Swarm.md with the mechanism explained end-to-end:
ServiceLoader discovery, AgentProvider SPI, the three-step absorb
implementation (validation → wrap-as-tool → register + auto-enable),
runtime delegation diagram showing two-layer LLM dispatch, properties
preserved (personality, independence, two-layer observability,
no-type-erasure-trickery, single-JVM), multi-captain setups, and
documented constraints (String input only, single tool per sibling,
no cross-JAR static typing, no process isolation).
- _Sidebar.md adds the Swarm link under "LLM Integration".
- Agent-Deployment-Modes.md cross-references Swarm at the end of its
tradeoffs section as the natural multi-agent extension.
- API-Quick-Reference.md adds a Swarm section with the four
symbols (AgentProvider, Swarm.discover, Swarm.discover(loader),
Agent.absorb) in the same table format used elsewhere.
Refs: #984.
docs: loadResource(path) — canonical pattern for prompts from classpath
- Best-Practices.md: new "DO: Load Long Prompts from Resources" section
with the agent { prompt(loadResource("prompts/coder.md")) } pattern,
rationale (editor support, no string-escape gymnastics, fail-fast),
loadResourceOrNull for the optional case, leading-slash normalization,
cross-link to Skills-and-Knowledge.
- Skills-and-Knowledge.md: new "Loading prompts and knowledge from
classpath resources" subsection inside Knowledge Entries showing
the same pattern applied to knowledge() lambdas + the optional case.
- API-Quick-Reference.md: new "Resource Loading" entry between
MemoryBank and Error Recovery DSL — table of the two functions
with their fail-fast / null-return contracts.
Refs: #980 (PR #29 in repo).
Initial wiki: 29 educational articles
Getting Started, Core Concepts, Composition Operators,
LLM Integration, Guided Generation, Agent Memory,
and Reference articles with full code examples.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>