Skip to content

History / Best Practices

Revisions

  • 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

    @fareporterjenkins fareporterjenkins committed May 4, 2026
    b4b4832

  • 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).

    @fareporterjenkins fareporterjenkins committed May 4, 2026
    7177959

  • 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>

    @fareporterjenkins fareporterjenkins committed Mar 28, 2026
    ce838a0