Validate changes match specs

Use this skill to verify that a branch or pull request implements the behavior and design promised by its specs. The workflow finds specs introduced by the change, compares them against code, tests, documentation, and validation artifacts, then walks the user through every material mismatch.

Goals

• Find specs introduced or modified by the current change.
• Extract concrete product, technical, security, migration, rollout, and validation commitments.
• Compare those commitments against the actual implementation.
• Produce a clear mismatch list.
• Ask the user, mismatch by mismatch, whether to update the implementation to match the spec or update the spec to match the implementation.
• Apply the chosen resolutions either one-by-one or in a batch.

Spec discovery

Start by identifying the base branch and changed files.

Prefer repository conventions when known. Otherwise: