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)
This commit introduces the complete Black Road OS - a Windows 95-inspired
web-based operating system interface that showcases the entire BlackRoad
AI ecosystem.
Features added:
- Complete single-page HTML application (index.html)
- 15+ functional application windows including:
- RoadMail email client
- BlackRoad Social network
- BlackStream video platform
- RoadChain blockchain explorer
- RoadCoin mining dashboard
- Multiple games (Road City, RoadCraft, Road Life)
- Development tools (Terminal, File Explorer, GitHub)
- Fully functional window management system
- Windows 95-style UI with authentic design
- Taskbar, Start menu, and system tray
- Draggable, resizable windows
- No external dependencies - pure HTML/CSS/JS
Documentation:
- Comprehensive README with setup instructions
- Architecture overview and design philosophy
- Customization guide for adding new applications
- GitHub Pages deployment instructions
- Browser compatibility information
The interface is ready for immediate use and can be deployed to
GitHub Pages without any build process.
