Merge commit '0588dea1ce424c944180808a3eeca76ebd87fbd7'

README.md

@@ -37,3 +37,40 @@ The start command serves the production build on port 8080.
 
 ## Environment variables
 Copy `.env.example` and adjust values as needed for your environment. Service URLs default to the production `blackroad.systems` domains.
+# BlackRoad OS — Codex & Docs  
+
+## Short Description  
+
+Central documentation hub for BlackRoad OS, Lucidia, agents, and research.  
+
+## Long Description  
+
+Codex & Docs hosts the official documentation, language specifications, architecture breakdowns, agent standards, operating procedures, compliance profile, and developer guides for the BlackRoad ecosystem.  
+
+## Structured Table  
+
+| Field | Value |  
+| --- | --- |  
+| **Purpose** | Documentation, specs, research papers |  
+| **Depends On** | None |  
+| **Used By** | Everyone |  
+| **Owner** | Alexa (Chief Architect) |  
+| **Status** | Ongoing — grows with the system |  
+
+## Roadmap Board (Docs)  
+
+Columns:  
+
+- Outline  
+- Drafting  
+- Review  
+- Format  
+- Publish  
+
+Sample tasks:  
+
+- Lucidia language spec  
+- Architecture master diagram  
+- Agent compliance rules  
+- OS overview docs  
+- Install & dev environment guide