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)
