What problem does it solve?
Forward-porting changes between diverging release lines often leads to blind cherry-picks, overwritten evolved code, or silently dropped fixes. This Skill provides a disciplined workflow for moving a complete, validated 0.2 change into the 0.3 line by intent rather than by filename, without regressing 0.3 architecture or unrelated work.
Core Features & Use Cases
- Intent-based port mapping: Classifies every source behavior as already satisfied, adaptable, broadened, or not applicable in 0.3, with evidence.
- Architecture re-discovery: Locates the current 0.3 canonical owner, sibling consumers, and compatibility seams instead of trusting matching filenames.
- Safe worktree handling: Preserves unrelated dirty destination bytes, never stages or commits, and reports exact changed paths to the calling workflow.
- Use Case: A bug fix landed on the 0.2 branch of Happier and must reach 0.3, where the owning module was refactored. The Skill re-discovers the new owner, adapts the fix through 0.3 abstractions, and proves it with RED -> GREEN tests.
Quick Start
Use the happier-port-0-2-to-0-3 skill to port this validated 0.2 change into the 0.3 checkout without overwriting evolved code.