What problem does it solve? GitHub issues often lack the detail needed for implementation, forcing developers to do extra investigation before they can start. This Skill polishes an issue until it can be implemented from the issue alone, by investigating the codebase, making grounded design decisions, and validating the fix approach in a temporary git worktree. ## Core Features & Use Cases - Gap Analysis and Codebase Investigation: Compares the issue body against a target structure, then locates root causes and change points at file-and-line-number precision. - Design Decision Logging: Records every design fork with adopted options, rejected alternatives, rationale, and confidence levels in a decision log table. - Trial Implementation in Worktree: Verifies the fix approach with a minimal implementation and tests in a temporary git worktree, then cleans up the branch and worktree afterward. - Approval-Gated Rewrite: Presents the polished body for approval before writing it via gh issue edit, and posts a change summary comment for traceability. - Use Case: A maintainer receives a vague bug report. Run this Skill on the issue to produce a complete specification with reproduction steps, root cause, fix plan, test plan, and completion criteria. ## Quick Start Polish GitHub issue #123 so it reaches a state where it can be implemented from the issue alone.
