Canonical Registry (Phase D Updated)
Note: This is a live snapshot of the canonical paths registry. Manual sync from
~/system/specs/canonical-registry.md. Last updated: 2026-05-07 (ANVIL Phase D)Purpose: Industry-standard ITIL CMDB / Spotify Backstage pattern. Catalog of canonical paths, their owners, scope, and anti-drift rules. This is the authoritative source for "where does X belong" questions.
Tree Ownership Table
One row per major tree. These are the canonical locations — creating parallel structures elsewhere violates the registry.
| Tree | Purpose | Owner |
|---|---|---|
~/system/ | Orchestration runtime, daemons, tools, agents, specs, rules, hooks (git), schemas | John (orchestrator) |
~/business/ALAI-Holding-AS/ | Company state — clients, brand, products, sales, legal, org, processes, pipelines, web-worktrees | ALAI (CEO) |
~/business/ALAI-Tech-DOO/ | RS d.o.o. legal subsidiary (Bilko/Tok/Drop distribution) | ALAI Tech DOO |
~/personal/ | CEO Alem Basic personal scope (NOT business) | CEO (personal capacity) |
~/clients-external/ | Client-owned content + state, one tenant per subdir | Per client |
~/projects/ | Code repositories (libraries, internal tools, experiments) — ALAI internal engineering only | Per repo |
~/.claude/ | Claude Code harness (settings.json, hooks, agents, projects, memory, skills) | Anthropic Claude Code |
~/Library/ | macOS system and vendor-managed application state | OS / app vendors |
~/aisystem/ | Canonical infra deploy workspace (Cloudflare Pages/DNS, BookStack, Vault, fleet configs) | John, Mehanik gate reads this path |
~/backups/ | Tar archives + offsite backup source (7-day + 30-day retention) | John |
Phase D Additions (2026-05-07) — Final Tenant-Isolated Structure
~/business/
├── ALAI-Holding-AS/ (was ~/ALAI; symlink kept for 158 daemons grace)
└── ALAI-Tech-DOO/ (RS d.o.o. subsidiary, real legal entity)
~/personal/ (NEW — CEO scope, 9 typed dirs)
~/clients-external/ (NEW — 13 named clients + 1 variants umbrella)
~/companies SYMLINK → ~/system/agents/personas/ (10+ daemon backward compat)
~/system/agents/personas/ (12 personas)
~/projects/ (8 ALAI eng repos only)
Renamed for Disambiguation (Phase D)
~/business/ALAI-Holding-AS/architecture/→product-architecture/(was conflicting with~/system/architecture/)~/business/ALAI-Holding-AS/services/→service-catalog/(was conflicting with~/system/services/)~/business/ALAI-Holding-AS/templates/→doc-templates/(was conflicting with~/system/templates/)~/business/ALAI-Holding-AS/ufs/→products/unified-form-service/(deployed at forms.alai.no)
4-Way CLAUDE.md Scope Rules
CLAUDE.md files exist at 4 different scope levels. Each loads based on current working directory (CWD).
| File | Scope | Loads When | Purpose |
|---|---|---|---|
~/.claude/CLAUDE.md | User-global | Always loaded (all Claude Code sessions) | John's identity, ZAKONs, specialist routing, hard constraints |
~/CLAUDE.md | Home directory project | CWD = /Users/makinja | Orchestration mode guardrails, session boot protocol, routing one-liners |
~/system/CLAUDE.md | System tree project | CWD inside ~/system/ | System-specific build/deploy rules, tool usage |
~/business/ALAI-Holding-AS/CLAUDE.md | ALAI tree project | CWD inside ~/business/ALAI-Holding-AS/ | ALAI brand guidelines, client-facing constraints |
What MUST NOT Recreate
These paths were archived during ANVIL FS Sweep. Recreating them silently reintroduces filesystem chaos and split-brain drift.
From ~/system/ (archived):
~/system/archive/,~/system/deprecated/,~/system/deployments/,~/system/plans/~/system/clients/(migrated to ~/business/ALAI-Holding-AS/clients/)~/system/infrastructure/,~/system/internal/,~/system/legal/,~/system/org/~/system/pipeline/,~/system/processes/,~/system/products/,~/system/sales/,~/system/web/
Post-D additions (MUST NOT recreate):
~/companies/as a real directory tree (it's a symlink only, for backward compat)~/ALAI/as a real directory (it's a symlink only)~/projects/personal/(use~/personal/)~/projects/client/(use~/clients-external/)~/projects/Basicconsulting/(now at~/business/ALAI-Holding-AS/brand-surfaces/basicconsulting.no/)~/companies/BasicConsulting/AlemPersonal/(CEO content moved to~/personal/)
Live Deployments (post-D)
https://ucenje.alai.no←~/personal/scholarly/extracted tojohnatbasicas/ucenjerepo + Cloudflare Pageshttps://alai.no/ucenje/*→ 301 →https://ucenje.alai.no/(verified live)
References
- Decision Records:
~/system/architecture/decisions/ADR-022-anvil-fs-sweep-2026-05-07.md,ADR-023-anvil-tenant-restructure-2026-05-07.md - MC chain: #99710 (org audit parent), #99637 (mechanical sweep parent)
- Memory:
project_anvil_phase_d_done_2026-05-07.md,project_alai_entity_identity_clarified_2026-05-07.md