a5b142299d
RFC 0016 drafted from alignment dialogue achieving 95% convergence: - Three-tier model: Identity (fixed) / Workflow (session) / Reference (on-demand) - Manifest-driven injection via .blue/context.manifest.yaml - URI addressing: blue://docs/, blue://context/, blue://state/ - Hooks push URIs, MCP resolves content - Progressive visibility: blue context show New ADRs ported from coherence-mcp: - 0014: Alignment Dialogue Agents (renamed from 0006) - 0015: Plausibility - 0016: You Know Who You Are Knowledge injection system: - hooks/session-start for SessionStart injection - knowledge/*.md files for global context - Expert pools with domain-specific relevance tiers - Updated /alignment-play skill with full scoring Spikes completed: - Context injection mechanisms (7 mechanisms designed) - ADR porting inventory (17 Blue ADRs mapped) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .blue | ||
| apps/blue-cli | ||
| crates | ||
| docs | ||
| hooks | ||
| knowledge | ||
| skills/alignment-play | ||
| .gitignore | ||
| Cargo.toml | ||
| CLAUDE.md | ||
| 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.
🧁