Skip to content

docs: Add CLAUDE.md - AI assistant instructions and context#19

Draft
blackboxprogramming wants to merge 1 commit intomainfrom
claude/claude-md-ml707goyukc9kubd-yveMa
Draft

docs: Add CLAUDE.md - AI assistant instructions and context#19
blackboxprogramming wants to merge 1 commit intomainfrom
claude/claude-md-ml707goyukc9kubd-yveMa

Conversation

@blackboxprogramming
Copy link
Contributor

Summary

Add comprehensive CLAUDE.md documentation file to serve as the primary instruction and context guide for AI assistants working in the BlackRoad OS Bridge repository.

Changes

  • New file: CLAUDE.md (359 lines)
    • Project overview and ownership information
    • Complete repository structure with directory tree and file descriptions
    • Key concepts: The Bridge, routing philosophy, organization codes, node mesh, signal protocol, data flow patterns, and PCDEL processing loop
    • Development conventions: languages, commit message format, file naming, branch naming, and core principles
    • Decision authority matrix (FULL AUTO, SUGGEST, ASK FIRST)
    • Prioritized reading list for new sessions
    • Infrastructure overview and monthly costs
    • Routing registry reference
    • Prototype modules summary table
    • Business model overview
    • Session history tracking

Implementation Details

This document consolidates critical context that was previously scattered or implicit:

  • Onboarding: New AI sessions can read CLAUDE.md → MEMORY.md → .STATUS → BLACKROAD_ARCHITECTURE.md to get fully oriented
  • Decision Framework: Clear authority levels prevent unauthorized actions while enabling autonomous work on appropriate tasks
  • Reference Material: Serves as a quick lookup for org codes, node names, routing rules, and file locations
  • Conventions: Establishes consistent patterns for commits, branches, file naming, and code organization across the distributed 15-org ecosystem
  • Context Preservation: Enables continuity across multi-session Claude Code work by documenting the complete system architecture

This is a documentation-only change with no code modifications.

https://claude.ai/code/session_0137SHJodLnb5sUMHssz7E34

Provides codebase structure, development conventions, decision authority
levels, routing registry summary, and session startup instructions for
AI assistants working in the BlackRoad OS Bridge repository.

https://claude.ai/code/session_0137SHJodLnb5sUMHssz7E34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants