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