governance-refactoring-compatibility-policy

What problem does it solve?

This policy governs decisions around refactoring, renaming or evolving existing code across languages by enforcing explicit compatibility choices—backward compatibility, deprecation timelines, or breaking changes—while mapping downstream consumers.

Core Features & Use Cases

• Enforces explicit compatibility decisions for analysis, consolidation, structuring, and refactoring across codebases.
• Requires mapping all public consumers before moving or renaming symbols and generating a changelog entry.
• Provides a clear decision framework and governance for deprecation and breaking changes, with documentation guidance.

Quick Start

Identify all consumers, decide the compatibility strategy (backward compatibility, deprecated with removal, or breaking change), and generate the corresponding changelog entry.