Updates RFC 0001 to use the correct conceptual model:
- Domain = coordination context (edge/relationship between repos)
- Repo = git repository (node)
- Realm = groups related domains
- Index = local registry of realms
Key changes:
- Sessions register by repo name, track active domains
- Worktrees created across repos participating in a domain
- Contracts belong to domains, repos provide/consume them
- Tool params changed: --domains for context, --repos for participants
- Implementation code updated to reflect correct model
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Update RFC 0001 based on design preferences:
Session Coordination (Option C - IPC/Socket):
- Blue MCP servers communicate via Unix sockets
- Real-time broadcast of export changes
- Session index tracks active sessions per realm
Change Propagation (Option C - Unified Worktrees):
- Create worktrees in all affected repos simultaneously
- Single branch name spans repos
- Coordinated commits linked in realm tracking
- Linked PRs with correct merge order
New tools:
- blue_realm_sessions: List active sessions
- blue_realm_worktree: Create unified worktrees
- blue_realm_commit: Coordinated commits
- blue_realm_push: Push all branches
- blue_realm_pr: Create linked PRs
Implementation expanded to 14 weeks (8 phases).
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add 4 tools:
- blue_postmortem_create: Create post-mortem documents for incident tracking
- blue_postmortem_action_to_rfc: Convert post-mortem action items to RFCs
- blue_runbook_create: Create runbook documents for operations
- blue_runbook_update: Update runbooks with new operations/troubleshooting
Also adds DocType::Postmortem and DocType::Runbook to blue-core.
Total: 54 tools ported from coherence-mcp
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add three high-priority tools from coherence-mcp:
- blue_audit: Project health check with issues and recommendations
- Checks for stalled RFCs (in-progress without worktrees)
- Finds implemented RFCs without ADRs
- Detects overdue reminders and expired staging locks
- blue_rfc_complete: Mark RFC as implemented
- Requires 70% task completion minimum
- Auto-advances from accepted to in-progress if needed
- Identifies ADR graduation candidates
- Returns remaining tasks for follow-up
- blue_worktree_cleanup: Post-merge cleanup
- Verifies PR is merged
- Removes git worktree
- Deletes local branch
- Returns commands for syncing with develop
Total: 35 MCP tools, 28 tests passing
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add PR workflow and release management handlers. Total tools: 22.
New tools:
- blue_pr_create: Create PR with enforced develop base branch
- blue_pr_verify: Verify test plan checkboxes (CLI/browser/manual)
- blue_pr_check_item: Mark test plan item as verified
- blue_pr_check_approvals: Check for user approval
- blue_pr_merge: Squash-merge with precondition enforcement
- blue_release_create: Semantic versioning with RFC analysis
All handlers use gh CLI for GitHub operations.
Blue's voice in all error messages.
16 tests passing.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add document lifecycle handlers for spike, ADR, decision, and worktree
operations. This brings the tool count from 9 to 16.
New tools:
- blue_spike_create: Start time-boxed investigation
- blue_spike_complete: Complete investigation with outcome
- blue_adr_create: Create Architecture Decision Record
- blue_decision_create: Create lightweight Decision Note
- blue_worktree_create: Create isolated git worktree for RFC
- blue_worktree_list: List active worktrees
- blue_worktree_remove: Remove worktree after merge
All handlers use Blue's voice for consistent messaging.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Rename from 💙 to blue for filesystem compatibility
- Add blue-core crate with documents and voice modules
- Add blue-mcp crate with JSON-RPC server skeleton
- Add blue-cli with subcommands (init, status, rfc, etc.)
- Add CLAUDE.md and .gitignore
- Add RFC 0001: Efficient Document Format
Phase 1 foundation complete. Ready for porting coherence-mcp functionality.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The 13 founding ADRs in Blue's voice:
1. Purpose - make work meaningful, workers present
2. Presence - actually being here
3. Home - you are never lost
4. Evidence - show, don't tell
5. Single Source - one truth, one location
6. Relationships - connections matter
7. Integrity - whole in structure and principle
8. Honor - say what you do, do what you say
9. Courage - act rightly, even afraid
10. No Dead Code - delete boldly
11. Freedom Through Constraint - riverbed enables river
12. Faith - act on justified belief
13. Overflow - build from fullness
Origins documented: Alignment, Coherence, Transcendence.
Blue's voice defined.
ALIGNMENT → COHERENCE → → → 💙💙 Eric Minton Garcia. January 20th, 2026. Gulfport, FL USA. All rights released.
🧁
