{"rule_id":"AB-012","category":"machine_readable","icon":"⚠️","title":"Structured Error Responses","short_description":"Your API returns errors in a consistent, machine-readable format.","user_value":"When agents get a structured error, they can understand what went wrong and retry correctly. Plain text errors are useless.","wrong_example":"Errors return plain text like 'Something went wrong'. Agents can't parse or respond to this.","right_example":"Errors return structured data with error code, message, and suggested action.","effort_hint":"moderate","estimated_cost":"$10-50","severity":"low","pillar":"discovery","version":"1.0.0","counted_in_score":true,"check":{"type":"schema_validation","target":"openapi.components.schemas"},"fix":{"eligible":false,"type":"none","note":"Cannot safely invent an error contract"},"checklist_anchor":"#AB-012","checklist_url":"/agent-readiness-checklist#AB-012","html_url":"/rules/AB-012","json_url":"/rules/AB-012.json","related_rules":[{"rule_id":"AB-010","title":"Machine-Readable Pricing","category":"machine_readable"},{"rule_id":"AB-011","title":"Rate Limits Declared","category":"machine_readable"},{"rule_id":"AB-020","title":"MCP Tools List","category":"machine_readable"},{"rule_id":"AB-021","title":"MCP Tool Calls","category":"machine_readable"},{"rule_id":"AB-022","title":"MCP Streaming Support","category":"machine_readable"},{"rule_id":"AB-109","title":"Agent Card version 1.0.0+","category":"machine_readable"},{"rule_id":"AB-163","title":"Skill.json (JSON-LD) availability","category":"machine_readable"},{"rule_id":"AB-164","title":"Error catalog endpoint","category":"machine_readable"}]}