blue/skills/alignment-play/SKILL.md
Eric Garcia 02901dfec7 chore: batch commit - ADRs, RFCs, dialogues, spikes, and code updates
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>
2026-01-30 16:28:31 -05:00

3.3 KiB

name description
alignment-play 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. 🧁🧁🧁💙🧁🧁🧁