This is the index. Most docs live one or two clicks away under the canonical homes below; nothing of substance lives at this level.
Start here#
- Getting Started — environment setup and first build
- Architecture — system overview, domain boundaries, shared infra
- Contributing — PR process, code review, conventions
Canonical homes#
| What | Where |
|---|---|
| Cross-cutting reference (architecture, contracts, standards, runbooks, inventories) | reference/ |
| Per-domain docs (one folder per domain — README, architecture, features, developer-guide, database, api, audits, runbooks, …) | domains/ |
| Architecture Decision Records (single global numbering, 0001–0072) | adr/ |
| Open proposals (pre-decision; accepted ones become ADRs) | proposals/ |
| Release-cycle artifacts (V1 audits, scope, specs, design, runbooks, reports; P2 strategy work) | releases/ |
| How-to guides (adding a library, debugging a domain, etc.) | guides/ |
Other top-level dirs#
api/— API surface index and protocol referencescompliance/— compliance artifacts (SOC2, GDPR, audit trails)conventions/— repo-wide conventions outside thecoding-standards.mdcoreinfrastructure/— deployment topology, ECS, RunPod, observability stack diagramsintegrations/— third-party integrations (ElevenLabs, ComfyUI, CivitAI, …)migration/— domain migration guidesperformance/— performance baselines and budgetsresearch/— research notes, mediator-AI, gap analyses for upcoming worktraining/— onboarding materials and workshops
Generated content#
These are auto-regenerated and are tracked-but-don't-edit:
kalika/— Kalika API reference and tutorial notebooks (pnpm kalika:api-referenceandkalika:tutorial-notebooksrebuild thegenerated/subtrees, which are gitignored)domains/lilith/extras/generated/— frozen output from a generator pipeline that does not run in this monorepo; treat as source-of-truth for downstream consumers (e.g.,libs/lilith/sdkreadsmaster-openapi.yamlfrom here)
Reorg history#
The current layout was reached over an 11-commit reorganization (Phases 0–8).
The plan, regex rules, and per-phase rationale live in
reference/REORG_PLAN.md. The migration tool —
tools/docs/reorg.mjs — is preserved and can be re-run for incremental
cleanups.