issue-authoringlisted

# Issue Authoring Use this skill to prepare issue-ready work before execution starts. Keep the skill concise and treat the repository docs as the canonical source for the full contract and schema. The canonical source bundle lives in this repository; install copies in the agent-specific skill directory your runtime reads. ## Stable Phases Use two stable phases: 1. **Intake and Clarification** — inspect relevant context, identify ambiguity, run a secondary critique or explicit self-critique, and ask only the questions that block safe issue drafting. Keep clarification bounded; use the repository-local `issueAuthoring.maxClarificationRounds` value when available, otherwise default to 3 rounds. **Under-clarification stop rule**: if, after bounded clarification, you still cannot name the concrete surface to edit or an objective verification for a candidate task, route it to `needs-decision` or ask — do not publish a confidently-vague `ready` issue. Reliability over speed. 2. **Decompose and Draft** — restate the request in implementation terms, split it into atomic tasks, classify readiness, reuse existing issues when safe, and draft the smallest issue shape that preserves dependencies and reviewability. Preserve low-readiness work in stable buckets: ready, deferred, needs-decision, blocked-by-human, and out-of-scope. ## Workflow 1. Read the bundled contract in [references/contract.md](references/contract.md). 2. Reuse or extend an ex