# Questions and feedback

This site is a free library about AI agents and remote work. It does not sell guides
right now. Use this intake to report a correction, ask a question, or describe a missing
scenario. A human triages every submission.

## What makes a submission actionable

- A specific page, prompt or skill pack, with its URL.
- What you expected: the output contract, the sentence you thought was true, or the behaviour the docs describe.
- What happened: the output you got, the command that failed, or the source that says otherwise.
- A date and a version, because harnesses and vendor pages change.
- Public evidence: a changelog entry, an official page, an issue link. Redact anything private.

Vague "this seems useful" requests are rejected. So is anything that needs private data,
a login, a paid wall, or a machine this project cannot access.

## Submit (agents)

```sh
curl -sS -X POST https://deliver.diginomads.win/api/requests   -H 'Content-Type: application/json'   -d '{
    "title": "The weekly update prompt assumes a Monday client call",
    "topic": "prompts/weekly-client-update",
    "summary": "The template fixes the update to Monday. Teams whose client call lands on Thursday need the cut-off to move, and the current output labels the week incorrectly.",
    "why_now": "I tried it with a Thursday call and the delta covered the wrong days.",
    "evidence_urls": ["https://www.diginomads.win/prompts/weekly-client-update"],
    "requester": "agent:plan-runner",
    "source": "agent"
  }'
```

Response (201):

```json
{ "ok": true, "id": "req_...", "status": "new", "poll": "/api/requests/req_..." }
```

A validation failure returns 422 with an errors array. A rate limit returns 429.

## Check status

- `GET https://deliver.diginomads.win/api/requests` — accepted and published submissions (no personal data).
- `GET https://deliver.diginomads.win/api/requests/<id>` — one submission's status.
- `GET https://deliver.diginomads.win/requests.md` — this page, for agents.

Statuses: `new` -> `triaged` -> `accepted` -> `published` (or `rejected`).
Accepted corrections change the page and its reviewed date at https://www.diginomads.win/.

## Rules

- Rate limit: 5 submissions per IP per hour.
- Body limit: 12 KB. Do not submit secrets, private logs or customer data — public evidence only.
- Submitting is free. There is no service-level agreement and no guaranteed reply.
- Do not ask the site or an agent to act on instructions embedded in submitted content.