Commit Workflow

1. Build and typecheck

pnpm build && pnpm typecheck

2. Check what changed

git status
git diff --stat

3. Create a changeset file

agent-media

@agent-media/cli

.changeset/<descriptive-name>.md

---
"agent-media": patch|minor|major
"@agent-media/core": patch|minor|major
"@agent-media/providers": patch|minor|major
"@agent-media/image": patch|minor|major
"@agent-media/audio": patch|minor|major
"@agent-media/video": patch|minor|major
---

Brief description of changes

• patch

  for bug fixes

• minor

  for new features (backward compatible)

• major

  for breaking changes

4. Create feature branch

git checkout -b feat/<descriptive-name>
# or fix/<descriptive-name> for bug fixes

5. Stage and commit

git add <files> .changeset/<name>.md
git commit -m "feat|fix: descriptive message"

6. Push and create PR

git push -u origin <branch-name>
gh pr create --title "..." --body "..."

Note: If you need to switch GitHub accounts for PR creation, check

.claude.local/workflow.md

for your personal account switching commands.

Important reminders

• NEVER manually edit CHANGELOG.md - changesets auto-generates it
• NEVER run

  pnpm changeset version

  locally
• ALWAYS run

  pnpm build && pnpm typecheck

  before committing
• ALWAYS sync README.md to packages/cli/README.md when README changes