ADR-0001 — Name the manufactured object UCCO; retire CCO¶
Status: Ratified 2026-07-01 (proposed and ratified same day; the /ns/ucco/v1 on-disk
verification was the last evidence it needed).
Series: Canon decisions (project-constitutional — distinct from the infrastructure ADR series
adr-001…adr-005).
Lifecycle class (per UCCA-ADR-LIFECYCLE-01): F — minted (verified 2026-07-01). Records an
existing fact: the UCCO envelope is on disk at /ns/ucco/v1.
Context¶
The March whitepaper split CCO (the object) from UCCO (the open standard). FOUNDATION-01 retired "CCO" as a docstring with no artefact. In conversation the object and its standard kept collapsing into one.
Decision¶
Adopt option (b): UCCO is the object and the standard, one name. Retire CCO as the larval pre-name. UCCC is not a term.
Consequences¶
- FOUNDATION-01's §4 CCO bullet is corrected (CCO was not "a name with no artefact" but "the pre-name of UCCO"). Correction incorporated at initial filing of FOUNDATION-01.
- The whitepaper (
narratives/the-gate-whitepaper.md) needs a dated header noting the naming resolved to UCCO-per-(b); do not rewrite it. - The
/ns/ucco/v1envelope on disk is the UCCO — content-in-its-verifiable-envelope is one object by design; canon must state this explicitly so the envelope-vs-content split isn't re-derived as a contradiction. - Everywhere "CCO" appears in older material, read UCCO. New work writes UCCO. The ~1,782 existing CCO references are not mass-rewritten (find-and-replace is the moving-work trap); they are corrected opportunistically under the Full Cycle rule as files are touched, and the banner sweep handles reader-facing confusion.
Provenance¶
Ruled in the 2026-07-01 north-star session. Source of record: UCCA-CAPTURE-01 §2.1, §5.
On-disk evidence: /ns/ucco/v1 in engine/ucca-engine/renderer/vc.py and the keys worker.