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

git rebase -i

PR Guidelines

• Keep PRs focused and small
• Run relevant tests before submitting
• Each commit tells part of the story

CI Environment Notes

• 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

• .env

  files
• Credentials
• Secrets

Third-Party Dependencies

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