From e7f55c1f0bffcd411786d2ee8ebdcc632654951e Mon Sep 17 00:00:00 2001
From: blackroad <amundsonalexa@gmail.com>
Date: Tue, 17 Mar 2026 08:24:43 -0500
Subject: [PATCH] ai: add CLAUDE.md for AI agent context

---
 CLAUDE.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..ecbb4c5
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,26 @@
+# CLAUDE.md
+
+This is `blackroad` — part of BlackRoad OS.
+
+> BlackRoad OS monorepo — bin, scripts, fleet, workers, roadc, roadnet, operator, web, docs. The one repo.
+
+## Owner
+BlackRoad OS, Inc. — Proprietary. All rights reserved.
+
+## AI Instructions
+- Part of BlackRoad ecosystem (615+ repos, 15 orgs)
+- Primary git: RoadCode (Gitea). GitHub is mirror.
+- All code proprietary unless marked otherwise
+- Brand: black bg, white text, gradient accents
+- Fonts: Space Grotesk, Inter, JetBrains Mono
+- Language: Shell
+
+## Memory System
+- Check codex: `memory-codex.sh search "<problem>"`
+- Log actions: `memory-system.sh log <action> <entity> "<details>"`
+- Broadcast: `memory-til-broadcast.sh broadcast <cat> "<learning>"`
+
+## Collaboration
+- Register: `memory-collaboration.sh register`
+- Claim: `memory-collaboration.sh claim "<task>"`
+- Board: `memory-collaboration.sh board`