pr

# /pr - Prepare and Submit Changes

## Purpose

Commit changes to a feature branch, bump version if needed, update changelog, and open a PR.

## Before Starting

- Check for uncommitted changes: `git status --porcelain`
- Ensure tests pass: `make test` or equivalent
- Confirm current branch (create one if on main)

## Process

1. **Create or verify feature branch**

   If on main, create a branch from the work context:
   ```
   git checkout -b <descriptive-branch-name>
   ```

2. **Stage and commit changes**

   Use the user's git identity (never sign as Claude, no Co-authored-by).
   Write conventional commit messages:
   - `feat: add remote file sync`
   - `fix: resolve timeout on large files`

3. **Bump version if warranted**

   - Bug fixes → patch
   - New features → minor
   - Breaking changes → major

   Update version in pyproject.toml (or equivalent).

4. **Update CHANGELOG.md**

   Use /changelog skill to generate entry if changes are user-facing.

5. **Push and create PR**

   ```
   git push -u origin <branch>
   gh pr create --fill
   ```

   PR description should summarize changes. Link issues if referenced in commits.

## Notes

- Don't add "Signed-off-by" or "Co-authored-by: Claude" trailers
- Ask before force-pushing
- If tests fail, stop and report