foryourhealth111-pixel/Vibe-Skills
vibe
VerifiedVibe Code Orchestrator (VCO) is a governed runtime entry that freezes requirements, bounds execution, and enforces verification and phase cleanup.
references/change-proof-matrix.md
View on GitHub# Change Proof Matrix
This matrix translates change classes into the minimum planning and proof
burden. It is intentionally conservative.
| Change class | Typical paths | Plan required before edit | Minimum proof floor | Notes |
| --- | --- | --- | --- | --- |
| Docs-only contributor guidance | `docs/**`, `references/**` except fixtures, `README.md`, `docs/README.md`, `CONTRIBUTING.md` | No, unless the docs rewrite runtime or governance guarantees | `git diff --check` and link/navigation sanity | Safe default zone, but still keep links and claims coherent |
| Governance docs or operator guidance | `docs/**`, `scripts/governance/**`, `scripts/verify/**`, policy-facing `references/**` | Usually no for additive docs, yes if runtime obligations or stop-rules change | Relevant gate docs updated, `git diff --check`, and any touched governance gate rerun if behavior changed | Do not change policy language without matching evidence surfaces |
| Public promises or disclosure | root `README.md`, `NOTICE`, `THIRD_PARTY_LICENSES.md`, provenance docs | Yes if public promises change runtime, provenance, or disclosure scope | Disclosure/provenance validation plus `Command -> Output -> Claim` evidence | Public text is part of the contract |
| Mirror or fixture change | `bundled/**`, `references/fixtures/**`, tracked `outputs/**` | Yes | Canonical-first sync plus parity/boundary proof | Never mirror-first |
| Provenance or retained upstream change | `third_party/**`, `vendor/**`, provenance manifests | Yes | Provenance, disclosure, and cleanliness proof | Every retained upstream needs a clear source and record |
| Runtime-affecting change | `install.*`, `check.*`, `SKILL.md`, `protocols/**`, `scripts/router/**`, routing locks and manifests | Yes | Full runtime non-regression bundle | Treat as high-risk even if diff is small |
## Runtime Non-Regression Bundle
When the change is runtime-affecting or crosses into `Z0` or `Z2`, expect to
justify the result with the relevant subset of:
- `scripts/verify/vibe-pack-routing-smoke.ps1`
- `scripts/verify/vibe-current-routing-debt-gate.ps1`
- `scripts/verify/vibe-version-packaging-gate.ps1`
- `scripts/verify/vibe-output-artifact-boundary-gate.ps1`
- `scripts/verify/vibe-repo-cleanliness-gate.ps1`
- `scripts/verify/vibe-installed-runtime-freshness-gate.ps1`
- `scripts/verify/vibe-release-install-runtime-coherence-gate.ps1`
## Evidence Format
Whenever you claim a guarded or runtime-sensitive change is safe, record:
1. `Command`
2. `Output`
3. `Claim`
If you cannot produce that evidence, the change is not ready to be called
non-regressive.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |