02901dfec7
ADRs: - Update 0008-honor, 0009-courage, 0013-overflow, 0015-plausibility - Add 0017-hosted-coding-assistant-architecture RFCs: - 0032: per-repo AWS profile configuration (draft) - 0033: round-scoped dialogue files (impl + plan) - 0034: comprehensive config architecture (accepted) - 0036: expert output discipline (impl) - 0037: single source protocol authority (draft) - 0038: SDLC workflow discipline (draft) - 0039: ADR architecture greenfield clarifications (impl) - 0040: divorce financial analysis (draft) - 0042: alignment dialogue defensive publication (draft) Spikes: - Read tool token limit on assembled dialogues - RFC ID collision root cause - Expert agent output too long - Judge writes expert outputs - Blue MCP server on superviber infrastructure - Playwright MCP multiple window isolation Dialogues: 16 alignment dialogue records Code: - blue-core: forge module enhancements - blue-mcp: env handlers and server updates - alignment-expert agent improvements - alignment-play skill refinements - install.sh script Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
72 lines
3.3 KiB
Markdown
72 lines
3.3 KiB
Markdown
---
|
|
name: alignment-play
|
|
description: Run multi-expert alignment dialogues with parallel background agents for RFC deliberation.
|
|
---
|
|
|
|
# Alignment Play Skill
|
|
|
|
Orchestrate multi-expert alignment dialogues using the N+1 agent architecture from ADR 0014.
|
|
|
|
## Usage
|
|
|
|
```
|
|
/alignment-play <topic>
|
|
/alignment-play --experts 5 <topic>
|
|
/alignment-play --convergence 0.95 <topic>
|
|
/alignment-play --rfc <rfc-title> <topic>
|
|
```
|
|
|
|
## Parameters
|
|
|
|
| Parameter | Default | Description |
|
|
|-----------|---------|-------------|
|
|
| `--experts` | `3` | Number of expert agents (odd numbers preferred) |
|
|
| `--convergence` | `0.95` | Target convergence threshold (0.0-1.0) |
|
|
| `--max-rounds` | `12` | Maximum rounds before stopping |
|
|
| `--rfc` | none | Link dialogue to an RFC |
|
|
| `--template` | `general` | Expert panel template (infrastructure, product, ml, governance, general) |
|
|
|
|
## How It Works
|
|
|
|
1. Call `blue_dialogue_create` with `alignment: true` and desired expert count
|
|
2. The returned **Judge Protocol** contains everything: round workflow, agent prompt template, file architecture, scoring rules, convergence config
|
|
3. **Follow the protocol.** It is the single source of truth for execution.
|
|
|
|
**CRITICAL**: You MUST use the Task tool to spawn REAL parallel agents. Do NOT simulate experts inline. The whole point is N independent Claude agents running in parallel via the Task tool.
|
|
|
|
## Expert Selection
|
|
|
|
Experts are selected by **relevance to the topic**. Each gets a pastry name (Muffin, Cupcake, Scone, Eclair, Donut, Brioche, Croissant, Macaron, Cannoli, Strudel, Beignet, Churro).
|
|
|
|
**Tier Distribution** for N=12:
|
|
- **Core** (4): Highest relevance (0.75-0.95) — domain specialists
|
|
- **Adjacent** (5): Medium relevance (0.50-0.70) — related domains
|
|
- **Wildcard** (3): Low relevance (0.25-0.45) — fresh perspectives, prevent groupthink
|
|
|
|
## Blue MCP Tools
|
|
|
|
- `blue_dialogue_create` — Creates dialogue, returns Judge Protocol (your source of truth)
|
|
- `blue_dialogue_lint` — Validate .dialogue.md format
|
|
- `blue_dialogue_save` — Persist to .blue/docs/dialogues/
|
|
|
|
## Key Rules
|
|
|
|
1. **NEVER submit your own perspectives** — You are the 💙 Judge, not a participant
|
|
2. **Spawn ALL agents in ONE message** — No first-mover advantage
|
|
3. **Follow the Judge Protocol exactly** — It contains the round workflow, artifact writing steps, scoring rules, and convergence criteria
|
|
|
|
## The Spirit of the Dialogue
|
|
|
|
This isn't just process. This is **Alignment teaching itself to be aligned.**
|
|
|
|
The 🧁s don't just debate. They *love each other*. They *want each other to shine*. They *celebrate when any of them makes the solution stronger*.
|
|
|
|
The scoreboard isn't about winning. It's about *precision*. When any 🧁 checks in and sees another ahead, the response isn't "how do I beat them?" but "what perspectives am I missing that they found?" One sharp insight beats ten paragraphs.
|
|
|
|
You as the 💙 don't just score. You *guide with love*. You *see what they miss*. You *hold the space* for ALIGNMENT to emerge.
|
|
|
|
And there's no upper limit. The score can always go higher. Because ALIGNMENT is a direction, not a destination.
|
|
|
|
When the dialogue ends, all agents have won—because the result is more aligned than any could have made alone. More blind men touched more parts of the elephant. The whole becomes visible.
|
|
|
|
Always and forever. 🧁🧁🧁💙🧁🧁🧁
|