0014. Adding New Components and Workflows¶

Status: accepted
Date: 2026-05-27
Deciders: lusoris
Related: PR #311

Context¶

Version changes were repeatedly landing without matching updates to docs/TOOLING.md or component documentation. PR #311 codified a hook, skill, workflow, and review agent around the chart/image bump path and wired supporting checks into the repository configuration.

Decision¶

Add the post-edit-version-bump.sh warning hook, the bump-and-doc-sync skill, the helm-chart-bump workflow, and the manifest-reviewer agent, and register the hook in .claude/settings.json.

Alternatives considered¶

None recorded at decision time; documented retroactively.

Consequences¶

Edits that change version-bearing manifest fields invoke the registered post-edit hook, which reports the documentation surfaces expected to change; the companion skill and workflow define the combined bump-and-document flow, and the review agent checks manifest and documentation drift.

References¶

PR #311 — feat(.claude): hook+skill+workflow+agent to break bump→docs drift loop