Skip to content

docs: Release Lifecycle Standard v1.3 — audit finding-identifier convention (§2.8)#62

Merged
Cloto-dev merged 1 commit into
masterfrom
docs/release-standard-v1.3
Jul 23, 2026
Merged

docs: Release Lifecycle Standard v1.3 — audit finding-identifier convention (§2.8)#62
Cloto-dev merged 1 commit into
masterfrom
docs/release-standard-v1.3

Conversation

@Cloto-dev

@Cloto-dev Cloto-dev commented Jul 23, 2026

Copy link
Copy Markdown
Owner

Summary

Adds §2.8 to the Release Lifecycle Standard and bumps it to v1.3 (canonical home; both pilot repositories' adoption rows updated):

  • One number space: the canonical registry number is the only defect number. Human-facing documents (PR titles/bodies, final audit reports, changelogs) reference defects in the severity-prefixed formM-144 = registry entry bug-144 at MEDIUM (C- CRITICAL / H- / M- / L-; the prefix is a writing-time snapshot, the registry field stays authoritative). No per-audit numbering space exists.
  • Only bare canonical ids (bug-NNN) enter the tree — code markers, test names, registry patterns (severity would go stale in code). Canonical ids are assigned at confirmation time (before fix implementation), so fix briefs, tests, registry entries, and the audit report's final version are all born canonical. Workflow-internal working ids never appear in the tree or as public report ids.

Why

During the 2.5.2a2 remediation review, two naming lineages collided: ClotoCore's audits use severity initials (H-10, M-27) while the cpersona b1q audit used cluster numbers (C07, where C02 was MEDIUM) — a cluster id was misread as CRITICAL. Separately, the remediation workflow's ephemeral cluster ids leaked into the tree as pseudo-markers (bug-C5, test_c8_*), requiring a canonicalization pass (PR #61, commit 8791499). §2.8 closes both failure modes per the standard's own §6 defect procedure.

Doc-only change; no behavior.

🤖 Generated with Claude Code

…ention (§2.8)

Two id lineages coexisted across the family (ClotoCore audits: H-NN/M-NN
severity initials; the cpersona b1q audit: C## cluster numbers) and the
collision produced a real severity misread during the 2.5.2a2 remediation
review, alongside audit working ids leaking into code comments, test
names, and registry patterns as pseudo-markers. v1.3 standardizes:
severity-initial report ids (C- reserved for CRITICAL), canonical
registry ids only in the tree, and canonical assignment before fix
implementation. Adoption registry rows updated for both pilots.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Cloto-dev
Cloto-dev merged commit bdebf8b into master Jul 23, 2026
4 checks passed
@Cloto-dev
Cloto-dev deleted the docs/release-standard-v1.3 branch July 23, 2026 09:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant