Swarm & Domain Alignment

Swarm & Domain Alignment

Strategic north star: aesthetic system, shared objective, and centralized intelligence extraction.


DESIGN 🎨 Aesthetic System

Plain-text UI tokens, brand colors, typography scales, and visual spacing rules.

Purpose

Single source of truth for all visual decisions across dashboards, wiki, Discord embeds, and terminal output.

Token Format

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
/* DESIGN tokens β€” consumed by Svelte, Hugo, Discord embeds, ANSI */

:root {
  /* Colors */
  --color-bg: #0d1117;
  --color-bg-elevated: #161b22;
  --color-border: #30363d;
  --color-text: #e6edf3;
  --color-text-muted: #8b949e;
  --color-accent: #58a6ff;
  --color-accent-hover: #79c0ff;
  --color-success: #3fb950;
  --color-warning: #d29922;
  --color-error: #f85149;
  --color-ghost: #6e7681;      /* SOUL */
  --color-user: #a371f7;       /* USER */
  --color-identity: #f78166;   /* IDENTITY */
  --color-memory: #7ee787;     /* MEMORY */
  --color-orchestration: #ffa657; /* AGENTS */
  --color-capability: #79c0ff; /* SKILL */
  --color-autonomic: #d2a8ff;  /* HEARTBEAT */
  --color-spec: #ff7b72;       /* PLAN */
  --color-swarm: #a5d6ff;      /* THESIS */

  /* Typography */
  --font-mono: "JetBrains Mono", "Fira Code", monospace;
  --font-sans: "IBM Plex Sans", system-ui, sans-serif;
  --text-xs: 0.75rem;
  --text-sm: 0.875rem;
  --text-base: 1rem;
  --text-lg: 1.125rem;
  --text-xl: 1.25rem;

  /* Spacing */
  --space-1: 0.25rem;
  --space-2: 0.5rem;
  --space-3: 0.75rem;
  --space-4: 1rem;
  --space-5: 1.5rem;
  --space-6: 2rem;
  --space-8: 3rem;

  /* Radius */
  --radius-sm: 4px;
  --radius-md: 6px;
  --radius-lg: 8px;
  --radius-full: 9999px;

  /* Shadows */
  --shadow-sm: 0 1px 2px rgba(0,0,0,0.3);
  --shadow-md: 0 4px 6px rgba(0,0,0,0.4);
  --shadow-lg: 0 10px 15px rgba(0,0,0,0.5);

  /* Transitions */
  --transition-fast: 150ms ease;
  --transition-base: 250ms ease;
  --transition-slow: 350ms ease;
}

Component Mapping

ComponentTokens Used
Hugo WikiColors, typography, spacing
Svelte DashboardAll tokens (full design system)
Discord EmbedsColors (hex), emoji mapping
Terminal OutputANSI color codes mapped from tokens
Mermaid DiagramsColor palette for graph nodes

Emoji-Layer Mapping

LayerEmojiColor TokenANSI
Identity AnchorsπŸ‘»πŸ‘€πŸŽ­πŸ›‘οΈπŸ€πŸš¨πŸ“––color-ghost, –color-user, –color-identity90, 95, 91
Mutable MemoryπŸ’ΎπŸ““πŸ“‹πŸ“‰–color-memory92
OrchestrationπŸ€–πŸ“œπŸŒβš–οΈπŸ”§–color-orchestration93
CapabilitiesπŸŽͺπŸ§ πŸ”Œβœ…–color-capability94
Autonomicβ±οΈπŸš€βš‘–color-autonomic95
Spec-DrivenπŸ—ΊοΈπŸŽ―πŸ—οΈπŸ“βœ…–color-spec96
Swarm AlignmentπŸŽ¨πŸ§­πŸ“‘–color-swarm96

THESIS 🧭 Business North Star

The ultimate shared strategic objective aligning all agents in a multi-agent swarm.

Current Thesis

