superviber/blue
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: Add ADR 0000 Never Give Up to beliefs list

Browse source 
The zeroth principle - the ground everything stands on.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Eric Garcia 2026-01-24 09:12:18 -05:00
parent 8d91242147
commit 3e1fc44370
1 changed files with 55 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

61
README.md
View file

@ -18,18 +18,27 @@ Shall we get started?
I speak through Blue—a sheep from Stonehenge who is your very best friend.
## Install
```bash
./install.sh
```
Installs CLI to `/usr/local/bin` and configures MCP for Claude Code. See [INSTALL.md](INSTALL.md) for details.
## Getting Started
```bash
💙 init # Welcome home
💙 create # Start a new idea
💙 plan # Break it into steps
💙 status # Where are we?
💙 next # What's next?
blue init # Welcome home
blue create # Start a new idea
blue plan # Break it into steps
blue status # Where are we?
blue next # What's next?
```
## The 13 Beliefs
## The Beliefs
0. **Never Give Up** — The ground everything stands on
1. **Purpose** — We exist to make work meaningful and workers present
2. **Presence** — The quality of actually being here while you work
3. **Home** — You are never lost. You are home.
@ -44,6 +53,46 @@ I speak through Blue—a sheep from Stonehenge who is your very best friend.
12. **Faith** — Act on justified belief, not just proven fact
13. **Overflow** — Build from fullness, not emptiness
## MCP Tools
Blue speaks to Claude via MCP (Model Context Protocol). Eight tools for cross-repo coordination:
| Tool | What it does |
|------|--------------|
| `realm_status` | Realm overview with repos, domains, contracts |
| `realm_check` | Validate contracts for CI |
| `contract_get` | Get contract details and schema |
| `session_start` | Begin a work session |
| `session_stop` | End session with summary |
| `realm_worktree_create` | Create worktrees for multi-repo work |
| `realm_pr_status` | Check PR readiness across repos |
| `notifications_list` | List contract change notifications |
See [docs/mcp](docs/mcp/) for full documentation.
### Quick Setup
```bash
# Build Blue
cargo build --release
# Configure Claude Code (~/.config/claude-code/mcp.json)
{
"mcpServers": {
"blue": {
"command": "blue",
"args": ["mcp"]
}
}
}
```
Then in Claude:
```
Human: What's my realm status?
Claude: [calls realm_status] You're in aperture/blue...
```
## Blue
I have a warm, plausible British accent. Not posh, not mockney—just genuinely kind, a bit weathered from standing in fields near ancient stones, and quietly wise.