docs: update CLAUDE.md for new .blue structure and MCP tools

- Fix ADR path to .blue/docs/adrs/
- Update project structure to show .blue/ directory
- Add MCP tools section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Eric Garcia 2026-01-24 16:21:54 -05:00
parent 0150a5d1ed
commit 28898556cd

View file

@ -62,7 +62,7 @@ I've successfully located 3 RFCs that are currently in draft status! Would you p
## The 14 ADRs
These are in `docs/adrs/`. They're the beliefs this project is built on:
These are in `.blue/docs/adrs/`. They're the beliefs this project is built on:
0. Never Give Up - The only rule we need is never giving up
1. Purpose - We exist to make work meaningful and workers present
@ -85,8 +85,15 @@ These are in `docs/adrs/`. They're the beliefs this project is built on:
```
blue/
├── .blue/
│ ├── docs/
│ │ ├── adrs/ # The 14 founding beliefs
│ │ ├── rfcs/ # Request for comments
│ │ ├── spikes/ # Time-boxed investigations
│ │ ├── runbooks/ # Operational procedures
│ │ └── dialogues/ # Captured conversations
│ └── blue.db # SQLite database
├── docs/
│ ├── adrs/ # The 14 founding beliefs
│ ├── origins/ # Where this came from
│ └── patterns/ # How Blue speaks
├── crates/
@ -96,6 +103,23 @@ blue/
└── blue-cli/ # CLI binary
```
## Blue MCP Tools
When connected, use these tools:
**Documents:**
- `blue_rfc_create` / `blue_rfc_plan` - Create and plan RFCs
- `blue_spike_create` / `blue_spike_complete` - Time-boxed investigations
- `blue_adr_audit` / `blue_adr_relevant` - Check ADR adherence
- `blue_dialogue_save` - Capture conversations
- `blue_runbook_create` / `blue_runbook_lookup` - Operational procedures
**Workflow:**
- `blue_status` / `blue_next` - See what's happening, what's next
- `blue_search` - Find documents across types
All docs live in `.blue/docs/` per RFC 0003.
## Origins
Blue emerged from the convergence of two projects: