blue/skills/alignment-play/SKILL.md

---
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, RFC 0048, and RFC 0050.

## Usage

```
/alignment-play <topic>
/alignment-play --panel-size 7 <topic>
/alignment-play --rotation none <topic>
/alignment-play --rfc <rfc-title> <topic>
```

## Parameters

| Parameter | Default | Description |
|-----------|---------|-------------|
| `--panel-size` | pool size or 12 | Number of experts per round |
| `--rotation` | `graduated` | Rotation mode: **graduated** (default), none, wildcards, full |
| `--max-rounds` | `10` | Maximum rounds before stopping (RFC 0057) |
| `--rfc` | none | Link dialogue to an RFC |

## How It Works

### Phase 0: Pool Design

Before creating the dialogue, the Judge:

1. **Reads** the topic/RFC thoroughly
2. **Identifies** the domain (e.g., "Investment Analysis", "System Architecture")
3. **Designs** 8-24 experts appropriate to the domain:
   - **Core (3-8)**: Essential perspectives for this specific problem
   - **Adjacent (4-10)**: Related expertise that adds depth
   - **Wildcard (3-6)**: Fresh perspectives, contrarians, cross-domain insight
4. **Assigns** relevance scores (0.20-0.95) based on expected contribution
5. **Creates** the dialogue with `expert_pool`:

```json
{
  "title": "Investment Strategy Analysis",
  "alignment": true,
  "expert_pool": {
    "domain": "Investment Analysis",
    "question": "Should we rebalance the portfolio?",
    "experts": [
      { "role": "Value Analyst", "tier": "core", "relevance": 0.95 },
      { "role": "Risk Manager", "tier": "core", "relevance": 0.90 },
      { "role": "Portfolio Strategist", "tier": "adjacent", "relevance": 0.70 },
      { "role": "ESG Analyst", "tier": "adjacent", "relevance": 0.65 },
      { "role": "Supply Chain Analyst", "tier": "adjacent", "relevance": 0.55 },
      { "role": "Macro Economist", "tier": "wildcard", "relevance": 0.40 },
      { "role": "Contrarian", "tier": "wildcard", "relevance": 0.35 },
      { "role": "Regulatory Expert", "tier": "wildcard", "relevance": 0.30 }
    ]
  },
  "panel_size": 6
}
```

The MCP server samples a **suggested panel** using weighted random selection. Higher relevance = higher selection probability. Core experts almost always selected; Wildcards provide variety.

### Phase 1: Review & Override (RFC 0050)

The suggested panel is just that — a suggestion. **Review it before Round 0:**

1. Check `suggested_panel` in the response from `blue_dialogue_create`
2. Ask: Are critical perspectives missing? Is a key expert not included?
3. **If the panel looks good** → proceed to Round 0
4. **If experts are missing** → call `blue_dialogue_evolve_panel` with `round: 0` to override:

```json
{
  "output_dir": ".blue/dialogues/data-design",
  "round": 0,
  "panel": [
    { "name": "Muffin", "role": "API Architect", "source": "pool" },
    { "name": "Cupcake", "role": "Data Architect", "source": "pool" },
    { "name": "Scone", "role": "Security Engineer", "source": "pool" }
  ]
}
```

### Phase 2: Round 0 — Opening Arguments

1. Create round directory: `mkdir -p {output_dir}/round-0`
2. Get prompts for each agent via `blue_dialogue_round_prompt`
3. **Spawn ALL agents in ONE message** using Task tool (parallel execution)
4. Collect responses, score contributions, write artifacts

### Phase 3+: Graduated Panel Evolution

**After Round 0, YOU decide how to evolve the panel.**

Before each subsequent round, evaluate the dialogue and decide:
- Which experts should **continue** (retained)
- Which experts from the pool should **join** (pool)
- Whether to **create** new experts for emerging tensions (created)

Use `blue_dialogue_evolve_panel` to specify your panel:

```json
{
  "output_dir": ".blue/dialogues/investment-strategy",
  "round": 1,
  "panel": [
    { "name": "Muffin", "role": "Value Analyst", "source": "retained" },
    { "name": "Cupcake", "role": "Risk Manager", "source": "retained" },
    { "name": "Scone", "role": "Supply Chain Analyst", "source": "pool" },
    { "name": "Palmier", "role": "Geopolitical Risk Analyst", "source": "created", "tier": "Adjacent", "focus": "Taiwan semiconductor concentration" }
  ]
}
```

Then spawn the panel using `blue_dialogue_round_prompt` with the `expert_source` parameter:

```
blue_dialogue_round_prompt(
  output_dir=".blue/dialogues/investment-strategy",
  agent_name="Palmier",
  agent_emoji="🧁",
  agent_role="Geopolitical Risk Analyst",
  round=1,
  expert_source="created",
  focus="Taiwan semiconductor concentration"
)
```

