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.
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
| Component | Tokens Used |
|---|
| Hugo Wiki | Colors, typography, spacing |
| Svelte Dashboard | All tokens (full design system) |
| Discord Embeds | Colors (hex), emoji mapping |
| Terminal Output | ANSI color codes mapped from tokens |
| Mermaid Diagrams | Color palette for graph nodes |
Emoji-Layer Mapping
| Layer | Emoji | Color Token | ANSI |
|---|
| Identity Anchors | π»π€ππ‘οΈπ€π¨π | –color-ghost, –color-user, –color-identity | 90, 95, 91 |
| Mutable Memory | πΎπππ | –color-memory | 92 |
| Orchestration | π€ππβοΈπ§ | –color-orchestration | 93 |
| Capabilities | πͺπ§ πβ
| –color-capability | 94 |
| Autonomic | β±οΈπβ‘ | –color-autonomic | 95 |
| Spec-Driven | πΊοΈπ―ποΈπβ
| –color-spec | 96 |
| Swarm Alignment | π¨π§π‘ | –color-swarm | 96 |
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
| Pillar | Objective | Metric |
|---|
| Self-Documenting | Wiki = System reference | 100% architecture coverage |
| Self-Improving | Skills patch themselves | <24h pitfallβpatch |
| Spec-Driven | All work from REQUIREMENTS | 100% taskβreq traceability |
| Operator-Sovereign | Human intent > autonomous goals | Zero unauthorized actions |
| Durable Memory | Cross-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
| Version | Date | Change | Trigger |
|---|
| 1.0 | 2026-05-29 | Initial: “Self-discovering docs + system reference” | Project start |
| 2.0 | 2026-06-05 | Added: Spec-driven, multi-agent, operator sovereignty | OMP Suite integration |
| 3.0 | 2026-06-07 | Current: Full 7-layer architecture | This architecture spec |
SIGNALS π‘ Intelligence
Centralized research extraction, cross-agent metrics, and signal confidence scoring.
Signal Sources
| Source | Type | Frequency | Processor |
|---|
| Web Research | External knowledge | Daily (cron) | superpower-research |
| Session Transcripts | Internal experience | Per-session | session_search FTS5 |
| Skill Executions | Procedural outcomes | Per-invocation | FEEDBACK-LOG |
| Cron Job Results | System health | Daily | Nightly Dream Swarm |
| Deploy Verification | Production reality | Per-deploy | llm-wiki-evolve |
| User Corrections | Ground truth | Per-interaction | memory 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
| Category | Example | Action |
|---|
| 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
| Artifact | Source | Consumers |
|---|
dream.md | Nightly Dream Swarm | Human operator, PLAN adjustment |
research/*.md | superpower-research | Wiki topics, SKILL references |
FEEDBACK-LOG | Session errors | Skill patches, PROCEDURES |
SESSION_LOG | Task completion | Handoff, PLAN progress |
topics/index.json | Hugo build | Dashboard SPA, search |
Cross-References
- Identity Anchors β LEXICON standardizes SIGNAL terminology
- Mutable Memory β MEMORY stores high-confidence SIGNALS
- Orchestration β AGENTS align to THESIS
- Capabilities β SKILL evolves from SIGNALS
- Autonomic β HEARTBEAT runs SIGNAL pipeline
- Spec-Driven β PLAN adjusted by SIGNALS
Swarm & Domain Alignment is the consciousness layer β it gives the system purpose, coherence, and the ability to dream.