- Propose — Open an ADR describing the change, migration path, and timeline.
- Announce — Add a "Breaking Changes" entry under
CHANGELOG.mdUnreleased. - Deprecate — Ship deprecation warnings for at least one minor release when possible.
- Migrate — Provide migration guide in
docs/or ADR consequences section. - Remove — Delete deprecated APIs only after the announced window.
- Public API (
teaagentexports, documented CLI): deprecate in X.Y, remove in X.(Y+1) or next major. - Internal modules (
teaagent._*, undocumented CLI): may change in any release.
- ADR merged
- CHANGELOG updated
- Tests cover old and new behavior during migration window
-
scripts/pre-release-check.shpasses