Fresh experts (source: "pool" or "created") automatically receive a **context brief** summarizing prior rounds.

## Panel Evolution Guidelines

### Retention Criteria
- **High scorers**: Experts who contributed sharp insights should continue
- **Unresolved advocates**: Experts defending positions with open tensions
- **Core relevance**: Experts central to the domain should anchor continuity

### Fresh Perspective Triggers
- **Stale consensus**: If the panel is converging too easily, bring challengers
- **Unexplored angles**: Pull in experts whose focus hasn't been represented
- **Low-scoring experts**: Consider rotating out experts who aren't contributing

### Targeted Expert Injection
When a specific tension emerges that no current expert can address:
1. Check if the pool has a relevant expert → `source: "pool"`
2. If not, **create a new expert** → `source: "created"` with tier and focus

Example: Tension T03 raises supply chain concentration risk, but no Supply Chain Analyst is on the panel:
```json
{ "name": "Palmier", "role": "Supply Chain Analyst", "source": "created", "tier": "Adjacent", "focus": "Geographic concentration, single-source risk" }
```

### Panel Size Flexibility
- Target panel size is a guideline, not a constraint
- You may run a smaller panel if the dialogue is converging
- You may expand briefly to address a complex tension

### Expert Creation
You are not limited to the initial pool. If the dialogue surfaces a perspective that no pooled expert covers, create one. The pool was your starting point, not your ceiling.

> *"The elephant is larger than we thought. Let me get someone who knows about tusks."*
> — The Judge

## Alternative Rotation Modes

If you don't want Judge-driven evolution, specify a different mode:

| Mode | Behavior | Use Case |
|------|----------|----------|
| `graduated` | **Judge decides** panel each round (default) | Full control, targeted expertise |
| `none` | Fixed panel all rounds | Simple deliberation |
| `wildcards` | Core/Adjacent persist, Wildcards resample | Moderate variety |
| `full` | Complete resample each round | Maximum diversity |

## Expert Pool Design Examples

### For an Investment Decision

| Role | Tier | Relevance |
|------|------|-----------|
| Value Analyst | Core | 0.95 |
| Risk Manager | Core | 0.90 |
| Portfolio Strategist | Core | 0.85 |
| ESG Analyst | Adjacent | 0.70 |
| Quant Strategist | Adjacent | 0.65 |
| Technical Analyst | Adjacent | 0.60 |
| Macro Economist | Wildcard | 0.40 |
| Contrarian | Wildcard | 0.35 |

### For an API Design

| Role | Tier | Relevance |
|------|------|-----------|
| API Architect | Core | 0.95 |
| Platform Engineer | Core | 0.90 |
| Security Engineer | Core | 0.85 |
| Developer Advocate | Adjacent | 0.70 |
| SRE Lead | Adjacent | 0.65 |
| Cost Analyst | Adjacent | 0.55 |
| Customer Success | Wildcard | 0.40 |
| Chaos Engineer | Wildcard | 0.30 |

## Tier Distribution

For a pool of P experts with panel size N:

| Tier | Pool % | Panel % | Purpose |
|------|--------|---------|---------|
| **Core** | ~30% | ~33% | Domain essentials, always selected |
| **Adjacent** | ~40% | ~42% | Related expertise, high selection probability |
| **Wildcard** | ~30% | ~25% | Fresh perspectives, rotation candidates |

## Blue MCP Tools

### Core Tools (File-based)

| Tool | Purpose |
|------|---------|
| `blue_dialogue_create` | Creates dialogue with expert_pool, returns Judge Protocol |
| `blue_dialogue_evolve_panel` | **RFC 0050**: Specify panel composition for graduated rotation |
| `blue_dialogue_round_prompt` | Get fully-substituted prompts for each agent |
| `blue_dialogue_sample_panel` | Manually sample a new panel (non-graduated modes) |
| `blue_dialogue_lint` | Validate .dialogue.md format |
| `blue_dialogue_save` | Persist to .blue/docs/dialogues/ |

### DB-Backed Tools (RFC 0051)

These tools provide database-backed tracking with full provenance:

| Tool | Purpose |
|------|---------|
| `blue_dialogue_round_context` | **Bulk fetch** context for all panel experts (perspectives, tensions, recommendations) |
| `blue_dialogue_expert_create` | Create new expert mid-dialogue with `source: "created"` |
| `blue_dialogue_round_register` | **Bulk register** all round data (perspectives, tensions, refs, scores) |
| `blue_dialogue_verdict_register` | Register verdicts (interim, final, minority, dissent) |
| `blue_dialogue_export` | Export dialogue to JSON with full provenance |

### Two-Phase ID System (RFC 0051)

