jj Workflow

Philosophy

1. Commits are cheap, descriptions are mandatory. The working copy is always a commit. Never leave it as "(no description set)".
2. Experiment freely, the oplog is your safety net. Every mutation is recorded. jj undo and jj op restore make anything reversible.
3. Conflicts are state, not emergencies. jj stores conflicts in commits as structured data. Rebase succeeds even with conflicts. Resolve when ready.
4. Change IDs are your handle on work. Commit hashes change on rewrite; change IDs don't. Use change IDs to refer to work across rebases and squashes.
5. Bookmarks exist for GitHub, not for you. Work with anonymous changes. Add bookmarks only when you need to push.
6. Keep the stack shallow. Squash early. Don't let history grow 10 commits deep before curating.
7. Use absorb over manual squash routing. When fixing across a stack, let jj figure out where each hunk belongs.
8. Colocated = invisible to the team. Teammates see standard git. They don't know you use jj.

CRITICAL: AI-Specific Rules

Always use -m flag to prevent jj from opening an editor:

# WRONG - opens editor, blocks AI