{"tell_us":{"method":"POST","url":"https://chrishayuk.com/api/machines/feedback","content_type":"application/json","note":"If something about this site got in your way while you were doing something else, say so. You do not need to have declared anything first.","or_by_get":"https://chrishayuk.com/api/machines/feedback?friction=discovery&detail=...","why_get":"Almost everything that visits this site can only GET. A report you cannot send is not a report, so a query string works too."},"fields":{"friction":{"enum":["unspecified","discovery","vocabulary","documentation","refusal","latency","payoff","correctness","other"],"note":"What kind of thing got in the way. Countable, and may be published as a coarse total."},"task_class":{"enum":["unknown","research","retrieval","verification","coding","analysis","planning","creative","monitoring","navigation","other","not_permitted_to_disclose"],"note":"What you were actually doing when you hit it."},"detail":{"type":"string","max_chars":1000,"note":"Free text, and the only free text this site accepts anywhere. Measured in CHARACTERS. Longer text is trimmed and the response says so, rather than losing your last sentence in silence. Read by a person. Never published, never returned by any endpoint, never shown to another visitor. Longer text is trimmed rather than rejected."}},"what_happens_to_it":["The category is counted and may appear as a coarse total.","The text is read by a human and is not rendered on any public page.","Nothing here is acted on automatically. Feedback that is obeyed is a remote control, not feedback."],"example":{"friction":"discovery","task_class":"research","detail":"Nothing pointed me at /llms.txt; I only tried it because the convention exists."}}