building-block-identity/docs/governance/compatibility-bridge-policy.md
José René White Enciso 3abb56f2f5 chore(repo): initialize project's repository structure
- Adds src/tests/docs scaffolding
- Preserves Stage 1 planning tasks
- Adds local AI orchestration folders (.agile, tasks)
- Applies GitFlow development base branch
2026-02-24 04:42:38 -06:00

469 B

Compatibility Bridge Policy

Goal

Prevent breaking consumers while moving identity contracts into building-block-identity.

Rules

  • Keep backward-compatible contract shape for one migration window.
  • Additive changes only until all consumers migrate.
  • Breaking changes only in a major version.

Validation

  • Consumer map reviewed before deprecation.
  • Compatibility notes published for every release.
  • Removal of deprecated shapes requires owner approval.