- 🧩 Capability change (
.repers/capabilities/registry.jsonor.repers/scripts/*.py) - 🪝 Hook change (
.repers/hooks/*) - 🧠 Codex skill change (
skills/<name>/SKILL.md) - 📦 Package / release-pack change (
dist/generators) - 🧪 CI / smoke change (
.github/workflows/,tests/) - 📚 Docs only
- 🚨 Breaking change for receivers (explain compat below)
$ python .repers/scripts/repers.py preflight --query "<your change>" --refresh --json
{...}$ python .repers/scripts/repers.py verify-all --json | head -20
{...}
$ python tests/smoke_repers.py
ok
For hook changes, also include a fake-commit reproduction.
For capability changes, include the capabilities --action validate --json output.
-
python .repers/scripts/repers.py verify-all --jsonpasses -
python tests/smoke_repers.pypasses - If user-visible:
versionbumped in.codex-plugin/plugin.json(andregistry.jsonif the registry shape changed) - README "Skills" / "Capabilities" / "Core commands" tables updated if relevant
-
CHANGELOG.mdupdated underUnreleased - No new runtime dependencies (stdlib Python only)
- No runtime state added to package outputs (
.repers/index/,repers_tasks/, caches stay excluded)