atom-lifecycle-states

Valid lifecycle states for atoms in the schema-atoms catalog.

draft 1.0.0 controlled-vocabulary
idschema-atoms/controlled-vocabulary/atom-lifecycle-states
created2026-05-23

values.yaml yaml
# atom-lifecycle-states — valid lifecycle states for atoms in the schema-atoms catalog.
# Atom: schema-atoms/controlled-vocabulary/atom-lifecycle-states@1.0.0
# License: CC-BY-4.0 (Convergent Systems Co.)

values:
  - name: draft
    description: >
      The atom is under active development or review and has not yet been ratified
      for production use. Consumers may reference it but should expect breaking
      changes before it reaches the published state.

  - name: published
    description: >
      The atom has passed quorum signing and is approved for production use.
      Its content is stable; any breaking change requires a new versioned atom.

  - name: adopted
    description: >
      The atom is published and has been referenced by at least one downstream
      catalog or consumer (e.g. ai-constitution, olympus). Adoption signals
      real-world usage and raises the social cost of breaking changes.

  - name: historic
    description: >
      The atom has been superseded by a newer version or retired from active use.
      Historic atoms remain in the catalog for archival and audit purposes but
      SHOULD NOT be referenced in new compositions.

atom.toml
id          = "schema-atoms/controlled-vocabulary/atom-lifecycle-states"
version     = "1.0.0"
content_hash = ""
lifecycle   = "draft"
created_at  = "2026-05-23T00:00:00Z"

[controlled_vocabulary]
name        = "atom-lifecycle-states"
description = "Valid lifecycle states for atoms in the schema-atoms catalog."
asset       = "values.yaml"