soleri-agent-issueslisted

# Agent-Optimized Issue Creation Create GitHub issues that AI agents can parse, execute, and verify without ambiguity. Every issue is a self-contained work order — an agent reading it has everything needed to start, execute, and prove completion. ## Core Principle **Human issues describe problems. Agent issues describe solutions as testable outcomes.** An agent cannot act on "improve avatar handling." It can act on: "Add PNG upload to `POST /v1/avatar` in `apps/api/src/routes/avatar.ts`, return `{ avatarUrl }`, reject files > 2MB with 413." ## When to Use - Creating any GitHub issue via `gh issue create` - Filing bugs from conversation context or error logs - Breaking plans into trackable work items - Creating milestones with sub-issues - Converting vault patterns or anti-patterns into actionable fixes ## Vault Context Check Before creating the issue, search for related patterns: ``` YOUR_AGENT_core op:search_intelligent params: { query: "<bug description or feature summary>" } YOUR_AGENT_core op:memory_search params: { query: "<similar issues>" } ``` ## Issue Template by Type ### Bug ```markdown # Objective <one sentence: what's broken and what "fixed" looks like> ## Type: bug ## Component: <package or module name> ## Priority: P0 | P1 | P2 | P3 ## Context - Impact: <who/what is affected> - Related: <links to issues, PRs, vault entries> - First seen: <date or commit> ## Steps to Reproduce 1. <exact command or action> 2. <exact command or action> 3. O