---
description: Compare two files or implementations side by side
argument-hint: [path-a] [path-b]
---

Compare `$1` and `$2`:

1. Read both files
2. Identify:
   - Structural differences (added/removed/moved sections)
   - Behavioral differences (logic changes, different approaches)
   - API differences (changed signatures, new/removed exports)
3. Assess which implementation is better and why
4. Note any compatibility concerns if switching from one to the other