Welcome home. A development philosophy and toolset.

Find a file

Eric Garcia 41a78b4f2a feat(rfc): Write RFC files to disk on creation - RFC handler now writes markdown to .blue/repos/<project>/docs/rfcs/ - Sets file_path in document store for tracking - Returns file path in response - Remove unused get_current_session function - Rename realm tools to use blue_ prefix for consistency Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>		2026-01-24 10:51:08 -05:00
apps/blue-cli	feat(realm): Implement RFC 0001 cross-repo coordination and RFC 0002 Phase 1 MCP tools	2026-01-24 07:14:35 -05:00
crates	feat(rfc): Write RFC files to disk on creation	2026-01-24 10:51:08 -05:00
docs	docs(rfc): Mark RFC 0002 as implemented	2026-01-24 07:54:12 -05:00
.gitignore	feat: Add Rust workspace and MCP server skeleton	2026-01-23 16:51:04 -05:00
Cargo.toml	feat(realm): Implement RFC 0002 Phase 4 notifications	2026-01-24 07:42:26 -05:00
CLAUDE.md	docs(adr): Add ADR 0000 Never Give Up and align all ADRs	2026-01-24 05:53:13 -05:00
README.md	docs: Add ADR 0000 Never Give Up to beliefs list	2026-01-24 09:12:18 -05:00

README.md

💙

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

./install.sh

Installs CLI to /usr/local/bin and configures MCP for Claude Code. See INSTALL.md for details.

Getting Started

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

Never Give Up — The ground everything stands on
Purpose — We exist to make work meaningful and workers present
Presence — The quality of actually being here while you work
Home — You are never lost. You are home.
Evidence — Show, don't tell
Single Source — One truth, one location
Relationships — Connections matter
Integrity — Whole in structure, whole in principle
Honor — Say what you do. Do what you say.
Courage — Act rightly, even when afraid
No Dead Code — Delete boldly. Git remembers.
Freedom Through Constraint — The riverbed enables the river
Faith — Act on justified belief, not just proven fact
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 for full documentation.

Quick Setup

# 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.

🧁