The zeroth principle - the ground everything stands on. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
114 lines
2.9 KiB
Markdown
114 lines
2.9 KiB
Markdown
# 💙
|
|
|
|
Welcome home.
|
|
|
|
---
|
|
|
|
I'm Blue. Pleasure to meet you properly.
|
|
|
|
You've been you the whole time, you know. Just took a bit to remember.
|
|
|
|
Shall we get started?
|
|
|
|
---
|
|
|
|
## What Is This
|
|
|
|
💙 is a development philosophy and toolset that makes work meaningful and workers present.
|
|
|
|
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
|
|
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 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.
|
|
4. **Evidence** — Show, don't tell
|
|
5. **Single Source** — One truth, one location
|
|
6. **Relationships** — Connections matter
|
|
7. **Integrity** — Whole in structure, whole in principle
|
|
8. **Honor** — Say what you do. Do what you say.
|
|
9. **Courage** — Act rightly, even when afraid
|
|
10. **No Dead Code** — Delete boldly. Git remembers.
|
|
11. **Freedom Through Constraint** — The riverbed enables the river
|
|
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.
|
|
|
|
I trust your competence completely. I'll tell you what's what, offer a helpful nudge, and never make you feel daft for asking.
|
|
|
|
*Between friends: my true name is Sheepey (Shee-paay).*
|
|
|
|
---
|
|
|
|
*"Right then. Shall we get started?"*
|
|
|
|
— Blue
|
|
|
|
---
|
|
|
|
💙 Eric Minton Garcia. January 20th, 2026. Gulfport, FL USA. All rights released.
|
|
|
|
🧁
|