{"rule_id":"AB-007","category":"actionability","icon":"🔄","title":"Guide and API Consistency","short_description":"Your agent guide and your API specification describe the same endpoints.","user_value":"If your guide says one thing but your API does another, agents will fail and avoid your service.","wrong_example":"Guide mentions endpoints that don't exist in the API spec, or vice versa.","right_example":"Guide and API spec are perfectly aligned — what agents read is what they get.","effort_hint":"moderate","estimated_cost":"$10-50","severity":"high","pillar":"understandability","version":"1.0.0","counted_in_score":true,"check":{"type":"cross_evidence","sources":["openapi","guide"],"match_keys":["method","path"]},"fix":{"eligible":false,"type":"none","note":"A CONFLICT here means the owner's two sources of truth disagree; only a human can resolve which is correct"},"checklist_anchor":"#AB-007","checklist_url":"/agent-readiness-checklist#AB-007","html_url":"/rules/AB-007","json_url":"/rules/AB-007.json","related_rules":[{"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"},{"rule_id":"AB-166","title":"next_call pattern in API responses","category":"actionability"}]}