What problem does it solve? Keeping Linear issues aligned with actual repository work requires manual status updates and comments at every milestone, which developers often forget. This Skill automates posting milestone comments and status transitions to a linked Linear issue as planning and implementation progress. ## Core Features & Use Cases - Milestone Comments: Posts idempotent, deduplicated comments for plan-drafted, implement-started, phase-complete, decision-log, implementation-reviewed, and implemented events. - Status Transitions: Moves issues to In Progress when implementation starts and closes per-phase child issues when phases complete, never regressing states. - Issue Resolution: Reads linear_issue and phase_issues mappings from change.md frontmatter, with user confirmation before the first write per session. - Use Case: While running an implementation workflow on a change folder linked to ZAW-42, the Skill automatically comments on the issue when the plan is drafted, moves it to In Progress when coding starts, and closes child phase issues as each phase commit lands. ## Quick Start Link a Linear issue by adding linear_issue: ZAW-42 to the change.md frontmatter and let the planning or implementation workflow sync milestones automatically.
