Single tool 'runbookgen_scan' has a basic description but lacks critical schema detail and parameter documentation. Input schema visible but parameter 'target' has minimal description (just 'Target path to scan for incident definitions'). No output schema documented. No error handling guidance. Tool does one thing (scan), but definition quality is well below production baseline. Naming is acceptable (verb_noun form), but parameter and output documentation are severely deficient.
Incident runbook and SOP generator from templates. Returns JSON findings.
Output schema not documented. LLMs cannot plan downstream operations or extract fields from the JSON response without knowing the structure.
Parameter 'target' description is minimal (13 chars). Does not explain format, constraints, or expected values (absolute path? relative? directory only?). LLMs will guess.
No error handling guidance. Tool description does not explain what happens on invalid paths, permission errors, or empty scans. LLMs have no recovery path.
Tool description (67 chars) is below the 10 - 1024 char baseline and lacks WHEN/WHY context. Does not explain when to call this vs other tools or what 'incident definitions' means.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
No pagination or result limits documented. If scan returns hundreds of findings, response could exhaust context window. No guidance on max results or chunking.