Experts write **local IDs** using the marker syntax from the `alignment-expert` skill:
- `MUFFIN-P0101` — Muffin's first perspective in round 1
- `DONUT-T0201` — Donut's first tension in round 2

The Judge translates to **global IDs** when calling `blue_dialogue_round_register`:
- `P0101` — First perspective registered in round 1
- `T0201` — First tension registered in round 2

### DB-Backed Workflow (Recommended)

1. **Round Context**: Call `blue_dialogue_round_context(dialogue_id, round)` to get:
   - Dialogue metadata and background
   - All experts with roles and scores
   - All perspectives, tensions, recommendations, evidence, claims
   - List of open tensions

2. **Build Prompts**: Use context to construct prompts with the `alignment-expert` skill syntax

3. **Spawn Agents**: Use Task tool with `subagent_type: "general-purpose"`

4. **Parse Responses**: Extract markers from agent responses:
   - `[EXPERT-P0101: label]` → Perspective
   - `[EXPERT-T0101: label]` → Tension
   - `[RE:SUPPORT P0001]` → Reference

5. **Register Round**: Call `blue_dialogue_round_register` with:
   ```json
   {
     "dialogue_id": "nvidia-investment-analysis",
     "round": 1,
     "score": 45,
     "summary": "Round focused on income generation options",
     "perspectives": [
       { "local_id": "MUFFIN-P0101", "label": "Options viability", "content": "...", "contributors": ["muffin"] }
     ],
     "tensions": [...],
     "recommendations": [...],
     "expert_scores": { "muffin": 12, "donut": 15 }
   }
   ```

6. **Register Verdict**: When converged, call `blue_dialogue_verdict_register`:
   ```json
   {
     "dialogue_id": "nvidia-investment-analysis",
     "verdict_id": "final",
     "verdict_type": "final",
     "round": 3,
     "recommendation": "APPROVE with options overlay",
     "description": "Income mandate satisfied via covered call strategy",
     "tensions_resolved": ["T0001", "T0101"],
     "vote": "12-0",
     "confidence": "strong"
   }
   ```

7. **Export**: Call `blue_dialogue_export(dialogue_id)` to generate `dialogue.json`

## Agent Spawning

When spawning expert agents, you MUST use the Task tool with:
- `subagent_type: "general-purpose"` — NOT `alignment-expert`
- The prompt from `blue_dialogue_round_prompt`
- A descriptive name like "🧁 Muffin expert deliberation"

Example:
```
Task(
  description: "🧁 Muffin expert deliberation",
  subagent_type: "general-purpose",
  prompt: <from blue_dialogue_round_prompt>
)
```

The `general-purpose` subagent has access to all tools including Write, which is required for writing the response file.

## Expert Marker Syntax

Experts write structured responses using the marker syntax defined in the `alignment-expert` skill:

### Entity Markers
- `[EXPERT-P0101: label]` — Perspective
- `[EXPERT-R0101: label]` — Recommendation
- `[EXPERT-T0101: label]` — Tension
- `[EXPERT-E0101: label]` — Evidence
- `[EXPERT-C0101: label]` — Claim

### Cross-References
- `[RE:SUPPORT P0001]` — Backs a perspective
- `[RE:OPPOSE R0001]` — Challenges a recommendation
- `[RE:ADDRESS T0001]` — Speaks to a tension
- `[RE:RESOLVE T0001]` — Claims to resolve a tension
- `[RE:REFINE P0001]` — Builds on a perspective (same type)
- `[RE:DEPEND E0001]` — Relies on evidence

### Dialogue Moves
- `[MOVE:DEFEND target]` — Strengthening a position
- `[MOVE:CHALLENGE target]` — Raising concerns
- `[MOVE:BRIDGE targets]` — Reconciling perspectives
- `[MOVE:CONCEDE target]` — Acknowledging another's point
- `[MOVE:CONVERGE]` — Signaling agreement

See the `alignment-expert` skill (`/alignment-expert`) for full syntax reference.

## Key Rules

