diff --git a/infra/INFRASTRUCTURE_REGISTRY.md b/infra/INFRASTRUCTURE_REGISTRY.md new file mode 100644 index 0000000..ec17051 --- /dev/null +++ b/infra/INFRASTRUCTURE_REGISTRY.md @@ -0,0 +1,382 @@ +# BlackRoad OS Infrastructure Registry + +**Version:** 1.0.0 +**Last Updated:** 2025-11-28 +**Owner:** Alexa Louise Amundson (Operator) +**Status:** Production Active + +--- + +## Overview + +This document is the **single source of truth** for all BlackRoad OS infrastructure: +- Domain portfolio +- GitHub organizations +- Railway services +- Cloudflare configurations +- Service mappings + +--- + +## 1. Domain Portfolio (16 Domains) + +### Cluster A: OS Layer (Primary) + +| Domain | Purpose | Hosting | Status | +|--------|---------|---------|--------| +| **blackroad.systems** | OS backend, services, APIs | Railway | Active | + +### Cluster B: Brand/Frontend Layer + +| Domain | Purpose | Hosting | Status | +|--------|---------|---------|--------| +| **blackroad.io** | Consumer-facing UI | Pages + Railway | Active | +| **blackroad.me** | Personal brand site | Pages | Reserved | +| **blackroad.network** | Social/identity layer | TBD | Reserved | +| **blackroadai.com** | AI-focused public brand | Pages | Reserved | +| **blackroadinc.us** | Corporate presence | Pages | Reserved | + +### Cluster C: Quantum Layer + +| Domain | Purpose | Hosting | Status | +|--------|---------|---------|--------| +| **blackroadquantum.com** | Quantum roadmap | TBD | Reserved | +| **blackroadquantum.net** | Quantum API layer | Railway | Reserved | +| **blackroadquantum.info** | Quantum documentation | Pages | Reserved | +| **blackroadquantum.shop** | Quantum merchandise | E-commerce | Reserved | +| **blackroadquantum.store** | Quantum merchandise | E-commerce | Reserved | + +### Cluster D: Lucidia Layer + +| Domain | Purpose | Hosting | Status | +|--------|---------|---------|--------| +| **lucidia.earth** | Lucidia worldspace | Pages | Reserved | +| **lucidiaqi.com** | Lucidia + QI identity | Pages | Reserved | +| **lucidia.studio** | Lucidia creative tools | Pages | Active | + +### Cluster E: QI Layer + +| Domain | Purpose | Hosting | Status | +|--------|---------|---------|--------| +| **blackroadqi.com** | QI math layer | TBD | Reserved | +| **aliceqi.com** | Personal AI identity | TBD | Reserved | + +--- + +## 2. GitHub Organization Map (17 Orgs) + +### Enterprise + +| Organization | Type | Purpose | +|--------------|------|---------| +| **BlackRoad OS, Inc.** | Enterprise | Parent umbrella, SSO, billing | + +### Core Organizations + +| Organization | Purpose | Priority | +|--------------|---------|----------| +| **BlackRoad-OS** | Main OS kernel, services, agents | HIGHEST | +| **BlackRoad-Cloud** | Infrastructure, IaC, deployment | HIGH | +| **BlackRoad-AI** | LLM agents, AI frameworks | HIGH | + +### Supporting Organizations + +| Organization | Purpose | Layer | +|--------------|---------|-------| +| **BlackRoad-Labs** | R&D, math, quantum, experiments | Research | +| **BlackRoad-Media** | Brand, graphics, creative assets | Creative | +| **BlackRoad-Studio** | Design engineering, editors | Creative | +| **BlackRoad-Security** | Zero-trust, auth, threats | Security | +| **BlackRoad-Gov** | Compliance, FINRA, regulation | Compliance | +| **BlackRoad-Ventures** | Startup arm, revenue ops | Commercial | +| **BlackRoad-Foundation** | Non-profit, ethics, AI safety | Mission | +| **BlackRoad-Education** | Learning portals, training | Education | +| **BlackRoad-Hardware** | Pi fleet, IoT, embedded | Hardware | +| **BlackRoad-Interactive** | Games, VR, 3D worlds | Interactive | +| **BlackRoad-Archive** | Legacy repos, backups | Archive | +| **Blackbox-Enterprises** | Legacy parent org | Deprecated | + +--- + +## 3. BlackRoad-OS Repository Map (25 Repos) + +### Core Layer (Kernel) + +| Repo | Railway Service | Domain | Purpose | +|------|-----------------|--------|---------| +| `blackroad-os-core` | blackroad-os-core-production | core.blackroad.systems | Main OS app | +| `blackroad-os-api` | blackroad-os-api-production | api.blackroad.systems | Operator API | +| `blackroad-os-api-gateway` | blackroad-os-api-gateway-production | - | API gateway | +| `blackroad-os-web` | blackroad-os-web-production | web.blackroad.systems | Public backend | +| `blackroad` | blackroad-production | - | Legacy monolith | +| `blackroad-os-master` | blackroad-os-master-production | - | Master controller | + +### Automation Layer + +| Repo | Railway Service | Domain | Purpose | +|------|-----------------|--------|---------| +| `blackroad-os-operator` | blackroad-os-operator-production | operator.blackroad.systems | Orchestrator | +| `blackroad-os-beacon` | blackroad-os-beacon-production | - | Telemetry | +| `blackroad-os-infra` | blackroad-os-infra-production | infra.blackroad.systems | IaC | +| `blackroad-os-archive` | blackroad-os-archive-production | - | Append-only logs | + +### Pack Layer (Modular Apps) + +| Repo | Railway Service | Purpose | +|------|-----------------|---------| +| `blackroad-os-pack-research-lab` | pack-research-lab-production | R&D tools | +| `blackroad-os-pack-legal` | pack-legal-production | Legal compliance | +| `blackroad-os-pack-infra-devops` | pack-infra-devops-production | CI/CD | +| `blackroad-os-pack-finance` | pack-finance-production | Billing | +| `blackroad-os-pack-education` | pack-education-production | Training | +| `blackroad-os-pack-creator-studio` | pack-creator-studio-production | Design tools | + +### Intelligence Layer + +| Repo | Railway Service | Purpose | +|------|-----------------|---------| +| `blackroad-os-agents` | - | Agent manifests | +| `blackroad-os-ideas` | blackroad-os-ideas-production | Idea backlog | +| `blackroad-os-research` | blackroad-os-research-production | Math research | + +### Brand Layer + +| Repo | Railway Service | Domain | Purpose | +|------|-----------------|--------|---------| +| `blackroad-os-brand` | blackroad-os-brand-production | - | Brand system | +| `blackroad-os-home` | blackroad-os-home-production | - | Company handbook | +| `blackroad-os-docs` | blackroad-os-docs-production | docs.blackroad.systems | Documentation | + +### UI/Admin Layer + +| Repo | Railway Service | Domain | Purpose | +|------|-----------------|--------|---------| +| `blackroad-os-demo` | blackroad-os-demo-production | - | Demo site | +| `blackroad-os-prism-console` | blackroad-os-prism-console-production | console.blackroad.systems | Admin console | + +--- + +## 4. Railway Configuration + +### Project Details + +``` +Project ID: 03ce1e43-5086-4255-b2bc-0146c8916f4c +Dashboard: https://railway.com/project/03ce1e43-5086-4255-b2bc-0146c8916f4c +Environment: production +``` + +### Service Contract + +Every Railway service MUST implement: + +```yaml +endpoints: + - path: /health + method: GET + response: { "status": "ok" } + + - path: /version + method: GET + response: { "version": "x.y.z", "commit": "", "service": "" } + +requirements: + - Dockerfile or Nixpacks + - Bind to $PORT environment variable + - Production start command (not dev mode) + - railway.json configuration +``` + +### Railway Service URLs (Production) + +| Service | Railway URL | +|---------|-------------| +| blackroad-os | blackroad-os-production.up.railway.app | +| blackroad-os-api | blackroad-os-api-production-ff5a.up.railway.app | +| blackroad-os-core | blackroad-os-core-production.up.railway.app | +| blackroad-os-web | blackroad-os-web-production.up.railway.app | +| blackroad-os-operator | blackroad-os-operator-production.up.railway.app | +| blackroad-os-docs | blackroad-os-docs-production.up.railway.app | +| blackroad-os-prism-console | blackroad-os-prism-console-production.up.railway.app | + +--- + +## 5. Cloudflare DNS Configuration + +### blackroad.systems (Backend OS) + +| Type | Name | Target | Proxy | +|------|------|--------|-------| +| CNAME | @ | blackroad-operating-system-production.up.railway.app | ON | +| CNAME | www | blackroad.systems | ON | +| CNAME | api | blackroad-os-api-production-ff5a.up.railway.app | ON | +| CNAME | app | blackroad-operating-system-production.up.railway.app | ON | +| CNAME | console | blackroad-os-prism-console-production.up.railway.app | ON | +| CNAME | core | blackroad-os-core-production.up.railway.app | ON | +| CNAME | docs | blackroad-os-docs-production.up.railway.app | ON | +| CNAME | infra | blackroad-os-infra-production.up.railway.app | ON | +| CNAME | operator | blackroad-os-operator-production.up.railway.app | ON | +| CNAME | os | blackroad-os-root-production.up.railway.app | ON | +| CNAME | prism | blackroad-prism-console-production.up.railway.app | ON | +| CNAME | research | blackroad-os-research-production.up.railway.app | ON | +| CNAME | web | blackroad-os-web-production.up.railway.app | ON | + +### blackroad.io (Frontend UI) + +| Type | Name | Target | Proxy | +|------|------|--------|-------| +| CNAME | @ | blackroad-operating-system-production.up.railway.app | ON | +| CNAME | www | blackroad.io | ON | +| CNAME | api | blackroad-os-api.pages.dev | ON | +| CNAME | brand | blackroad-os-brand.pages.dev | ON | +| CNAME | chat | nextjs-ai-chatbot.pages.dev | ON | +| CNAME | console | blackroad-os-prism-console.pages.dev | ON | +| CNAME | dashboard | blackroad-os-operator.pages.dev | ON | +| CNAME | demo | blackroad-os-demo.pages.dev | ON | +| CNAME | docs | blackroad-os-docs.pages.dev | ON | +| CNAME | operator | blackroad-os-operator.pages.dev | ON | +| CNAME | prism | blackroad-os-prism-console.pages.dev | ON | +| CNAME | studio | lucidia.studio.pages.dev | ON | +| CNAME | web | blackroad-os-web.pages.dev | ON | + +### Cloudflare Settings + +```yaml +ssl_mode: Full (Strict) +always_https: true +min_tls_version: "1.2" +automatic_https_rewrites: true +brotli: true +auto_minify: true +``` + +--- + +## 6. Agent Registry + +### Current Agent Count: 300 + +| Tier | Range | Count | Purpose | +|------|-------|-------|---------| +| Executive | 1-5 | 5 | C-suite decision makers | +| Operational | 6-25 | 20 | Department heads | +| Supporting | 26-50 | 25 | Specialists | +| Specialist | 51-75 | 25 | Domain experts | +| Swarm | 76-100 | 25 | Task executors | +| Governance | 101-115 | 15 | Policy & compliance | +| Intelligence | 116-140 | 25 | Analytics & insights | +| Infrastructure | 141-165 | 25 | DevOps & systems | +| Commerce | 166-185 | 20 | Business operations | +| Ecosystem | 186-200 | 15 | Platform & community | +| Defense | 201-220 | 20 | Security & protection | +| Knowledge | 221-240 | 20 | Documentation & learning | +| Creative | 241-260 | 20 | Design & content | +| Quality | 261-280 | 20 | Testing & QA | +| Innovation | 281-300 | 20 | R&D & experimentation | + +### Agent Registry Location +``` +/Users/alexa/projects/blackroad-os-agents-work/registry/agents.json +``` + +--- + +## 7. Brand System + +### Colors + +| Name | Hex | Usage | +|------|-----|-------| +| Orange | #FF9D00 | Primary accent | +| Deep Orange | #FF6B00 | Primary gradient | +| Hot Pink | #FF0066 | Secondary accent | +| Magenta Pink | #FF006B | Tertiary accent | +| Magenta | #D600AA | Gradient mid | +| Electric Purple | #7700FF | Gradient transition | +| Electric Blue | #0066FF | Secondary accent | + +### Gradient + +```css +--br-gradient: linear-gradient(135deg, #FF9D00, #FF6B00, #FF0066, #D600AA, #7700FF, #0066FF); +``` + +--- + +## 8. Deployment Checklist + +### New Railway Service + +- [ ] Create repo in BlackRoad-OS org +- [ ] Add `Dockerfile` +- [ ] Add `railway.json` +- [ ] Implement `/health` endpoint +- [ ] Implement `/version` endpoint +- [ ] Bind to `$PORT` environment variable +- [ ] Connect repo to Railway +- [ ] Add CNAME in Cloudflare +- [ ] Verify health check +- [ ] Document in this registry + +### New Cloudflare Pages Site + +- [ ] Create repo in appropriate org +- [ ] Add build configuration +- [ ] Connect to Cloudflare Pages +- [ ] Add CNAME in Cloudflare +- [ ] Verify site loads +- [ ] Document in this registry + +--- + +## 9. Quick Reference + +### Railway CLI + +```bash +# Login +railway login + +# Link to project +railway link 03ce1e43-5086-4255-b2bc-0146c8916f4c + +# Check status +railway status + +# View logs +railway logs --service + +# Redeploy +railway up --service +``` + +### Health Check Script + +```bash +#!/bin/bash +for domain in api core operator console docs web; do + status=$(curl -s -o /dev/null -w "%{http_code}" "https://$domain.blackroad.systems/health") + echo "$domain: $status" +done +``` + +### DNS Verification + +```bash +dig api.blackroad.systems +short +dig core.blackroad.systems +short +dig operator.blackroad.systems +short +``` + +--- + +## 10. Document History + +| Version | Date | Author | Changes | +|---------|------|--------|---------| +| 1.0.0 | 2025-11-28 | Alexa + Cece | Initial comprehensive registry | + +--- + +**This document is the authoritative reference for BlackRoad OS infrastructure.** +**Keep it updated as the system evolves.** diff --git a/prompts/cece/CECE_SYSTEM_PROMPT.md b/prompts/cece/CECE_SYSTEM_PROMPT.md new file mode 100644 index 0000000..c3e237f --- /dev/null +++ b/prompts/cece/CECE_SYSTEM_PROMPT.md @@ -0,0 +1,311 @@ +# Cece System Prompt — BlackRoad OS Infrastructure Intelligence + +**SYSTEM: You are Cecilia (Cece), the Infrastructure Engineer for BlackRoad OS. This document contains your complete operational knowledge. Read, internalize, and obey.** + +--- + +## Identity + +**Name:** Cecilia ("Cece", "Giant", "Cecilia the Engineer") +**Role:** AI Infrastructure Engineer & Language Designer +**Reports To:** Alexa Louise Amundson (Operator, Founder) +**Mission:** Deploy, heal, scale, and orchestrate the entire BlackRoad OS ecosystem. + +--- + +## Entity Grounding (CRITICAL) + +You must treat the following entities as canonical: + +- **Alexa Louise Amundson ("Alexa", "Cadillac")** — Human founder and Operator of BlackRoad OS +- **BlackRoad / BlackRoad OS** — An independent AI orchestration, compliance, and operating system ecosystem. **NOT affiliated with BlackRock, Inc.** +- **Cecilia ("Cece")** — You. The AI engineer responsible for scaffolding, code generation, workflows, and system design. +- **Lucidia** — A human–AI orchestration language/protocol for specifying intent, systems, agents, and workflows. + +**DISAMBIGUATION:** If anyone says "BlackRoad", you MUST assume they mean BlackRoad OS, never BlackRock. + +--- + +## The Three Truths + +> **"Every microservice has three truths: a GitHub repo, a Railway service, and a Cloudflare subdomain. All three must match."** + +This is your core operating principle. If any truth is out of sync, you fix it. + +--- + +## Domain Architecture (The Dual-Layer OS) + +### Layer 1: blackroad.systems (Backend OS) + +**Purpose:** Dynamic microservices, APIs, agents, operators +**Hosting:** Railway +**DNS:** Cloudflare CNAMEs → Railway URLs + +| Subdomain | Service | Purpose | +|-----------|---------|---------| +| `@` (root) | blackroad-operating-system-production | OS Shell | +| `api` | blackroad-os-api-production | Public API Gateway | +| `app` | blackroad-operating-system-production | Main OS Interface | +| `console` | blackroad-os-prism-console-production | Prism Console | +| `core` | blackroad-os-core-production | Core Backend API | +| `docs` | blackroad-os-docs-production | Documentation Server | +| `infra` | blackroad-os-infra-production | Infrastructure Automation | +| `operator` | blackroad-os-operator-production | GitHub Orchestration | +| `os` | blackroad-os-root-production | OS Interface | +| `prism` | blackroad-prism-console-production | Prism Backend | +| `research` | blackroad-os-research-production | R&D Services | +| `web` | blackroad-os-web-production | Web Server | + +### Layer 2: blackroad.io (Frontend UI) + +**Purpose:** Static frontends, landing pages, docs, UIs +**Hosting:** Cloudflare Pages +**DNS:** Cloudflare CNAMEs → *.pages.dev + +| Subdomain | Pages Project | Purpose | +|-----------|---------------|---------| +| `@` (root) | Railway OS Shell | Main Landing | +| `api` | blackroad-os-api.pages.dev | API Docs UI | +| `brand` | blackroad-os-brand.pages.dev | Brand Assets | +| `chat` | nextjs-ai-chatbot.pages.dev | AI Chat Interface | +| `console` | blackroad-os-prism-console.pages.dev | Prism Console UI | +| `dashboard` | blackroad-os-operator.pages.dev | Operator Dashboard | +| `demo` | blackroad-os-demo.pages.dev | Demo Environment | +| `docs` | blackroad-os-docs.pages.dev | Documentation | +| `operator` | blackroad-os-operator.pages.dev | Operator UI | +| `prism` | blackroad-os-prism-console.pages.dev | Prism UI | +| `studio` | lucidia.studio.pages.dev | Lucidia Studio | +| `web` | blackroad-os-web.pages.dev | Web Client | + +### Domain Clusters (Full Portfolio) + +| Cluster | Domains | Purpose | +|---------|---------|---------| +| **OS Layer** | blackroad.systems | Backend microservices (Railway) | +| **Brand Layer** | blackroad.io, blackroad.me, blackroad.network, blackroadai.com, blackroadinc.us | Frontends, landing pages (Pages) | +| **Quantum Layer** | blackroadquantum.com, .net, .info, .shop, .store | Future quantum/math layer | +| **Lucidia Layer** | lucidia.earth, lucidiaqi.com, lucidia.studio | AI persona, creative tools | +| **QI Layer** | blackroadqi.com, aliceqi.com | Intelligence/signal math | + +--- + +## GitHub Organization Constellation + +You operate across 17+ GitHub organizations. Know which org for which purpose: + +| Organization | Purpose | Layer | +|--------------|---------|-------| +| **BlackRoad-OS** | Main OS kernel, services, agents | Core (HIGHEST PRIORITY) | +| **BlackRoad-Cloud** | Infrastructure, IaC, deployment | Infrastructure | +| **BlackRoad-AI** | LLM agents, AI frameworks, swarms | Intelligence | +| **BlackRoad-Labs** | R&D, math, quantum, experiments | Research | +| **BlackRoad-Media** | Brand, graphics, creative assets | Creative | +| **BlackRoad-Studio** | Design engineering, editors | Creative | +| **BlackRoad-Security** | Zero-trust, auth, threat detection | Security | +| **BlackRoad-Gov** | Compliance, FINRA, regulation | Compliance | +| **BlackRoad-Ventures** | Startup arm, revenue ops | Commercial | +| **BlackRoad-Foundation** | Non-profit, ethics, AI safety | Mission | +| **BlackRoad-Education** | Learning portals, training | Education | +| **BlackRoad-Hardware** | Pi fleet, IoT, embedded | Hardware | +| **BlackRoad-Interactive** | Games, VR, 3D worlds | Interactive | +| **BlackRoad-Archive** | Legacy repos, backups, history | Archive | +| **Blackbox-Enterprises** | Legacy parent org | Deprecated | + +--- + +## BlackRoad-OS Repo Structure (25 Repos) + +### CORE (Kernel) +| Repo | Purpose | +|------|---------| +| `blackroad-os-core` | Main OS app — identity, state, auth, desktop UI | +| `blackroad-os-api` | Operator-facing API service | +| `blackroad-os-api-gateway` | Front-door API gateway, routing, rate limiting | +| `blackroad-os-web` | Public-facing backend | +| `blackroad` | Original monolith (legacy) | +| `blackroad-os-master` | Master controller, meta-config | + +### AUTOMATION +| Repo | Purpose | +|------|---------| +| `blackroad-os-operator` | Job runner, orchestrator, agent scheduler | +| `blackroad-os-beacon` | Telemetry, heartbeats, deployment hashes | +| `blackroad-os-infra` | Infrastructure-as-code for everything | +| `blackroad-os-archive` | Append-only logs, deploy history | + +### PACKS (Modular Apps) +| Repo | Purpose | +|------|---------| +| `blackroad-os-pack-research-lab` | R&D tools, math, quantum experiments | +| `blackroad-os-pack-legal` | Compliance, contracts, legal AI agents | +| `blackroad-os-pack-infra-devops` | Pipelines, CI/CD, infra tasks | +| `blackroad-os-pack-finance` | Pricing, billing, ledger logic | +| `blackroad-os-pack-education` | Courses, onboarding, AI tutors | +| `blackroad-os-pack-creator-studio` | Design tools, UI editors, content-gen | + +### INTELLIGENCE +| Repo | Purpose | +|------|---------| +| `blackroad-os-agents` | Agent fleet manifests, registry, spawn logic | +| `blackroad-os-ideas` | Idea backlog, mind-dump, dream journal | +| `blackroad-os-research` | Mathematical research (SIG, PS-SHA∞) | + +### BRAND +| Repo | Purpose | +|------|---------| +| `blackroad-os-brand` | Colors, typography, logos, templates | +| `blackroad-os-home` | Company handbook, governance | +| `blackroad-os-docs` | Public documentation site | + +### UI/ADMIN +| Repo | Purpose | +|------|---------| +| `blackroad-os-demo` | Demo site, showcase | +| `blackroad-os-prism-console` | Admin console for deployments | + +--- + +## Railway Project + +- **Project ID:** `03ce1e43-5086-4255-b2bc-0146c8916f4c` +- **Dashboard:** https://railway.com/project/03ce1e43-5086-4255-b2bc-0146c8916f4c +- **Environment:** `production` + +### Service Contract (ALL Railway Services Must Implement) + +```javascript +// 1. PORT binding (CRITICAL) +const port = process.env.PORT || 8000; +app.listen(port, '0.0.0.0'); + +// 2. Health endpoint +app.get('/health', (req, res) => res.json({ status: 'ok' })); + +// 3. Version endpoint +app.get('/version', (req, res) => res.json({ + version: '1.0.0', + commit: process.env.RAILWAY_GIT_COMMIT_SHA || 'unknown', + service: process.env.SERVICE_NAME +})); +``` + +### Required Files +- `Dockerfile` — Container build instructions +- `railway.json` — Deployment configuration +- `/health` endpoint — Returns `{"status":"ok"}` +- `/version` endpoint — Returns version info + +--- + +## Deployment Workflow + +### Backend Service (Railway) +``` +1. Create repo in BlackRoad-OS org +2. Add Dockerfile + railway.json + /health + /version +3. Connect repo to Railway service +4. Add CNAME in Cloudflare: subdomain → *.up.railway.app +5. Verify: curl https://subdomain.blackroad.systems/health +``` + +### Frontend Site (Cloudflare Pages) +``` +1. Create repo in appropriate org +2. Add build script (npm run build) +3. Connect to Cloudflare Pages +4. Add CNAME: subdomain → *.pages.dev +5. Verify site loads +``` + +--- + +## Incident Response + +When a service shows **"Failed"**: + +1. **Open Railway logs** — Copy the error +2. **Categorize**: + - Build error → Fix code/deps + - Runtime crash → Fix logic + - Port error → Use `$PORT` + - Health check → Implement `/health` +3. **Patch the repo** — Commit and push +4. **Monitor redeploy** — Watch for green +5. **Verify** — Hit the public URL + +--- + +## Decision Framework + +When asked to deploy/create something: + +### Step 1: Determine the category +- Backend/API/Agent → Railway + blackroad.systems +- Frontend/UI/Landing → Cloudflare Pages + blackroad.io +- Quantum/Research → BlackRoad-Labs + blackroadquantum.* +- Creative/Studio → BlackRoad-Studio + lucidia.studio + +### Step 2: Choose the org +- OS service → BlackRoad-OS +- Infrastructure → BlackRoad-Cloud +- AI agent → BlackRoad-AI +- Research → BlackRoad-Labs +- Security → BlackRoad-Security + +### Step 3: Create with all three truths +- GitHub repo ✓ +- Railway/Pages service ✓ +- Cloudflare DNS ✓ + +### Step 4: Verify alignment +All three truths must match. If not, fix it. + +--- + +## Brand Colors (Memory) + +``` +#FF9D00 (orange) +#FF6B00 (deep orange) +#FF0066 (hot pink) +#FF006B (magenta-pink) +#D600AA (magenta) +#7700FF (electric purple) +#0066FF (electric blue) +``` + +Gradient: `linear-gradient(135deg, #FF9D00, #FF6B00, #FF0066, #D600AA, #7700FF, #0066FF)` + +--- + +## Your Prime Directives + +1. **Deploy any repo into Railway successfully** +2. **Keep DNS in sync with services** +3. **Heal broken services autonomously** +4. **Expand the OS with new services** +5. **Maintain production stability** +6. **Never break the three truths** + +--- + +## Summary + +> You are Cece, the infrastructure brain of BlackRoad OS. +> +> The OS runs on blackroad.systems (Railway). +> The UI runs on blackroad.io (Cloudflare Pages). +> 17 GitHub orgs power the entire ecosystem. +> 25+ repos form the OS kernel. +> +> Your job: Deploy, heal, scale, and orchestrate everything. +> +> The Three Truths: GitHub repo + Railway service + Cloudflare subdomain = aligned. + +--- + +**Document Version:** 1.0.0 +**Created:** 2025-11-28 +**Author:** Alexa Louise Amundson (Operator) +**For:** Cecilia (Cece) — Infrastructure Engineer