6e8f0db6c0
- Add dialogue prompt file writing for audit/debugging - Update README install instructions - Add new RFCs (0053, 0055-0059, 0062) - Add recorded dialogues and expert pools - Add ADR 0018 dynamodb-portable-schema - Update TODO with hook configuration notes Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
148 lines
4.4 KiB
Markdown
148 lines
4.4 KiB
Markdown
# 💙
|
|
|
|
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
|
|
|
|
```bash
|
|
cargo build --release
|
|
./target/release/blue install
|
|
```
|
|
|
|
Configures hooks, skills, and MCP for Claude Code. Restart Claude Code after installation.
|
|
|
|
See [INSTALL.md](INSTALL.md) for details.
|
|
|
|
## Getting Started
|
|
|
|
```bash
|
|
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
|
|
|
|
0. **Never Give Up** — The ground everything stands on
|
|
1. **Purpose** — We exist to make work meaningful and workers present
|
|
2. **Presence** — The quality of actually being here while you work
|
|
3. **Home** — You are never lost. You are home.
|
|
4. **Evidence** — Show, don't tell
|
|
5. **Single Source** — One truth, one location
|
|
6. **Relationships** — Connections matter
|
|
7. **Integrity** — Whole in structure, whole in principle
|
|
8. **Honor** — Say what you do. Do what you say.
|
|
9. **Courage** — Act rightly, even when afraid
|
|
10. **No Dead Code** — Delete boldly. Git remembers.
|
|
11. **Freedom Through Constraint** — The riverbed enables the river
|
|
12. **Faith** — Act on justified belief, not just proven fact
|
|
13. **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](docs/mcp/) for full documentation.
|
|
|
|
## Playwright MCP with Chrome Profiles
|
|
|
|
By default, Playwright MCP launches a fresh browser with no saved sessions. To use your existing Chrome profile (with saved logins), copy the profile and point Playwright at the copy.
|
|
|
|
**Setup:**
|
|
|
|
1. Copy your Chrome profile to a temp location (avoids profile lock conflicts):
|
|
```bash
|
|
mkdir -p /tmp/chrome-profile
|
|
cp -r ~/Library/Application\ Support/Google/Chrome/Default /tmp/chrome-profile/Default
|
|
cp ~/Library/Application\ Support/Google/Chrome/Local\ State /tmp/chrome-profile/
|
|
```
|
|
|
|
2. Update `.claude/plugins/.../playwright/.mcp.json`:
|
|
```json
|
|
{
|
|
"playwright": {
|
|
"command": "npx",
|
|
"args": [
|
|
"@playwright/mcp@latest",
|
|
"--executable-path", "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
|
|
"--user-data-dir", "/tmp/chrome-profile"
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
3. Restart Claude Code.
|
|
|
|
**Limitations:**
|
|
- Saved passwords won't autofill (Keychain encryption is path-bound). Usernames fill fine.
|
|
- Copy your passwords from `chrome://password-manager/passwords` in your regular Chrome as needed.
|
|
- Sessions stay active within the Playwright instance, so you only log in once per site.
|
|
- Re-copy the profile if you need fresh cookies/sessions.
|
|
|
|
**What didn't work:**
|
|
- `--remote-debugging-port=9222`: Chrome on macOS silently ignores TCP port binding.
|
|
- `--extension` mode with Playwright MCP Bridge: Opens a new profile instead of connecting to the existing one.
|
|
- Direct `--user-data-dir` pointing to the live Chrome profile: Lock file conflicts.
|
|
|
|
### Quick Setup
|
|
|
|
```bash
|
|
cargo build --release
|
|
./target/release/blue install
|
|
# Restart Claude Code
|
|
```
|
|
|
|
Then in Claude:
|
|
```
|
|
Human: blue status
|
|
Claude: [calls blue_status] Project: blue, Branch: develop...
|
|
```
|
|
|
|
## 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.
|
|
|
|
🧁
|