Skip to content
Agent Tree Knowledge Hub
Subscribe

Domain Architecture

Status: Production (6 active domains)

Overview

Section titled “Overview”

The agent system is organized into life domains, each with its own configuration, personality (SOUL.md), state files, automation scripts, and specialist agents. A CEO orchestrator aggregates all domains into an executive summary.

Domain Inventory

Section titled “Domain Inventory”
DomainColorStatusKey Integrations
FamilyAmber #F59E0BActiveSkylight, Google Calendar, Google Sheets
SchoolBlue #3B82F6ActiveCanvas LMS, ChromaDB RAG, Plaud/Whisper
WorkTeal #14B8A6ActiveGmail, LinkedIn
ConsultingPurple #8B5CF6ActiveGmail, CRM contacts
GrowthEmerald #10B981ActiveBrave Search, X API, docs site
AI FoundryRose #F43F5ENewCurriculum tracking, Google Docs

Directory Structure (per domain)

Section titled “Directory Structure (per domain)”
domains/{domain-name}/
├── config.yaml          # Domain configuration
├── SOUL.md              # Personality, values, communication style
├── CLAUDE.md            # Auto-generated session instructions
├── state/
│   ├── report.md        # Latest heartbeat report
│   ├── tasks.yaml       # Active tasks
│   └── {specific}.yaml  # e.g., grades.yaml, pipeline.yaml
├── memory/
│   └── {domain}-profile.md    # Accumulated knowledge
└── scripts/
    └── *.sh             # Automation scripts

config.yaml Schema

Section titled “config.yaml Schema”
name: "Domain Name"
slug: domain-slug
color: "#HexColor"
icon: "emoji"
owner: "owner-name"
status: active | paused | archived
priority: 1-5


tools:                    # MCP servers this domain uses
  - google-calendar
  - canvas-lms


specialists:              # Sub-agents
  - name: "Agent Name"
    role: "description"
    trigger: "cron or event"


schedules:                # Cron jobs
  - name: "Daily Sync"
    cron: "0 7 * * *"
    script: "scripts/sync.sh"


dashboards:
  - name: "Main Dashboard"
    url: "/domain-slug"

CEO Orchestration

Section titled “CEO Orchestration”

Aggregation Flow

Section titled “Aggregation Flow”
Domain heartbeats (4-6h intervals)
  └── Each domain runs domain-heartbeat.sh → updates state/report.md
       │
       ▼
ceo-aggregate.sh (nightly)
  └── Reads all domain reports → executive-summary.md
       │
       ▼
domain-sync.sh (every 15 min)
  └── Reads all configs + reports → state/domains.json
       │
       ▼
Nerve Center v5 /api/domains
  └── Serves to dashboard

Scripts

Section titled “Scripts”
ScriptSchedulePurpose
domain-heartbeat.sh4-6hLLM-powered domain check-in
ceo-aggregate.shNightlyExecutive summary compilation
domain-sync.shEvery 15 minLightweight JSON state generation
create-domain.shOn demandBootstrap new domain from template

Shared Services

Section titled “Shared Services”

CEO-level teams callable by any domain:

  • dev-team — code generation, debugging, deployment
  • presentation-agent — deck building (Deck Architect)
  • research-agent — deep research via multi-model pipeline
  • design-agent — UI/UX design decisions

Adding a New Domain

Section titled “Adding a New Domain”
  1. Run create-domain.sh {slug} to bootstrap directory structure
  2. Edit config.yaml with domain-specific settings
  3. Write SOUL.md with personality and values
  4. Create initial state files
  5. Add automation scripts
  6. Register in project registry
  7. Add route to Nerve Center dashboard
  8. Run domain-sync.sh to propagate