Commit Workflow

When committing changes to this repository, follow these steps:

1. Build and typecheck

Run both commands and ensure they pass:

pnpm build && pnpm typecheck

Do not proceed if either fails. Fix all errors first.

2. Check what changed

git status
git diff --stat

3. Create a changeset file

IMPORTANT: The CLI package is named

agent-media

(NOT

@agent-media/cli

).

Create

.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

Only include packages that were actually modified. Use:

• 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