Welcome home. A development philosophy and toolset.

Find a file

Eric Garcia a07737f3dc RFC 0014: Workflow Enforcement Parity (#1 ) Co-authored-by: Eric Garcia <eric.garcia@gmail.com> Co-committed-by: Eric Garcia <eric.garcia@gmail.com>		2026-01-25 19:21:42 +00:00
.blue	chore: sync state.rs and add RFC/spike documents	2026-01-24 20:32:32 -05:00
apps/blue-cli	fix: remove stop sequence that truncated indexer LLM output	2026-01-24 19:25:51 -05:00
crates	RFC 0014: Workflow Enforcement Parity (#1 )	2026-01-25 19:21:42 +00:00
docs	docs: add install scripts and MCP integration docs	2026-01-24 16:44:55 -05:00
.gitignore	chore: Track .blue folder in git	2026-01-24 10:53:07 -05:00
Cargo.toml	feat: Implement RFCs 0002, 0004, and 0005	2026-01-24 15:15:33 -05:00
CLAUDE.md	docs: update CLAUDE.md for new .blue structure and MCP tools	2026-01-24 16:21:54 -05:00
INSTALL.md	docs: add install scripts and MCP integration docs	2026-01-24 16:44:55 -05:00
install.sh	docs: add install scripts and MCP integration docs	2026-01-24 16:44:55 -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.

🧁