1. **DESIGN THE POOL FIRST** — You are the 💙 Judge. Analyze the problem domain and design appropriate experts.
2. **REVIEW THE SUGGESTED PANEL** — The sampled panel is a suggestion. Override it with `blue_dialogue_evolve_panel(round=0)` if critical experts are missing.
3. **EVOLVE THE PANEL** — After each round, use `blue_dialogue_evolve_panel` to shape subsequent panels based on dialogue dynamics.
4. **NEVER submit your own perspectives** — You orchestrate, you don't participate
5. **Spawn ALL agents in ONE message** — No first-mover advantage
6. **Follow the Judge Protocol exactly** — It contains the round workflow, artifact writing steps, scoring rules, and convergence criteria
7. **Use `general-purpose` subagent_type** — NOT `alignment-expert`. The general-purpose agents have access to all tools including Write, which is required for file output
8. **TRACK VELOCITY CORRECTLY** — Velocity = open_tensions + new_perspectives. This is "work remaining," not score delta. Convergence requires velocity = 0. (RFC 0057)
9. **REQUIRE UNANIMOUS CONVERGENCE** — All experts must signal `[MOVE:CONVERGE]` before declaring convergence. 100%, not majority. (RFC 0057)
10. **BOTH CONDITIONS REQUIRED** — Convergence requires BOTH velocity = 0 AND 100% expert convergence. Either condition failing means another round. (RFC 0057)
11. **MAX ROUNDS = 10** — Safety valve. If round 10 completes without convergence, force it with a warning in the verdict. (RFC 0057)
12. **OUTPUT CONVERGENCE SUMMARY** — When convergence achieved, output the formatted summary table showing: rounds, total ALIGNMENT (with W/C/T/R breakdown), experts consulted, tensions resolved, converged decisions, and resolved tensions. (RFC 0057)

## Driving Velocity to Zero (RFC 0057)

When velocity > 0 after a round, the Judge must drive it down:

### If Open Tensions > 0:
1. **Audit**: List tensions without `[RE:RESOLVE]` or `[ACCEPTED UNRESOLVED]`
2. **Assign Ownership**: Each tension needs an expert responsible for resolution
3. **Evolve Panel if Needed**: Pull from pool or create targeted expert
4. **Spawn Round**: Prompts emphasize tension resolution

### If New Perspectives > 0:
1. **Assess**: Are these perspectives being integrated or creating new tensions?
2. **If creating tensions**: Address tensions first
3. **If integrating smoothly**: Continue — perspectives will stop emerging as coverage completes

### If Converge % < 100%:
1. **Identify Holdouts**: Which experts haven't signaled `[MOVE:CONVERGE]`?
2. **Understand Why**: Are they defending open tensions? Surfacing new perspectives?
3. **Address Root Cause**: Usually ties back to velocity > 0

## Scoreboard Format (RFC 0057)

Track both ALIGNMENT components (W/C/T/R) and convergence metrics:

```markdown
| Round | W | C | T | R | Score | Open Tensions | New Perspectives | Velocity | Converge % |
|-------|---|---|---|---|-------|---------------|------------------|----------|------------|
| 0     | 45| 30| 25| 25| 125   | 3             | 8                | 11       | 0%         |
| 1     | 32| 22| 18| 17| 89    | 1             | 2                | 3        | 50%        |
| 2     | 18| 12| 8 | 7 | 45    | 0             | 0                | 0        | 100%       |

**Total ALIGNMENT:** 259 (W:95 C:64 T:51 R:49)
**Max Rounds:** 10
**Convergence:** ✓ (velocity=0, unanimous)
```

- **W** = Wisdom (perspectives integrated, synthesis quality)
- **C** = Consistency (follows patterns, internally coherent)
- **T** = Truth (grounded in reality, no contradictions)
- **R** = Relationships (connections to other artifacts, graph completeness)

## Convergence Summary Template (RFC 0057)

When convergence is achieved, output this summary:

```
100% CONVERGENCE ACHIEVED

Final Dialogue Summary
┌───────────────────────┬───────────┐
│        Metric         │   Value   │
├───────────────────────┼───────────┤
│ Rounds                │ 3         │
├───────────────────────┼───────────┤
│ Total ALIGNMENT       │ 289       │
│   (W:98 C:72 T:65 R:54)           │
├───────────────────────┼───────────┤
│ Experts Consulted     │ 10 unique │
├───────────────────────┼───────────┤
│ Tensions Resolved     │ 6/6       │
├───────────────────────┼───────────┤
│ Final Velocity        │ 0         │
└───────────────────────┴───────────┘

Converged Decisions
┌────────────────┬────────────────────────────────────────────────────┐
│   Topic        │                      Decision                      │
├────────────────┼────────────────────────────────────────────────────┤
│ Architecture   │ Storage abstraction with provider trait            │
├────────────────┼────────────────────────────────────────────────────┤
│ Testing        │ NIST KAT + reference vectors + property tests      │
└────────────────┴────────────────────────────────────────────────────┘

Resolved Tensions
┌────────┬────────────────────────────────────────────────────────────┐
│   ID   │                       Resolution                           │
├────────┼────────────────────────────────────────────────────────────┤
│ T0001  │ Local keys never rotated - disposable with DB reset        │
└────────┴────────────────────────────────────────────────────────────┘

All experts signaled [MOVE:CONVERGE]. Velocity = 0.
```

## 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.

*"The Judge sees the elephant. The Judge summons the right blind men."*

Always and forever. 🧁🧁🧁💙🧁🧁🧁