Understand the failure before changing things

Errors & troubleshooting

These guides are built around real failure patterns. Start by identifying what the system is telling you, narrow the cause with evidence, then choose the smallest safe fix instead of pasting random commands.

Git

Git troubleshooting

Reviewed 2026-08-16

Git rebase conflict

Fix Git rebase conflicts safely by identifying the replayed commit, resolving intent instead of markers, testing the result, and knowing when to abort.

Diagnose the problem
Reviewed 2026-08-16

Git merge conflict

Resolve Git merge conflicts by reading repository state, reconstructing both branches’ intent, testing the combined result, and knowing when to abort safely.

Diagnose the problem