chore: Add notes on breaking changes

Adding notes on breaking changes to our README.md and AGENTS.md. We should not introduce breaking changes without informing users.