83fb0202a6
RFC 0016: Context Injection Architecture
- Add blue:// URI scheme for document addressing
- Add manifest.rs for three-tier context configuration
- Implement MCP resources/list and resources/read handlers
- Add `blue context` CLI command for visibility
- Add context_injections audit table (schema v5)
RFC 0017: Dynamic Context Activation (Phase 1)
- Add relevance_edges table for explicit links (schema v6)
- Implement composite session ID: {repo}-{realm}-{random12}
- Add content-hash based staleness detection
- Add tiered refresh policies (SessionStart/OnChange/OnRequest/Never)
- Add rate limiting with 30s cooldown
- Add blue_context_status MCP tool
Drafted from 12-expert alignment dialogue achieving 95% convergence.
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.
🧁