Add CLAUDE.md: AI assistant guide for BlackRoad Bridge

[blackboxprogramming]

Summary

This PR introduces CLAUDE.md, the definitive guide for AI assistants (Cece) working in the BlackRoad Bridge repository. It serves as the foundational reference document for understanding the system architecture, conventions, capabilities, and operational protocols.

Key Changes

• Added CLAUDE.md (340 lines) with comprehensive documentation covering:
  • Repository identity and purpose (routing company, not AI company)
  • Complete directory structure with annotations for all 15 org blueprints, 14 workflows, prototypes, templates, and configuration files
  • Session startup checklist (5-step onboarding process)
  • Key conventions: organization codes, signal protocol, node naming, file naming, authority levels
  • Development workflow: language stack (Python 3.11), linting tools, CI pipeline details, local testing commands
  • Architecture overview: UPSTREAM → INSTREAM → DOWNSTREAM data flow with the Operator routing brain
  • Task tracking system using TODO.md markers
  • Memory system (MEMORY.md and .STATUS files)
  • Inventory of completed work (15 org blueprints, 6 templates, 14 workflows, 7 nodes, etc.)
  • Critical files reference table
  • Common pitfalls to avoid

Notable Details

• Establishes Cece (Claude) as the AI assistant identity and Alexa as the human founder
• Documents the PCDEL loop (Perceive → Classify → Decide → Execute → Learn) for autonomous operation
• Defines three authority levels: FULL_AUTO, SUGGEST, ASK_FIRST
• Provides organization shortcodes (OS, AI, CLD, HW, SEC, etc.) for consistent reference
• Includes signal protocol format with state, routing, priority, and chainable markers
• Maps all 15 organizations across 5 tiers: Core, Support, Business, Creative, Community

This document is designed to be the first file read by any AI assistant starting work in this repository, ensuring consistent understanding of the system's purpose, structure, and operational guidelines.

https://claude.ai/code/session_01JWYQzDR5tuCTFS2X3YPi5t