Educational repository containing labs and exams for learning agentic engineering patterns, agent loops, tool definitions, and multi-agent systems. Not an MCP server.
This is an educational worksheet, not a production MCP server. Tool definitions are present with schemas and descriptions, but lack depth. All 6 tools have basic descriptions (10-100 chars, below the 194-char baseline) and minimal parameter documentation. No error handling guidance, no output schema documentation, and no security considerations. Tools are read-only (low risk) but descriptions are terse and lack context for when/why to use them. Naming is verb-first (good), but parameter descriptions are sparse. No evidence of pagination, batching, or composition patterns.
Return the number of lines in `path`.
Return how many steps one runbook has. Call this when only the length matters, not the content.
Return the paths under `prefix`, one per line, sorted.
List every available runbook name, one per line. Call this first when you do not know which runbook applies.
Return the full content of `path`.
Return the full numbered steps of one runbook. Call this before answering any question about a procedure; use list_runbooks first if you do not know the exact name.
Descriptions are below baseline (avg 40 chars vs 194-char baseline). 'Return the full content of `path`' lacks context for when to use read_file vs list_files, or what happens on missing files.
No output schema documentation. Tools return unstructured text (e.g., 'one per line'). LLMs cannot plan downstream calls or extract structured data without knowing field names and types.
Parameter descriptions are minimal or absent. 'name' param in read_runbook says 'Exact runbook name, from list_runbooks' but does not explain format, length, or case sensitivity. 'prefix' in list_files has no description at all.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 43 | 2026-07-28+ | v2 |
No error handling guidance. What happens if read_file receives a non-existent path? If list_files prefix is invalid? Agents have no recovery path.
No pagination or result limits documented. list_runbooks and list_files could return unbounded results. No mention of max items, offset, or cursor.