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