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:
@@ -242,6 +242,47 @@ When asked to make ANY changes:
|
|||||||
|
|
||||||
**Never auto-commit or auto-push after making 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
|
## Dev Server Management
|
||||||
|
|
||||||
**CRITICAL: The user manages running the dev server, NOT Claude Code.**
|
**CRITICAL: The user manages running the dev server, NOT Claude Code.**
|
||||||
|
|||||||
Reference in New Issue
Block a user