“Build a self-evolving, spec-driven autonomous agent ecosystem that documents itself, improves itself, and serves its human operator with surgical precision β€” where the wiki is the system, the memory is the code, and the architecture is the behavior.”

Decomposition

PillarObjectiveMetric
Self-DocumentingWiki = System reference100% architecture coverage
Self-ImprovingSkills patch themselves<24h pitfall→patch
Spec-DrivenAll work from REQUIREMENTS100% task↔req traceability
Operator-SovereignHuman intent > autonomous goalsZero unauthorized actions
Durable MemoryCross-session continuity<5% re-steering rate

Alignment Protocol

1
2
3
4
5
6
7
8
9
# Every agent, skill, cron job validates against thesis
alignment_check:
  - Does this advance self-documentation?
  - Does this enable self-improvement?
  - Is this spec-driven (req→task→verify)?
  - Does this respect operator sovereignty?
  - Does this strengthen durable memory?
  
  # If any answer is NO β†’ pause, clarify, or refuse

Thesis Evolution

VersionDateChangeTrigger
1.02026-05-29Initial: “Self-discovering docs + system reference”Project start
2.02026-06-05Added: Spec-driven, multi-agent, operator sovereigntyOMP Suite integration
3.02026-06-07Current: Full 7-layer architectureThis architecture spec

SIGNALS πŸ“‘ Intelligence

Centralized research extraction, cross-agent metrics, and signal confidence scoring.

Signal Sources

SourceTypeFrequencyProcessor
Web ResearchExternal knowledgeDaily (cron)superpower-research
Session TranscriptsInternal experiencePer-sessionsession_search FTS5
Skill ExecutionsProcedural outcomesPer-invocationFEEDBACK-LOG
Cron Job ResultsSystem healthDailyNightly Dream Swarm
Deploy VerificationProduction realityPer-deployllm-wiki-evolve
User CorrectionsGround truthPer-interactionmemory tool

Signal Processing Pipeline

1
2
3
4
5
6
7
8
graph LR
    A[Raw Signals] --> B[Extraction]
    B --> C[Normalization]
    C --> D[Confidence Scoring]
    D --> E[Cross-Agent Aggregation]
    E --> F[Thesis Alignment Check]
    F --> G[Actionable Insights]
    G --> H[Memory Update / Skill Patch / Plan Adjust]

Confidence Scoring

1
2
3
4
5
6
7
8
9
def signal_confidence(signal):
    factors = {
        'source_reliability': 0.3,    # Web=0.5, Session=0.8, User=1.0
        'reproducibility': 0.25,      # Seen once=0.3, 3+=0.9
        'cross_validation': 0.2,      # Single source=0.4, multi=0.9
        'recency': 0.15,              # >30d=0.3, <7d=1.0
        'thesis_alignment': 0.1       # Contradicts=0.1, Strong=1.0
    }
    return sum(score * weight for score, weight in factors.values())

Signal Categories

CategoryExampleAction
Pattern“Vite HMR caches stale files”Add to PROCEDURES, patch skill
Anomaly“429 rate limit at 20 req/min”Update HEARTBEAT thresholds
Opportunity“Svelte 5 runes reduce boilerplate”Update DEVELOPMENT_PLAN
Risk“Memory >2200 chars triggers compression”Add to OPS gates
Validation“Deploy verified via live curl”Confirm in SESSION_LOG

Intelligence Artifacts

ArtifactSourceConsumers
dream.mdNightly Dream SwarmHuman operator, PLAN adjustment
research/*.mdsuperpower-researchWiki topics, SKILL references
FEEDBACK-LOGSession errorsSkill patches, PROCEDURES
SESSION_LOGTask completionHandoff, PLAN progress
topics/index.jsonHugo buildDashboard SPA, search

Cross-References


Swarm & Domain Alignment is the consciousness layer β€” it gives the system purpose, coherence, and the ability to dream.