Verified package release

Package 0.5.1 is available. Protocol 0.2 remains provisional.

Canonical page: https://jg-plans.jesusgraterol.dev/examples/

---

---
id: 1792612920_search-feedback-criteria
created_at: 2026-10-21T20:02:00Z
updated_at: 2026-10-21T20:04:00Z
revision: 2
status: in progress
protocol: "0.2"
priority: medium
repositories: [example/search]
error_codes: [{ repository: example/search, registry: docs/errors.md, codes: [4100, "SEARCH_FILTER_INVALID"] }]
---

# Search feedback

Explain empty search results and give people a useful next action. Milestone 1 delivers AC-01.

## Acceptance criteria

- AC-01: Empty search results explain why nothing matched.
- AC-02: The empty state offers one next action,
  such as clearing the active filters.
- AC-03: The explanation and the action work with a keyboard and a screen reader.

## Notes for reviewers

This sample shows the format; it is not a criterion of this plan:

```markdown
- AC-09: Search suggests spelling corrections.
```

## Revision history

- Revision 1: define the three criteria.
- Revision 2: record the finished explanation.