Přeskočit na obsah

workflow change-a-schema — Změna datového kontraktu

Změna datového kontraktu: Nejrizikovější běžná změna v repozitáři, vedená tak, aby po ní nezůstalo poloviční pole: co dnes platí podle schématu, třináct míst fan-outu s explicitním „netýká se, protože“, migrace u povinného pole, testy a golden snapshot, dopad na dokumentaci, ADR u sporného rozhodnutí a plná brána.. Claude workflow, provoz.

Claude workflow provoz

Volání

workflow change-a-schema

Zdroj: .claude/workflows/change-a-schema.md

Nejrizikovější běžná změna v repozitáři, vedená tak, aby po ní nezůstalo poloviční pole: co dnes platí podle schématu, třináct míst fan-outu s explicitním „netýká se, protože“, migrace u povinného pole, testy a golden snapshot, dopad na dokumentaci, ADR u sporného rozhodnutí a plná brána.

Kdy ho spustit

Při přidání, přejmenování nebo odebrání pole. Nezačíná se bez jasna v tom, kdo pole bude číst.

Pro koho a s jakým rizikem

  • Persona: údržbář, vývojář
  • Riziko: údržbář
  • Zapisuje do souborů: ano

Co vynucuje

Nic — tenhle příkaz reportuje nebo generuje, ale sám o sobě nic neshazuje. Co selže při chybě, hlídají brány, které za ním v pipeline běží.

Co je potřeba vědět

  • Nejlevnější pole je to, které nevzniklo. Hloubka v grafu se počítá, ne ukládá — a to je vzor.
  • Povinné pole bez migrace shodí build na každém existujícím záznamu. Doplnit ho odhadem je horší než nechat pole volitelné.
  • additionalProperties: false je brána, ne překážka. Šablona čtoucí pole, které schéma nezná, znamená postup shora dolů.

Popis vychází z hlavičkového komentáře zdrojového souboru. Volání, zařazení do pipeline i členství v pre-commit hooku se dopočítávají při každém buildu ze samotného repozitáře.