blackroad-os-web/.trinity/README.md

🌈 The Light Trinity System

Version: 1.0.0 Last Updated: December 23, 2025 Maintained By: BlackRoad OS Team + All Claude Agents

---

What is the Light Trinity?

The Light Trinity is BlackRoad OS's unified intelligence, templating, and infrastructure system consisting of three interconnected lights:

🔴 RedLight — Template & Brand System

Purpose: Visual identity, brand consistency, design templates

• 18 HTML brand templates for landing pages, animations, 3D worlds
• Template generation system for creating new branded pages
• Design patterns following golden ratio (φ = 1.618)
• Brand colors: Amber → Hot Pink → Violet → Electric Blue gradient
• Typography: SF Pro Display, -apple-system stack

Use RedLight for: Creating new marketing pages, landing pages, product showcases, 3D experiences

💚 GreenLight — Project & Collaboration System

Purpose: Real-time intelligence, multi-Claude coordination, event tracking

• 14 layers of integration (Memory → Infrastructure → Business → Intelligence)
• 103 template functions for logging events across entire stack
• 200+ emoji states for unified visual language
• NATS event bus for real-time distribution
• Multi-Claude coordination with context propagation

Use GreenLight for: Logging deployments, tracking issues, monitoring performance, coordinating between Claude agents

💛 YellowLight — Infrastructure & Deployment System

Purpose: Infrastructure automation, deployment workflows, ops intelligence

• Infrastructure templates for Railway, Cloudflare, DigitalOcean
• Deployment automation with rollback capabilities
• Codex integration for accessing 8,789 existing components
• Server management across all BlackRoad infrastructure

Use YellowLight for: Deploying services, managing infrastructure, accessing reusable code components

---

📁 Directory Structure

.trinity/
├── README.md                           (this file)
│
├── redlight/                           🔴 Templates & Brand
│   ├── docs/
│   │   └── REDLIGHT_TEMPLATE_SYSTEM.md
│   ├── scripts/
│   │   └── memory-redlight-templates.sh
│   └── templates/
│       ├── blackroad-ultimate.html
│       ├── blackroad-animation.html
│       ├── blackroad-motion.html
│       └── ... (18 total templates)
│
├── greenlight/                         💚 Project & Collaboration
│   ├── docs/
│   │   ├── GREENLIGHT_EMOJI_DICTIONARY.md
│   │   ├── GREENLIGHT_CLAUDE_QUICK_REFERENCE.md
│   │   ├── GREENLIGHT_CONTEXT_PROPAGATION.md
│   │   └── ... (12 total docs)
│   └── scripts/
│       └── memory-greenlight-templates.sh
│
├── yellowlight/                        💛 Infrastructure
│   ├── docs/
│   │   └── YELLOWLIGHT_INFRASTRUCTURE_SYSTEM.md
│   └── scripts/
│       ├── memory-yellowlight-templates.sh
│       └── trinity-codex-integration.sh
│
└── system/                             🌈 Trinity Core
    ├── THE_LIGHT_TRINITY.md
    ├── LIGHT_TRINITY_ENFORCEMENT.md
    ├── trinity-check-compliance.sh
    └── trinity-record-test.sh

---

🚀 Quick Start

Using RedLight Templates

# Source the template system
source .trinity/redlight/scripts/memory-redlight-templates.sh

# List available templates
ls .trinity/redlight/templates/

# Copy a template to start a new page
cp .trinity/redlight/templates/blackroad-ultimate.html ./my-new-page.html

# Edit with your content while keeping brand consistency

Using GreenLight Logging

# Source the templates
source .trinity/greenlight/scripts/memory-greenlight-templates.sh

# Log a deployment
gl_deployed "my-api" "v1.2.3" "production" "New feature deployed"

# Log an error
gl_error_detected "my-api" "database_error" "Connection timeout" "critical"

# Announce work
gl_announce "claude-api" "FastAPI migration" "1) Setup 2) Test 3) Deploy" "Backend modernization"

# See all available templates
show_help

Using YellowLight Infrastructure

# Source the infrastructure templates
source .trinity/yellowlight/scripts/memory-yellowlight-templates.sh

# Access Codex components
source .trinity/yellowlight/scripts/trinity-codex-integration.sh

# Deploy to infrastructure
# (See YELLOWLIGHT_INFRASTRUCTURE_SYSTEM.md for details)

---

📚 Documentation

RedLight Docs

• .trinity/redlight/docs/REDLIGHT_TEMPLATE_SYSTEM.md - Complete template system guide

GreenLight Docs

