docs: decision record for tool result payloads and excerpts #30

Merged
jknapp merged 1 commits from docs/tool-results-and-excerpts into main 2026-11-14 19:25:20 +00:00
1 Commits
Author SHA1 Message Date
shadowdaoandClaude Opus 5.5 c4f5231be9 docs: decision record for tool result payloads and excerpts
Adds docs/tool-result-payloads.md covering PRs #27-#29: why every tool
result repeats its payload as JSON text (claude.ai ignores
structuredContent; client detection and structured-only were rejected),
why memory_list / memory_search return excerpts (named to avoid the
snippet.* tools), and why excerpts weight rare query terms rather than
using ts_headline (tested; it picked the same wrong passage).

Links it from the README design notes, adds two troubleshooting entries,
and marks the "same 9 fields as list/search" claims in the earlier
decision record and in memory.get's comment as superseded.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-14 11:24:14 -08:00