- Complete repository structure and technology stack overview
- Detailed development setup instructions for backend, frontend, and SDKs
- Key architectural patterns (event-driven, async-first, agent-based)
- Development workflows including Git, CI/CD, and environment management
- Testing practices for backend, frontend, and agents
- Deployment guides for Railway, GitHub Pages, and Docker
- Important conventions for code style, API design, and security
- Common tasks with step-by-step instructions
- Critical gotchas and debugging tips
- Quick reference section for files and commands
This guide provides all essential information for AI assistants to
effectively work on the BlackRoad Operating System codebase.