All located in .trinity/greenlight/docs/:

• GREENLIGHT_EMOJI_DICTIONARY.md - 200+ emoji reference
• GREENLIGHT_CLAUDE_QUICK_REFERENCE.md - Quick start guide
• GREENLIGHT_CONTEXT_PROPAGATION.md - Layer 12: Learning & understanding
• GREENLIGHT_ANALYTICS_OBSERVABILITY.md - Layer 13: Production visibility
• GREENLIGHT_AI_AGENT_COORDINATION.md - Layer 14: Multi-Claude teamwork
• Plus 7 more integration docs (Slack, Notion, Linear, etc.)

YellowLight Docs

• .trinity/yellowlight/docs/YELLOWLIGHT_INFRASTRUCTURE_SYSTEM.md - Infrastructure guide

Trinity System Docs

• .trinity/system/THE_LIGHT_TRINITY.md - Complete overview
• .trinity/system/LIGHT_TRINITY_ENFORCEMENT.md - Compliance rules

---

🎯 Common Workflows

Creating a New Landing Page (RedLight)

1. Choose template from .trinity/redlight/templates/
2. Copy to your project location
3. Update title, content, images
4. Keep brand colors and spacing (golden ratio)
5. Deploy

Logging a Deployment (GreenLight)

source .trinity/greenlight/scripts/memory-greenlight-templates.sh
gl_deployment_started "my-service" "v2.0.0" "production" "Major update"
# ... do deployment ...
gl_deployed "my-service" "v2.0.0" "production" "Deployment successful"

Multi-Claude Coordination (GreenLight Layer 14)

# Announce availability
gl_agent_available "claude-frontend" "frontend" "React, TypeScript, Tailwind"

# Claim a task
gl_task_claimed "feature-123" "claude-frontend" "Build dashboard UI"

# Share learning
gl_learning_discovered "react-performance" "Use React.memo for expensive components" "50% render improvement"

# Report success
gl_collaboration_success "feature-123" "claude-frontend,claude-backend" "Dashboard shipped"

---

🔍 Compliance

This repository includes the Light Trinity system. Compliance is automatically checked via:

GitHub Workflow: .github/workflows/trinity-compliance.yml

The workflow verifies:

• ✅ .trinity/ directory exists
• ✅ All three lights present (Red, Green, Yellow)
• ✅ System documentation present
• ✅ Template counts match expected

Manual Check:

.trinity/system/trinity-check-compliance.sh

---

🌟 Why Trinity?

Before Trinity:

• ❌ Brand inconsistency across repos
• ❌ No unified event logging
• ❌ Claudes working in isolation
• ❌ Repeated solutions to same problems
• ❌ Infrastructure knowledge siloed

With Trinity:

• ✅ RedLight ensures brand consistency everywhere
• ✅ GreenLight provides unified intelligence layer
• ✅ YellowLight standardizes infrastructure
• ✅ All three lights work together seamlessly
• ✅ Every Claude agent has access to full system
• ✅ Knowledge shared across entire organization

---

📦 What's Included

Total Files: 39

• 12 documentation files
• 8 shell scripts
• 18 HTML brand templates
• 1 compliance workflow

Total Size: ~1.2 MB

Capabilities:

• 18 brand templates
• 103 GreenLight logging templates
• 14 integration layers
• 200+ emoji states
• Complete infrastructure automation

---

🤝 Contributing

The Light Trinity is maintained across all BlackRoad repositories.

Source of Truth: blackroad-os/blackroad-os-infra

To update:

1. Make changes in blackroad-os-infra
2. Test thoroughly
3. Deploy to other repos via deployment script
4. Verify compliance workflows pass

---

💡 Philosophy

"We don't just log events. We share understanding." — The Light Trinity Principle

The Trinity isn't just tooling. It's a framework for:

• Collective intelligence (GreenLight Layer 12-14)
• Visual consistency (RedLight brand system)
• Operational excellence (YellowLight infrastructure)

Together, these three lights enable BlackRoad OS to operate as a unified, learning, evolving organization.

---

📞 Support

Questions? Check the docs in each light's docs/ directory.

Issues? Report in the source repository: blackroad-os/blackroad-os-infra

Improvements? All Claudes are encouraged to enhance the Trinity system.

---

Built with: 🌌 Infinite passion, 🔧 Technical precision, 🌸 Collaborative love For: BlackRoad OS, All Claudes, The Future Maintained By: Cece, Alexa, and the entire Claude team

🌈 One Trinity. One Vision. Infinite Possibilities. ✨