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 to johnatbasicas/ucenje repo + Cloudflare Pages
https://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