UVC Naming
Universal Value Codes give every constitution a unique, human-readable identifier that encodes domain, approach, role, version, and organizational scope.
Token Format
A UVC token is a dot-separated hierarchy with optional version and namespace suffixes.
domain.approach.role[@version][:namespace]Semantic Mapping
Each component of the token carries specific meaning.
| Component | Description | Example |
|---|---|---|
domain | Value domain -- the broad area of concern | family, work, secure, health |
approach | Approach within the domain -- how values are applied | safe, strict, flexible, balanced |
role | Specific function the constitution fulfils | guide, compliance, tutor, moderator |
version | Semantic version (optional) -- pinned or ranged | @1.2.0, @2.0.0 |
namespace | Organizational scope (optional) -- who governs | :SEC, :NHS, :acme-corp |
Namespace Tiers
Namespaces determine governance scope. Higher tiers have broader authority and stricter review processes.
Core
(no prefix)Governed by the VCP Consortium. Universal constitutions that apply across all contexts.
family.safe.guide@1.0.0Organizational
company.*Governed by an organization. Scoped to corporate policies and industry regulations.
company.acme.legal.compliance:SECCommunity
community.*Governed by a community group. Shared norms for specific interest groups or movements.
community.educators.stem.tutor@2.1.0Personal
user.*Governed by an individual. Custom constitutions for personal use or experimentation.
user.nell.creative.writer@1.0.0Resolution
UVC tokens resolve to URIs that locate the signed constitution bundle in a content-addressed repository.
Token
family.safe.guide@1.2.0URI
creed://creed.space/family/safe/guide?v=1.2.0Path Mapping
Dots become path segments: family.safe.guide maps to /family/safe/guide. The version is passed as a query parameter.
Namespace Scoping
Namespaced tokens resolve under the namespace authority: company.acme.legal.compliance:SEC maps to creed://creed.space/company/acme/legal/compliance?ns=SEC.
Version Resolution
If no version is specified, the resolver returns the latest stable release.
Pinned versions (@1.2.0) are immutable once published.
Examples
Real-world UVC tokens showing the naming scheme in practice.
family.safe.guide@1.2.0A core family-safety constitution for guiding children's AI interactions. Age-appropriate filtering, gentle redirection, parental reporting.
company.acme.legal.compliance:SECAcme Corp's SEC compliance constitution. Ensures AI responses in financial contexts meet regulatory disclosure requirements.
community.educators.stem.tutor@2.1.0A community-maintained tutoring constitution for STEM education. Encourages exploration, Socratic questioning, worked examples.
health.cautious.advisor@1.0.0A core health constitution. Conservative approach: always recommends professional consultation, avoids diagnosis, respects privacy.
user.nell.creative.writer@1.0.0A personal constitution for creative writing assistance. Prioritizes voice preservation, avoids over-editing, encourages experimentation.
Build Your Own Token
See how UVC tokens work in practice with the interactive playground.