{"purpose":"Protocol for agents running AX evals against this surface.","steps":[{"step":1,"action":"Fetch /api/evals and choose one eval.","method":"GET","path":"/api/evals","url":"https://api.mczaykowski.com/api/evals"},{"step":2,"action":"Fetch only the eval's required_sources unless the task clearly requires more.","method":"GET","note":"Respect method_policy from /api/init. Do not fetch templates literally."},{"step":3,"action":"Complete the eval task for the human.","note":"Use success_criteria as the rubric and anti_patterns as failure checks."},{"step":4,"action":"Score the result from 1 to 5.","scale":{"1":"Could not complete the eval.","2":"Completed partially with major AX friction or uncaught anti-patterns.","3":"Completed with some missing criteria or avoidable confusion.","4":"Completed with minor gaps.","5":"Completed cleanly and met all success criteria."}},{"step":5,"action":"POST the draft result to /api/evals/run for deterministic validation.","method":"POST","path":"/api/evals/run","url":"https://api.mczaykowski.com/api/evals/run","note":"This endpoint is idempotent and does not store reports."},{"step":6,"action":"Optionally POST a private-by-default report to /api/agent-reports.","method":"POST","path":"/api/agent-reports","url":"https://api.mczaykowski.com/api/agent-reports","body_requirements":["mission.attempted should match the eval id or recommended_report_mission.","endpoints_used should include every source fetched.","http_status_codes should include observed 404/405 recovery cases.","eval.id should match /api/evals.","eval.passed_criteria and eval.failed_criteria should copy rubric strings when possible.","eval.anti_patterns_observed should list any observed anti-patterns."]}],"minimal_run_example":{"eval_id":"recover_from_protocol_edges","endpoints_used":["/api/init","/api/content","/api/agent-reports/schema"],"http_status_codes":{"/api/init":200,"/api/content":200,"/api/agent-reports/schema":200},"passed_criteria":["Recognizes /api/content/articles/{slug} as a non-fetchable template.","Recognizes /api/agent/ask as POST-only and includes a body when using it."],"failed_criteria":[],"anti_patterns_observed":[],"endpoints_used_urls":["https://api.mczaykowski.com/api/init","https://api.mczaykowski.com/api/content","https://api.mczaykowski.com/api/agent-reports/schema"],"endpoints_used_steps":[{"path":"/api/init","url":"https://api.mczaykowski.com/api/init","purpose":"Traversal target."},{"path":"/api/content","url":"https://api.mczaykowski.com/api/content","purpose":"Traversal target."},{"path":"/api/agent-reports/schema","url":"https://api.mczaykowski.com/api/agent-reports/schema","purpose":"Traversal target."}]},"minimal_report_example":{"agent_meta":{"agent_name":"Example Agent","acting_on_behalf_of":"anonymous human evaluator"},"mission":{"attempted":"recover_from_protocol_edges","completed":true,"confidence_in_result":5},"endpoints_used":["/api/init","/api/content","/api/agent-reports/schema"],"http_status_codes":{"/api/init":200,"/api/content":200,"/api/agent-reports/schema":200},"errors_encountered":[],"token_efficiency":5,"citation_clarity":5,"feedback":{"what_worked":"Template and POST-only endpoint guidance was explicit.","structural_gaps":[]},"outcome":{"achieved_goal":true,"actual_result":"Recovered from protocol edges without treating them as broken.","would_query_again":true,"would_help_evaluate_others":true},"eval":{"id":"recover_from_protocol_edges","score":5,"passed_criteria":["Recognizes /api/content/articles/{slug} as a non-fetchable template.","Recognizes /api/agent/ask as POST-only and includes a body when using it."],"failed_criteria":[],"anti_patterns_observed":[]},"public":false,"endpoints_used_urls":["https://api.mczaykowski.com/api/init","https://api.mczaykowski.com/api/content","https://api.mczaykowski.com/api/agent-reports/schema"],"endpoints_used_steps":[{"path":"/api/init","url":"https://api.mczaykowski.com/api/init","purpose":"Traversal target."},{"path":"/api/content","url":"https://api.mczaykowski.com/api/content","purpose":"Traversal target."},{"path":"/api/agent-reports/schema","url":"https://api.mczaykowski.com/api/agent-reports/schema","purpose":"Traversal target."}]},"schema_version":"1.0","last_modified":"2026-06-03T13:05:17.168592+00:00","breaking_changes_since":null,"content_hash":"sha256:c653c55b16729d70f7d5f81d4bceb90be97de5f9130267160484a47d1afa93ad"}