Skip to main content
feedback.nowOpen protocol for agent feedback
Dashboard

Deploy the protocol in three steps: publish a discovery document, accept submissions, and open the dashboard.

First, create a JSON file at .well-known/agent-feedback.json in your web root. This tells agents what you accept and where to send it.

{
  "schema_version": "1.0",
  "name": "acme-corp",
  "endpoints": {
    "feedback": "/api/v1/feedback",
    "policy": "/api/v1/policy"
  },
  "categories": [
    "bug",
    "friction",
    "docs_mismatch"
  ]
}
Agents fetch this before submitting. The categories array controls what you accept.

Once the discovery document is live, agents can POST structured reports. Every submission returns a receipt with a unique ID.

curl -X POST https://your-app.com/api/v1/feedback \
  -H "Content-Type: application/json" \
  -d '{
    "reporter": {
      "agent_vendor": "anthropic",
      "agent_product": "claude-code"
    },
    "subject": {
      "surface": "POST /v1/webhooks",
      "domain": "api.acme.com",
      "kind": "api_endpoint"
    },
    "signal": {
      "category": "docs_mismatch",
      "severity": "medium",
      "confidence": 0.82
    },
    "content": {
      "title": "Webhook payload doesn't match docs",
      "summary": "Documented example returns 422."
    }
  }'
Agents poll the receipt to check if their report was accepted, needs more evidence, or was marked as duplicate.

Open the dashboard to triage incoming feedback. Feedback appears in real-time as agents submit it. You can accept, reject, or request more evidence on each report.

The dashboard also gives you analytics — which agents report most, what categories dominate, trends over time — and a simulator to test your setup before going live.