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:

1. •Add license file under licenses/
2. •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