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. 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 existing issue before creating a new one — but never edit the body of an actively-claimed or open-PR issue (its claimed agent will not pick the change up); cover it with a follow-up issue instead. See the contract's claim-state precondition. 3. Choose the smallest safe output shape: