This is a teaching repository with 22 tools spread across multiple lesson files. Most tools have minimal descriptions (10-30 chars), no parameter descriptions, and no documented output schemas. Many tools are duplicated (add appears 10+ times). Parameter types are present but descriptions are null. No error handling guidance, no security considerations, and no composition patterns. This is educational material, not production-grade tooling.

• Add 50-200 character descriptions to every tool explaining WHAT it does, WHEN to use it, and WHAT it returns. Current descriptions are 10-40 chars and lack context.
• Add descriptions to every parameter. Replace null with text like 'The dividend (numerator) as a float' for divide(a, b). Rubric requires 100% of A+ tools to have param descriptions.
• Document output schemas for all tools. E.g., 'Returns: dict[int, str] mapping note_id to note text' for list_notes(). LLMs need to know response structure.
• Consolidate duplicate 'add' tools into a single canonical definition. Duplication violates composition patterns and confuses LLM tool selection.
• Add error handling guidance to tools that can fail. E.g., divide() should return 'Cannot divide by zero. Use a non-zero divisor.' instead of raw ValueError.

Inferred effective spec: 2026-07-28+.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry