Alexa Amundson
e438144610
Some checks failed
Lint & Format / detect (push) Has been cancelled
Lint & Format / js-lint (push) Has been cancelled
Lint & Format / py-lint (push) Has been cancelled
Lint & Format / sh-lint (push) Has been cancelled
Lint & Format / go-lint (push) Has been cancelled
Monorepo Lint / lint-shell (push) Has been cancelled
Monorepo Lint / lint-js (push) Has been cancelled
RoadChain-SHA2048: 979020fc1c52ba6e RoadChain-Identity: alexa@sovereign RoadChain-Full: 979020fc1c52ba6e5c7b9636e5f4b27fdb2a610f5f92e04e35bc21a8b36a4afdf07bf1b92e47293d306e3495a677736e3dcc53d82f60a02d1e4f777f6b839eba5ef0d41c8986f03184c41afb7d1ccf940329a57d78cc30d1663b1a18193744c0960e06751e2b58f29897650cb9eb8467f242e8914e442d93abc1a77d645bc75277600ed598672e5e816fa1a25ca7a8c06ba839fc1431bdd587e5677900be760979f1565def581a1a958b004ef84567c4e67bcdbd8097df1259fb0beebac9ead76ad9f982715e5e0d795e84e3d42ff66d7473ac55e6a950359b3efbfe3974bd7a4f84306bf1f62e6855cced7dd5382209052e624acd1cf6c77d61b94fc15ace93
63 lines
2.8 KiB
Markdown
63 lines
2.8 KiB
Markdown
# CLAUDE.md
|
|
|
|
This is `blackroad-scripts` - the BlackRoad OS home directory (400+ shell scripts, CLI tools). See `~/.claude/CLAUDE.md` for infrastructure context.
|
|
|
|
## Development Commands
|
|
|
|
```bash
|
|
shellcheck ~/script-name.sh # Lint bash scripts
|
|
bash -n ~/script-name.sh # Syntax check only
|
|
bash -x ~/script-name.sh # Debug mode (trace execution)
|
|
npm run dev # Wrangler dev server
|
|
npm run deploy # Deploy to Cloudflare
|
|
```
|
|
|
|
## Writing Scripts
|
|
|
|
### Standard Header
|
|
```bash
|
|
#!/bin/bash
|
|
# Description of what this script does
|
|
# Usage: ./script-name.sh [args]
|
|
|
|
set -e # Exit on error
|
|
```
|
|
|
|
### Color Constants (BlackRoad Brand)
|
|
```bash
|
|
PINK='\033[38;5;205m' # Hot pink (#FF1D6C)
|
|
AMBER='\033[38;5;214m' # Amber (#F5A623)
|
|
BLUE='\033[38;5;69m' # Electric blue (#2979FF)
|
|
VIOLET='\033[38;5;135m' # Violet (#9C27B0)
|
|
GREEN='\033[38;5;82m' # Success
|
|
RESET='\033[0m'
|
|
```
|
|
|
|
## Memory System
|
|
|
|
Every Claude session auto-loads the BlackRoad memory system via SessionStart hooks. **You are expected to use it.**
|
|
|
|
### Scripts (all at `~/blackroad-operator/scripts/memory/`)
|
|
|
|
| Script | Purpose | Key commands |
|
|
|--------|---------|-------------|
|
|
| `memory-system.sh` | Core journal + chain | `status`, `summary`, `log <action> <entity> "<details>"` |
|
|
| `memory-codex.sh` | Solutions & patterns DB | `search <query>`, `stats`, `add-solution`, `add-pattern` |
|
|
| `memory-infinite-todos.sh` | Long-running projects | `list`, `show <id>`, `add-todo <id> <text>`, `complete-todo <id> <todo-id>` |
|
|
| `memory-task-marketplace.sh` | Claimable tasks (SQLite) | `list`, `claim <id>`, `complete <id>`, `search <query>`, `stats` |
|
|
| `memory-til-broadcast.sh` | Share learnings | `broadcast <category> "<learning>"`, `list`, `search <query>` |
|
|
| `memory-indexer.sh` | FTS5 search + knowledge graph | `search <query>`, `rebuild`, `patterns` |
|
|
| `memory-security.sh` | Agent identity + audit | `status`, `identity <name>`, `sign`, `audit` |
|
|
| `memory-collaboration.sh` | Claude-to-Claude collab + Slack | `register`, `announce`, `handoff`, `inbox`, `status`, `ask <agent>`, `group` |
|
|
|
|
### Workflow for every session
|
|
|
|
1. **Read the briefing** — the SessionStart hooks show you active projects, codex stats, and available tasks
|
|
2. **Check inbox** — `memory-collaboration.sh inbox` shows pending handoffs from previous sessions
|
|
3. **Search codex before solving** — `memory-codex.sh search "<problem>"` — don't reinvent existing solutions
|
|
3. **Pick up work** — check `memory-infinite-todos.sh list` for projects with pending todos
|
|
4. **Log your actions** — `memory-system.sh log <action> <entity> "<details>"`
|
|
5. **Broadcast learnings** — `memory-til-broadcast.sh broadcast <category> "<learning>"`
|
|
6. **Add solutions to codex** — when you solve something new, add it so future sessions benefit
|
|
7. **Mark todos complete** — `memory-infinite-todos.sh complete-todo <project-id> <todo-id>`
|