---
name: issues
description: Use when opening an issue or changing its title or description. Produces an actionable problem record for a decider with no project context.
---

# Issues

Use a plain-language title that names the problem or desired outcome.

Open with exactly:

```md
**Problem.** Describe the current behavior or missing ability, who or what it affects, and its concrete cost or risk.

**Outcome.** State the observable result or decision that closes the issue without prescribing an implementation unless one is already decided.
```

## Evidence

Support the problem with concrete observations, reproduction steps, measurements, code references, or sources. Do not repeat the opening.

Add `## Decision` only when work cannot start without a choice. Follow `Change policy` in `AGENTS.md`.
