verify

Verify

Run the thing and look at it. Tests passing is not the same as the feature working.

/test proves the assertions you wrote are satisfied. This proves the software does what the task asked. They fail differently: a test suite can be entirely green while the button doesn't render, the endpoint 500s on the real payload, or the CLI prints the wrong thing.

The output of this command is what you observed, never what you expect to happen. If you did not run it, say you did not run it.

Input: optional — what to check (the settings page, POST /api/export). Empty means: work out what the current change affects and verify that.

---

Step 1 — Work out what "working" looks like

One or two concrete, checkable statements. Not "the export feature works" but:

• GET /api/export?format=csv returns 200 with a text/csv body and a header row
• the Settings page renders the new toggle, and clicking it persists after reload

If the task came from TASKS.md or an issue, its acceptance points are these.

Step 2 — Start it

Use the project's own run command from Project context in AGENTS.md:

<run/dev command>          # e.g. pnpm dev, go run ./cmd/server, make up

Run it in the background and capture output — you'll need the logs when it misbehaves. Wait for the ready signal rather than a fixed sleep, and give up with a clear message if it never comes:

for i in $(seq 1 60); do
  curl -sf http://localhost:3000 >/dev/null && break
  sleep 1
done

If it won't start, stop here and report that. A server that doesn't boot is the finding — don't work around it to reach the part you meant to test.

Step 3 — Exercise it

Pick the cheapest tool that actually observes the result:

Kind of change	How to verify
HTTP API	curl the real route with a real payload; check status, headers, body shape
CLI	Run it with real arguments; check exit code and stdout
Web UI	Open the route in a browser you can script, screenshot it, read the console
Background job	Trigger it; check the side effect (row written, file produced, message sent)
Library	A scratch script that imports it and calls it the way a consumer would