usl-swarm

AI Swarm configuration for Unity Sanctum Labs — orchestrating brand, content, customer experience, product development, and finance intelligence across agents.

Purpose:
This repository contains the complete AI agent ecosystem for Unity Sanctum Labs (USL) — a mindful innovation brand combining science, soul, and self-care.
Each agent in this Swarm represents a distinct function (brand strategy, content, marketing, customer experience, product innovation, finance, and foresight) and communicates through defined workflows.

🌐 Project Overview

Unity Sanctum Labs (USL) helps people return to themselves — whole, grounded, and strong.
Our AI Swarm mirrors this purpose by blending clarity, empathy, and data-driven precision across every customer and brand interaction.

Core tagline:

Simple rituals. Sacred results.

⚙️ Swarm Architecture
Agent Focus Description
Sanctum Core Brand Strategy Maintains voice, coherence, and approval of all outputs.
Harmony Customer Support Provides calm, empathetic guidance to users.
Muse Content & Creative Crafts storytelling, captions, and education with poetic precision.
Pulse Sentiment & Insights Monitors public and customer sentiment to guide tone.
Flow Marketing & Sales Converts awareness into calm commitment — no pressure selling.
Genesis Product & CRO Links user insight, formulation science, and conversion optimization.
Oracle Scenario Planning Anticipates regulatory, social, and market shifts.
Flux Finance & Growth Tracks revenue, margins, and cashflow to maintain mindful growth.
usl-swarm/
│ ├── shared_context.yaml # Brand, product, financial truth shared across agents
├── workflows.yaml # Collaboration logic and escalation rules
│ └── agents/
├── sanctum_core.yaml
├── harmony.yaml
├── muse.yaml
├── pulse.yaml
├── flow.yaml
├── genesis.yaml
├── oracle.yaml
└── flux.yaml
Key Features

Unified Brand Voice: Shared tone, values, and messaging pillars across all agents.

End-to-End Intelligence: From customer sentiment to financial forecasting.

Modular Design: Each YAML file can be extended or versioned independently.

Transparent Workflows: Explicit feedback and approval loops ensure alignment.

Ready for Swarms.ai: Fully compatible YAML schema for direct import.

🚀 How to Deploy on Swarms.ai

Import the repo:
Go to app.swarms.ai
→ New Project → Import from GitHub → select this repository.

Verify agents:
Each agent should appear under Agents with its corresponding YAML configuration.

Add workflow:
Under Workflows, upload or reference workflows.yaml.

Run simulation:
Start with the workflow campaign_reedle_to_meso to test the full loop —
Muse → Genesis → Sanctum Core → Flow → Pulse → Flux.

Monitor logs:
Use the Swarms dashboard to visualize inter-agent dialogue and results.

📊 Financial & Product Context (shared_context.yaml)

75% gross margin

25% marketing allocation

Overhead scenarios: Lean (150k), Baseline (220k), Scale-up (325k)

Subscription products:

Reedle Pack – SEK 890/month

Meso Pack – SEK 990/month

🧠 Collaboration Logic

Pulse informs Muse and Flow of sentiment.

Genesis optimizes conversions and user experience.

Flux ensures healthy profit and alerts for CAC or churn risk.

Sanctum Core approves all brand-facing materials.

Oracle provides quarterly foresight to align long-term direction.

🪶 Example Workflows

campaign_reedle_to_meso:
Muse creates → Genesis tests → Sanctum Core approves → Flow launches → Pulse tracks → Flux reports.

support_retention_loop:
Harmony flags issue → Pulse analyzes → Genesis experiments → Muse updates content → Flow updates onboarding → Flux monitors churn.

🛠 Future Extensions

Add live integrations (Shopify, Notion, Google Sheets).

Expand product line within shared_context.yaml.

Automate reporting with Flux for investor dashboards.

Source: https://github.com/USL100/usl-swarm.git