PR Workflow Guide

Commit Practices

• Atomic commits. Small, focused, single purpose

• Don't mix: logic + formatting, logic + refactoring

• Good message = easy to write short description of intent

Learn git rebase -i for clean history.

PR Guidelines

• Keep PRs focused and small

• Run relevant tests before submitting

• Each commit tells part of the story

CI Environment Notes

If running as GitHub Action:

• Max-turns limit in .github/workflows/claude.yml

• OK to commit WIP state and push

• OK to open WIP PR and continue in another action

• Don't spiral into rabbit holes. Stay focused on key task

Security

Never commit:

• .env files

• Credentials

• Secrets

Third-Party Dependencies

When adding:

• Add license file under licenses/

• Update NOTICE.md with dependency info

External APIs/Tools

• Never guess API params or CLI args

• Search official docs first

• Ask for clarification if ambiguous