Working with Graphite

Core Principles

1. Never commit to main All commits must be on a feature branch
2. Do not create branches unless asked Do not create new branches unless explicitly requested to.
3. Never use raw Git rebase -- always use gt commands to preserve stack metadata
4. Always set Claude as the co-author when committing

Branch Strategy

• When creating plans, include the expected branches for each unit of work
• Pieces of work that span > 500 LOC should be broken into multiple branches and stacked onto one another
• Stack branches in a logical order, with discrete features in each branch.
• Each branch must be able to pass all lint, check, and test evaluations

Committing code

• Manually stage changes to impacted files using git commands. Do not use the -a flag to automatically stage all changes.