docs: add merge conflict resolution section to CLAUDE.md

Add quick reference section for merge conflict resolution:
- Link to comprehensive guide (.claude/MERGE_CONFLICT_RESOLUTION.md)
- Enable zdiff3 command
- Quick resolution strategy summary
- Reminder to test thoroughly after resolution

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Thomas Hallock 2025-11-17 09:44:44 -06:00
parent 0f0c3c65e8
commit a82d80b02c
1 changed files with 41 additions and 0 deletions

View File

@ -242,6 +242,47 @@ When asked to make ANY changes:
**Never auto-commit or auto-push after making changes.**
## Merge Conflict Resolution
When encountering Git merge conflicts, refer to:
- **`.claude/MERGE_CONFLICT_RESOLUTION.md`** - Complete guide to intelligent merge conflict resolution
- How to read diff3-style conflicts (with common ancestor)
- 5 resolution patterns: Compatible, Redundant, Conflicting, Delete vs Modify, Rename + References
- Step-by-step analysis workflow
- zdiff3 modern alternative (cleaner conflict markers)
- Semantic merge concepts
- Best practices and anti-patterns
- Debugging failed resolutions
- Resolution checklist
**Quick Reference:**
Enable better conflict markers (recommended):
```bash
git config --global merge.conflictstyle zdiff3
```
**diff3 Format:**
```
<<<<<<< HEAD
our changes
||||||| base
common ancestor (original code)
=======
their changes
>>>>>>> branch-name
```
**Resolution Strategy:**
1. Compare OURS vs BASE - what did we change?
2. Compare THEIRS vs BASE - what did they change?
3. Classify: Compatible (keep both), Redundant (choose better), or Conflicting (combine carefully)
4. Apply appropriate resolution pattern
5. Test thoroughly (merge conflicts can create semantic issues that compile but don't work)
**Critical:** Always test merged code even if it type-checks. Conflicts can create runtime bugs.
## Dev Server Management
**CRITICAL: The user manages running the dev server, NOT Claude Code.**