create-domain

create-domain

Domain lifecycle management for the PAL Second Brain vault. Domains live under domains/ and provide structured, isolated workspaces for distinct areas of life and work.

Domain Structure

Every domain follows this structure:

domains/[DomainName]/
├── INDEX.md          # Domain entry point (MOC with wikilinks)
├── CONNECTIONS.yaml  # External integrations config (APIs, docs, data sources)
├── 01_PROJECTS/      # Active project files (PROJECT_*.md)
├── 02_PAGES/         # Knowledge processed and archived within the domain, routed from the inbox
└── 03_ARCHIVE/       # Completed/deprecated content

Naming Conventions

| Item | Convention | Example | |------|-----------|---------| | Domain directory | PascalCase | LaraLou/, PalFramework/ | | Domain subfolders | NN_ALLCAPS | 01_PROJECTS/, 02_PAGES/ | | INDEX.md | UPPERCASE.md | INDEX.md | | CONNECTIONS.yaml | UPPERCASE.yaml | CONNECTIONS.yaml | | Project files | PROJECT_UPPER_SNAKE.md | PROJECT_Q2_LAUNCH.md | | Page files | kebab-case.md | meeting-notes-april.md | | Archive files | Preserve original name | No renaming |

Workflow Routing

| Workflow | Trigger | File | |----------|---------|------| | create-domain | "create domain", "new domain" | workflows/create-domain.md | | validate-domain | "validate domain", "check domain" | workflows/validate-domain.md | | map-domain | "map domain", "sync domain", "housekeeping" | workflows/map-domain.md | | archive-domain | "archive domain", "deprecate domain" | workflows/archive-domain.md |

Examples

Example 1: Create a new domain

User: "Create a domain for my Substack project"
-> Invokes create-domain workflow
-> Asks for name + description
-> Creates domains/Substack/ with 01_PROJECTS/, 02_PAGES/, 03_ARCHIVE/ and CONNECTIONS.yaml
-> Generates INDEX.md with frontmatter + MOC structure + wikilinks
-> Updates CLAUDE.md domain registry

Example 2: Validate domain structure

User: "Check my LaraLou domain"
-> Invokes validate-domain workflow
-> Verifies folder structure, naming conventions, frontmatter
-> Reports issues with suggested fixes

Example 3: Sync domain after session

User: "Map the Pal domain"
-> Invokes map-domain workflow
-> Scans all folders, enforces naming
-> Refreshes INDEX.md Active Work table from 01_PROJECTS/
-> Reports summary