AgileWebs/building-block-identity

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

829 B

Raw Blame History

Building Block Identity Versioning Policy

Policy

Semantic Versioning (MAJOR.MINOR.PATCH) is mandatory.
Backward-compatible contract additions increment MINOR.
Breaking schema changes increment MAJOR.
Non-functional clarifications increment PATCH.

Compatibility Guarantees

Existing required fields are not removed in the same major line.
Field renames require additive migration period before removal.
Deprecations must include replacement guidance.

Release Governance

Changes require Thalos owner approval.
Each release includes a consumer impact note.
Contract ownership statement must remain explicit in release notes.

Migration Rules

Introduce additive fields first.
Keep dual-shape support for one compatibility window.
Remove deprecated fields only in next major release.