Skip to content

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-001adr-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/v1 envelope 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.