Skip to main content

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.

TreePurposeOwner
~/system/Orchestration runtime, daemons, tools, agents, specs, rules, hooks (git), schemasJohn (orchestrator)
~/business/ALAI-Holding-AS/Company state — clients, brand, products, sales, legal, org, processes, pipelines, web-worktreesALAI (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 subdirPer client
~/projects/Code repositories (libraries, internal tools, experiments) — ALAI internal engineering onlyPer repo
~/.claude/Claude Code harness (settings.json, hooks, agents, projects, memory, skills)Anthropic Claude Code
~/Library/macOS system and vendor-managed application stateOS / 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).

FileScopeLoads WhenPurpose
~/.claude/CLAUDE.mdUser-globalAlways loaded (all Claude Code sessions)John's identity, ZAKONs, specialist routing, hard constraints
~/CLAUDE.mdHome directory projectCWD = /Users/makinjaOrchestration mode guardrails, session boot protocol, routing one-liners
~/system/CLAUDE.mdSystem tree projectCWD inside ~/system/System-specific build/deploy rules, tool usage
~/business/ALAI-Holding-AS/CLAUDE.mdALAI tree projectCWD 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
Back to top