{"rule_id":"AB-166","category":"actionability","icon":"➡️","title":"next_call pattern in API responses","short_description":"Your OpenAPI spec includes a next_call field in response schemas with method, path, and why to guide agents to the next request.","user_value":"AI agents can follow a chain of API calls autonomously without hardcoding navigation logic, improving actionability and reducing integration friction.","wrong_example":"{\"data\": {\"id\": 123}}","right_example":"{\"data\": {\"id\": 123}, \"next_call\": {\"method\": \"GET\", \"path\": \"/api/v1/items/123\", \"why\": \"Fetch item details\"}}","effort_hint":"moderate","estimated_cost":"$0","severity":"low","pillar":"understandability","version":"1.0.0","counted_in_score":true,"check":{"type":"semantic_validation","sources":["openapi_standard"]},"fix":{"eligible":true,"type":"deterministic","note":"Include a next_call field in API responses with method (string), path (string), and why (string) to guide agents to the next request"},"checklist_anchor":"#AB-166","checklist_url":"/agent-readiness-checklist#AB-166","html_url":"/rules/AB-166","json_url":"/rules/AB-166.json","related_rules":[{"rule_id":"AB-007","title":"Guide and API Consistency","category":"actionability"},{"rule_id":"AB-008","title":"Authentication Declared","category":"actionability"},{"rule_id":"AB-009","title":"Capability Coverage","category":"actionability"},{"rule_id":"AB-074","title":"A2A Agent Card Published","category":"actionability"},{"rule_id":"AB-075","title":"A2A Agent Card Verified","category":"actionability"},{"rule_id":"AB-085","title":"MCP Server Name Present","category":"actionability"},{"rule_id":"AB-086","title":"MCP Auth Discovery Resolves","category":"actionability"},{"rule_id":"AB-146","title":"Operation descriptions","category":"actionability"},{"rule_id":"AB-159","title":"Business constraints documented","category":"actionability"},{"rule_id":"AB-162","title":"Heartbeat.md availability","category":"actionability"}]}