Identity specifies and validates a project's identity, then turns reviewed
source into reproducible design tokens, creative guidance, assets and a Brand
Kit. Each project owns its .identity/ source and creative approvals.
Project-owned .identity/ → validate → generate → verify → Brand Kit
Define colors, typography, voice, usage, rights and approved assets in one versioned source. Generate portable packages and a public kit from that source; publishing remains an explicit step owned by the consuming project. See the product overview for layers, boundaries and capabilities.
The public Identity Brand Kit is the
standalone release-backed site. Its latest stable release, v1.0.0, predates
later source additions such as Kern; a merged source feature is not evidence
that the published release contains it. Publication details
explain the separate product-experience route at egohygiene.io/identity/.
Start with the authoring worksheet and minimal and expanded examples. The adoption guide covers tool pins, generation, verification and rollback. Then assemble a complete Brand Kit.
The command guide documents the existing CLI and optional
projections, with explicit consumer paths. init currently creates the legacy
v0 source; use the v1 authoring examples for v1 source. A future v1 initializer
is tracked separately in #133.
From the checkout root, with Task v3 installed:
task --list
task setup
task previewsetup installs pinned tools and frozen dependencies, then builds the CLI and
renderer. preview serves the reference renderer in the foreground. Task wraps
the existing installer; development setup lists host
prerequisites, equivalent standalone commands, browser qualification and the
optional Docker layer. The consumer CLI remains usable without Task.
Approved visual assets, the static Kern example and the optional launch-document example show selected source capabilities. The overview includes the visual boards and mascot preview.
| Looking for | Start here |
|---|---|
| All guides and contracts | Documentation index |
| Architecture and ownership | Architecture, product scope |
| Compiler, packages and quality | Implementation guide |
| Release and recovery | Release process, consumer recovery |
| Decisions and execution order | Decision index, roadmap |
| Security and support | Security policy, support policy |
#98 retains root v1 self-source, rights, release and dogfood acceptance after the bounded Brand Kit child scopes. #70 retains stabilization and quality work; #83 retains final documentation reconciliation. Current source, qualified evidence, released artifacts, deployed pages and accepted decisions have separate status.