Single tool 'generate' has a complete input schema with nested objects and enums, but critical gaps undermine quality. Tool description is generic (18 chars: 'Gherkin feature generation route'), below the 50-200 char LLM-optimized baseline. Parameter descriptions exist but are minimal (e.g., 'Feature title (required)' lacks format/constraint guidance). Output schema is undocumented, LLMs cannot plan downstream use. No error handling guidance, no recovery paths. Tool naming lacks action verb clarity ('generate' is vague; 'create_gherkin_feature' would be clearer). No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Risk marked READ_ONLY but not enforced in schema or description.
Gherkin feature generation route
Tool description is 18 characters ('Gherkin feature generation route'), far below LLM-optimized baseline of 50-200 chars. LLMs cannot determine when/why to select this tool vs alternatives.
Output schema is completely undocumented. Tool returns a 'feature' field (string) but LLMs have no visibility into structure, format, or downstream usability. Prevents chaining and context planning.
No error handling guidance. If validation fails (missing title, empty scenarios), the tool returns HTTP 400 with a generic error message. LLMs cannot determine if the error is retryable, user-fixable, or fatal.
Tool name 'generate' lacks action clarity. Does it generate, create, build, or compose? 'create_gherkin_feature' or 'generate_feature_file' would be more self-documenting and reduce LLM ambiguity.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 39 | 2026-07-28+ | v2 |
Parameter descriptions are minimal and lack format/constraint guidance. E.g., 'Feature title (required)' does not specify length limits, character restrictions, or examples. 'Array of tags' does not explain tag format or max count.