992ba45034
Features: - Alignment dialogue subagents, MCP instructions, and document batch - RFC 0020 MCP project detection - Filesystem authority with slug matching and FS-aware numbering (RFC 0022) - Document sync and Claude Code task integration (RFC 0018, 0019) - Plan file authority (RFC 0017) - Dynamic context activation (RFC 0016 + 0017) - Context injection architecture via 12-expert alignment dialogue - Workflow enforcement parity (RFC 0014) - Git forge integration for GitHub and Forgejo (RFC 0013) - MCP workflow guidance for worktree creation (RFC 0011) Fixes: - Correct dialogue round numbering and kebab-case spike filenames - Remove wrong alignment orchestration architecture (RFC 0015) - Clippy fixes and invalid YAML test fix |
||
|---|---|---|
| .blue | ||
| .claude/agents | ||
| apps/blue-cli | ||
| crates | ||
| docs | ||
| hooks | ||
| knowledge | ||
| skills/alignment-play | ||
| .gitignore | ||
| Cargo.toml | ||
| INSTALL.md | ||
| install.sh | ||
| 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.
🧁