Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Die Annotations deklarieren bereits readOnlyHint=true, openWorldHint=false und destructiveHint=false, sodass das Sicherheitsprofil geklärt ist. Die Beschreibung ergänzt wertvollen Kontext darüber, welche Ereignisarten erfasst werden und welche Quellen (web/claude/beamer) möglich sind – das geht über die Annotationen hinaus. Es fehlen Angaben dazu, wie weit der Verlauf zurückreicht oder ob er begrenzt ist.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

Ein einzelner, front-geladener Satz, der die relevanten Informationen (Umfang, Ereignistypen, Rückgabefelder) kompakt bündelt. Die Klammerliste macht den Satz dicht, aber jeder Bestandteil trägt Information bei.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Für ein einfaches Lese-Tool ohne Output-Schema erklärt die Beschreibung die zurückgegebenen Felder (ID, Zeit, Quelle) und den erfassten Ereignisumfang. Lediglich Details zum `limit`-Parameter und zur zeitlichen Reichweite des Verlaufs fehlen, was den Kontext geringfügig unvollständig lässt.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Die Schema-Beschreibungsabdeckung liegt bei 100 %, da der einzige Parameter `limit` im Schema dokumentiert ist ("Standard 20"). Die Beschreibung erwähnt den Parameter überhaupt nicht und fügt damit keine Semantik über das Schema hinaus hinzu – Baseline 3 ist angemessen.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

Es wird ein klares Verb (auflisten) mit dem Ressourcenumfang (letzte kritische Änderungen) und den erfassten Ereignistypen genannt. Die Abgrenzung zu `undo_change` als naheliegendem Geschwister-Tool fehlt jedoch, und die Zuordnung zu den übrigen `list_*`-Tools bleibt implizit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

Der Verwendungszweck (Einsicht in die letzten kritischen Änderungen) wird durch die Aufzählung der Ereignistypen impliziert. Es fehlt jedoch jede explizite Aussage, wann dieses Tool gegenüber `undo_change` oder anderen Verlaufs-/Listen-Tools zu wählen ist, sowie Hinweise auf Ausschlüsse oder Voraussetzungen.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.