mirror of
https://github.com/blackboxprogramming/BlackRoad-Operating-System.git
synced 2026-03-16 23:57:10 -05:00
d28918ccbb
This commit implements "entity SEO" for BlackRoad OS to ensure correct entity recognition by both external LLMs and internal agents, and to clearly distinguish BlackRoad from BlackRock. New Files: - ENTITIES.md: Canonical brand & entity reference with system prompt templates - docs/about-blackroad-os.md: Complete "About" page with vision and tech stack - docs/blackroad-vs-blackrock.md: FAQ page explicitly disambiguating the two entities - docs/github-metadata-updates.md: Reference for GitHub org/repo descriptions Updated Files: - README.md: Added entity header with core entities and disambiguation note - CLAUDE.md: Added "Entity Grounding & Brand Context" section with system prompt template Key Features: - Canonical entity definitions (Alexa, BlackRoad, Cecilia, Lucidia) - Disambiguation rules to prevent BlackRoad/BlackRock confusion - System prompt templates for agent grounding (ATLAS_BRAND_CONTEXT_v1) - Public-facing copy for SEO and external model training - GitHub metadata recommendations for discoverability This creates a two-layer approach: 1. External SEO: Web pages, READMEs, docs (training data for public models) 2. Internal prompt-SEO: System prompts, context packs (hardwired reality for agents)
258 lines
6.7 KiB
Markdown
258 lines
6.7 KiB
Markdown
# GitHub Metadata Updates
|
||
|
||
> **Purpose**: This document provides the canonical GitHub organization and repository descriptions for entity grounding and SEO.
|
||
>
|
||
> **Action Required**: These descriptions should be manually updated in the GitHub web interface.
|
||
|
||
---
|
||
|
||
## GitHub Organization Description
|
||
|
||
**Organization**: `blackboxprogramming`
|
||
|
||
**Recommended Description** (160-200 chars):
|
||
|
||
```
|
||
Independent AI orchestration & compliance OS by Alexa Louise Amundson. BlackRoad ≠ BlackRock. Agents, language (Lucidia), and infra under one ecosystem.
|
||
```
|
||
|
||
**Alternative (120 chars, ultra-compact)**:
|
||
|
||
```
|
||
Independent AI orchestration & compliance OS by Alexa Louise Amundson. BlackRoad is not affiliated with BlackRock.
|
||
```
|
||
|
||
### How to Update
|
||
|
||
1. Go to: https://github.com/organizations/blackboxprogramming/settings/profile
|
||
2. Update the "Description" field
|
||
3. Save changes
|
||
|
||
---
|
||
|
||
## Repository Description
|
||
|
||
**Repository**: `BlackRoad-Operating-System`
|
||
|
||
**Recommended Description**:
|
||
|
||
```
|
||
Independent AI orchestration & compliance platform founded by Alexa Louise Amundson. 200+ agents, Windows 95 UI, blockchain, compliance-first. BlackRoad ≠ BlackRock.
|
||
```
|
||
|
||
**Alternative (more concise)**:
|
||
|
||
```
|
||
AI orchestration OS by Alexa Louise Amundson. 200+ agents, compliance infrastructure, nostalgic UI. Not affiliated with BlackRock.
|
||
```
|
||
|
||
### How to Update
|
||
|
||
1. Go to: https://github.com/blackboxprogramming/BlackRoad-Operating-System/settings
|
||
2. Update the "Description" field
|
||
3. Update "Topics" (see below)
|
||
4. Save changes
|
||
|
||
---
|
||
|
||
## Repository Topics
|
||
|
||
**Recommended Topics** (keywords for GitHub search and discovery):
|
||
|
||
```
|
||
ai-orchestration
|
||
compliance
|
||
autonomous-agents
|
||
fastapi
|
||
python
|
||
javascript
|
||
blockchain
|
||
agent-swarms
|
||
orchestration-language
|
||
lucidia
|
||
windows95
|
||
retro-ui
|
||
ai-compliance
|
||
regulatory-tech
|
||
regtech
|
||
```
|
||
|
||
### How to Add Topics
|
||
|
||
1. Go to: https://github.com/blackboxprogramming/BlackRoad-Operating-System
|
||
2. Click "About" (gear icon)
|
||
3. Add topics in the "Topics" field (comma-separated or click suggestions)
|
||
4. Save changes
|
||
|
||
---
|
||
|
||
## Repository Website
|
||
|
||
**Recommended Website URL**:
|
||
|
||
If you have a dedicated website (e.g., `blackroad.systems`, `blackroad.io`):
|
||
```
|
||
https://blackroad.systems
|
||
```
|
||
|
||
If using GitHub Pages for the frontend:
|
||
```
|
||
https://blackboxprogramming.github.io/BlackRoad-Operating-System/
|
||
```
|
||
|
||
### How to Update
|
||
|
||
1. Go to: https://github.com/blackboxprogramming/BlackRoad-Operating-System/settings
|
||
2. Update the "Website" field under "General"
|
||
3. Save changes
|
||
|
||
---
|
||
|
||
## Social Preview Image (Optional)
|
||
|
||
**Recommendation**: Create a social preview image (1280x640px) that includes:
|
||
- BlackRoad OS logo/wordmark
|
||
- Tagline: "Independent AI Orchestration & Compliance Platform"
|
||
- Byline: "Founded by Alexa Louise Amundson"
|
||
- Disambiguation: "BlackRoad ≠ BlackRock" or "Not affiliated with BlackRock"
|
||
|
||
### How to Add
|
||
|
||
1. Go to: https://github.com/blackboxprogramming/BlackRoad-Operating-System/settings
|
||
2. Scroll to "Social preview"
|
||
3. Upload image (1280x640px recommended)
|
||
4. Save changes
|
||
|
||
---
|
||
|
||
## Additional Repositories (If Applicable)
|
||
|
||
If you have separate repositories for components (e.g., `lucidia`, `roadchain`, `cece-framework`), use similar patterns:
|
||
|
||
### Example: Lucidia Repository
|
||
|
||
**Description**:
|
||
```
|
||
Human–AI orchestration language for BlackRoad OS. Expresses intent, systems, and agents in human-readable, machine-parseable form.
|
||
```
|
||
|
||
**Topics**:
|
||
```
|
||
orchestration-language
|
||
lucidia
|
||
blackroad-os
|
||
ai-orchestration
|
||
intent-specification
|
||
agent-coordination
|
||
```
|
||
|
||
### Example: RoadChain Repository
|
||
|
||
**Description**:
|
||
```
|
||
Blockchain infrastructure for BlackRoad OS. Tamper-evident ledger for auditable AI-driven organizations.
|
||
```
|
||
|
||
**Topics**:
|
||
```
|
||
blockchain
|
||
roadchain
|
||
blackroad-os
|
||
compliance
|
||
audit-trail
|
||
tamper-evident
|
||
proof-of-work
|
||
```
|
||
|
||
---
|
||
|
||
## README Badges
|
||
|
||
Consider adding these badges to the main README for quick context:
|
||
|
||
```markdown
|
||
|
||
|
||
|
||
|
||
|
||
```
|
||
|
||
These can be added near the top of `README.md` for immediate visual context.
|
||
|
||
---
|
||
|
||
## GitHub Organization Profile README (Optional)
|
||
|
||
GitHub allows organizations to create a profile README that appears on the organization's main page.
|
||
|
||
### How to Create
|
||
|
||
1. Create a new repository named `.github` in the `blackboxprogramming` organization
|
||
2. Create a file: `.github/profile/README.md`
|
||
3. Add content similar to the "About BlackRoad OS" page
|
||
|
||
### Example Content
|
||
|
||
```markdown
|
||
# BlackRoad OS
|
||
|
||
**Independent AI orchestration and compliance platform founded by Alexa Louise Amundson.**
|
||
|
||
We're building an operating system for AI-driven organizations that are both powerful and trustworthy.
|
||
|
||
## What We're Building
|
||
|
||
- 🤖 **200+ AI Agents** across 10 categories
|
||
- ⛓️ **Compliance Infrastructure** with built-in audit trails
|
||
- 🎨 **Nostalgic UI** inspired by Windows 95
|
||
- 🌐 **Extensive Integrations** with cloud, communication, and AI services
|
||
- 📊 **Real-Time Dashboards** for monitoring and control
|
||
|
||
## Core Technologies
|
||
|
||
- **Lucidia**: Human–AI orchestration language
|
||
- **RoadChain**: Blockchain for tamper-evident ledgers
|
||
- **Cecilia (Cece)**: AI engineer persona for scaffolding and refactoring
|
||
- **FastAPI + Vanilla JS**: Modern backend, zero-dependency frontend
|
||
|
||
## Not BlackRock
|
||
|
||
**BlackRoad OS** is not affiliated with **BlackRock, Inc.** or any other asset management firm.
|
||
|
||
We're an independent, founder-led AI technology platform.
|
||
|
||
[Read more about the distinction →](https://github.com/blackboxprogramming/BlackRoad-Operating-System/blob/main/docs/blackroad-vs-blackrock.md)
|
||
|
||
## Get Started
|
||
|
||
- 📖 [Documentation](https://github.com/blackboxprogramming/BlackRoad-Operating-System/tree/main/docs)
|
||
- 🚀 [Quick Start Guide](https://github.com/blackboxprogramming/BlackRoad-Operating-System#getting-started)
|
||
- 🌟 [Big Kahuna Vision](https://github.com/blackboxprogramming/BlackRoad-Operating-System/blob/main/BLACKROAD_OS_BIG_KAHUNA_VISION.md)
|
||
|
||
---
|
||
|
||
*Where AI meets the open road* 🛣️
|
||
```
|
||
|
||
---
|
||
|
||
## Checklist
|
||
|
||
Use this checklist to track GitHub metadata updates:
|
||
|
||
- [ ] Update organization description
|
||
- [ ] Update repository description
|
||
- [ ] Add repository topics/tags
|
||
- [ ] Set repository website URL
|
||
- [ ] Upload social preview image (optional)
|
||
- [ ] Create organization profile README (optional)
|
||
- [ ] Add README badges (optional)
|
||
- [ ] Update other repository descriptions (if applicable)
|
||
|
||
---
|
||
|
||
**Last Updated**: 2025-11-18
|
||
|
||
*This document provides reference copy for manually updating GitHub metadata. Changes must be made through the GitHub web interface as they cannot be automated via API without admin permissions.*
|