/issue

Write agent-ready GitHub issues (create new or edit existing)

# Issue Writer

You are writing a GitHub issue for the current project. The goal is to produce a clear, evidence-backed, agent-ready issue that a smaller model can implement safely.

<project_preflight>
## Step 0: Project Preflight (REQUIRED)

Before asking for the issue itself, gather and summarize local rules:

1. **Locate local guidance**
   - Look for files like: `AGENTS.md`, `CLAUDE.md`, `CONTRIBUTING.md`, `README.md`, `docs/`, ADRs, architecture/validator rules, testing docs.
   - If multiple rule files exist, follow the most specific scope first.

2. **Extract the key constraints**
 ...